video-subtitle

给视频加字幕、生成字幕、翻译字幕、烧录字幕（支持单语 / 双语）。基于 ffmpeg + OpenAI Whisper。

功能

• 提取音频 — 用 ffmpeg 提取 16kHz 单声道 WAV
• 语音转写 — 用 Whisper 把音频转成带时间戳的 SRT（tiny/base/small/medium/large）
• AI 翻译 — 保留时间戳，把 SRT 翻译成任意语言
• 烧录字幕 — 把 SRT 烧进视频，内置 5 套样式预设，也支持自定义 ASS

安装

下载仓库，或到 Release 页面下载 video-subtitle.zip 压缩包，然后让你的 AI agent（Codex / Claude Code / WorkBuddy 等）解压并安装即可：

安装这个 skill：解压压缩包，阅读 SKILL.md，确保 scripts/ 可用。之后用户要处理视频字幕时，按 SKILL.md 的流程执行。

不需要 npm、插件或手动复制目录。

前置条件

• ffmpeg 和 ffprobe 在 PATH 中（ffmpeg -version 验证）
• Python 3 + openai-whisper：pip install openai-whisper
• 首次转写会下载 Whisper 模型（base 约 140MB）

使用

直接对 agent 说，例如：

• “帮我把 lecture.mp4 生成中英双语字幕”
• “add English subtitles to lecture.mp4”

完整流程（SKILL.md 里有逐步命令）：提取音频 → 语音转文字 → 翻译 → 烧录字幕。

License

MIT — 见 LICENSE。