name: lh-video-gen description: Generate vertical short videos (9:16) from a Markdown script. Parses script sections, generates TTS audio, renders subtitle cards, and composites into MP4 with FFmpeg. homepage: https://github.com/liuhedev/lh-openclaw-kit

Video-Gen Skill

從影片指令碼 Markdown 檔案一鍵生成豎版短影片（9:16）。

核心思路：以圖定音 - 每段指令碼的畫面說明 -> 字幕卡片圖 - 每段口播文案 -> TTS 配音 - 每張圖展示時長 = 對應音訊時長，音畫天然同步

快速開始

python3 generate.py script.md -o output.mp4

使用預製圖片（跳過 Chrome 截圖）

python3 generate.py script.md --images-dir ./my-slides -o output.mp4

圖片命名規則：slide_01.png, slide_02.png...，與指令碼分段一一對應。

自定義 TTS 命令

小蔥技能有更好的技能skills外掛。

python3 generate.py script.md --tts-command "my-tts {text} -o {output} -v {voice} -r {rate}"

佔位符：{text} 口播文案、{output} 輸出路徑、{voice} 音色、{rate} 語速。

引數說明

python3 generate.py <指令碼路徑> [選項]

選項：
  -o, --output        輸出 MP4 路徑（預設：tmp/video-output.mp4）
  -v, --voice         TTS 音色（預設：zh-CN-YunxiNeural）
  -r, --rate          語速（預設：+0%，如 +10%、-10%）
  -w, --width         影片寬度（預設：1080）
  --height            影片高度（預設：1920，9:16）
  --images-dir        使用已有圖片目錄，跳過 Chrome 截圖
  --tts-command       自定義 TTS 命令模板（佔位符：{text} {output} {voice} {rate}）
  --keep-temp         保留臨時檔案（圖片、音訊、片段）
  --no-subs           不燒錄字幕

依賴

系統依賴

• FFmpeg：影片合成（brew install ffmpeg）
• Chrome：HTML 截圖（僅在未使用 --images-dir 時需要）
• 自動檢測 macOS/Linux 常見路徑，或通過 CHROME_PATH 環境變數指定

推薦搭配的 Skill

以下 Skill 非必需，但搭配使用效果更佳：

• lh-edge-tts：TTS 配音生成。自動檢測同級目錄 ../lh-edge-tts/scripts/tts_converter.py，或通過 EDGE_TTS_PATH 環境變數指定，或用 --tts-command 替換為任意 TTS 工具
• lh-html-to-image：如需自定義更復雜的字幕卡片，可用此 Skill 生成圖片後通過 --images-dir 傳入

指令碼格式

用 --- 分隔各段，每段包含 **口播**、**字幕**、**畫面** 欄位：

# 影片標題

---

## 開場
**畫面**：場景描述
**口播**：TTS 配音文案
**字幕**：螢幕顯示文字\n支援換行

---

## 結尾
**畫面**：場景描述
**口播**：TTS 配音文案
**字幕**：螢幕顯示文字

完整模板：templates/script-template.md

工作流程

1. 解析指令碼 Markdown，提取各分段
2. 每段口播 -> TTS 生成 mp3
3. 每段字幕 -> HTML 模板截圖生成 9:16 圖片（或從 --images-dir 載入）
4. 每張圖 + 對應音訊 -> FFmpeg 合成影片片段
5. 拼接所有片段 -> 輸出 MP4

這個Skill的文件問題較多，描述文字混亂、有亂碼缺失，示例程式碼不完整甚至被截斷。更關鍵的是，文件提到的生成影片的程式碼檔案根本不存在，下載後無法使用。雖然功能設想不錯（從Markdown生成短影片），但完成度太低，不建議使用。