WEIFENG2333 /VideoCaptioner
🎬 卡卡字幕助手 | VideoCaptioner - 基于 LLM 的智能字幕助手 - 视频字幕生成、断句、校正、字幕翻译全流程处理!- A powered tool for easy and efficient video subtitling.
★ 16,539⑂ 1,441👁 56⑃ 114● 1,020▤ 11
+18
Daily
16,539
stars
1,441
forks
56
watchers
114
prs
1,020
issues
11
releases
README
VideoCaptioner 基于大语言模型的视频字幕处理工具 — 语音识别、字幕优化、翻译、视频合成一站式处理 在线文档 · CLI 使用 · GUI 桌面版 · Claude Code Skill 安装 bash pip install videocaptioner 安装 CLI + GUI 桌面版 免费功能(必剪语音识别、必应/谷歌翻译)无需任何配置,安装即用。 CLI 命令行 bash 语音转录(免费,无需 API Key) videocaptioner transcribe video.mp4 --asr bijian 字幕翻译(免费必应翻译) videocaptioner subtitle input.srt --translator bing --target-language en 全流程:转录 → 优化 → 翻译 → 合成 videocaptioner process video.mp4 --target-language ja 字幕烧录到视频 videocaptioner synthesize video.mp4 -s subtitle.srt 下载在线视频 videocaptioner download "https://youtube.com/watch?v=xxx" 需要 LLM 功能(字幕优化、大模型翻译)时,配置 API Key: bash videocaptioner config set llm.api_key videocaptioner config set llm.api_base https://api.openai.com/v1 videocaptioner config set llm.model gpt-4o-mini 配置优先级:命令行参数 环境变量 (VIDEOCAPTIONER_) 配置文件 默认值。运行 videocaptioner config show 查看当前配置。 所有 CLI 命令一览 | 命令 | 说明 | |------|------| | gui | 打开桌面版。也可以直接运行 videocaptioner-gui | | transcribe | 语音转字幕。引擎:faster-whisper、whisper-api、bijian(免费)、jianying(免费)、whisper-cpp | | subtitle | 字幕优化/翻译。翻译服务:llm、bing(免费)、google(免费) | | dub | 根据字幕生成配音音轨或配音视频 | | synthesize | 字幕烧录到视频(软字幕/硬字幕) | | process | 全流程处理 | | download | 下载 YouTube、B站等平台视频 | | config | 配置管理(show、set、get、path、init) | 运行 videocaptioner --help 查看完整参数。完整 CLI 文档见 docs/cli.md。 GUI 桌面版 bash pip install videocaptioner videocaptioner-gui 显式打开桌面版 videocaptioner gui 等价命令 videocaptioner 无参数时也会打开桌面版 其他安装方式:Windows 安装包 / macOS 一键脚本 Windows:从 Release 下载安装包 macOS: bash curl -fsSL https://raw.githubusercontent.com/WEIFENG2333/VideoCaptioner/master/scripts/run.sh | bash -- !页面预览 !页面预览 LLM API 配置 LLM 仅用于字幕优化和大模型翻译,免费功能(必剪识别、必应翻译)无需配置。 支持所有 OpenAI 兼容接口的服务商: | 服务商 | 官网 | |--------|------| | VideoCaptioner 中转站 | api.videocaptioner.cn — 高并发,性价比高,支持 GPT/Claude/Gemini 等 | | SiliconCloud | cloud.siliconflow.cn | | DeepSeek | platform.deepseek.com | 在软件设置或 CLI 中填入 API Base URL 和 API Key 即可。详细配置教程 Claude Code Skill 本项目提供了 Claude Code Skill,让 AI 编程助手可以直接调用 VideoCaptioner 处理视频。 安装到 Claude Code: bash mkdir -p ~/.claude/skills/videocaptioner cp skills/SKILL.md ~/.claude/skills/videocaptioner/SKILL.md 然后在 Claude Code 中输入 /videocaptioner transcribe video.mp4 --asr bijian 即可使用。 工作原理 音视频输入 → 语音识别 → 字幕断句 → LLM 优化 → 翻译 → 视频合成 - 词级时间戳 + VAD 语音活动检测,识别准确率高 - LLM 语义理解断句,字幕阅读体验自然流畅 - 上下文感知翻译,支持反思优化机制 - 批量并发处理,效率高 开发 bash git clone https://github.com/WEIFENG2333/VideoCaptioner.git cd VideoCaptioner uv sync && uv run videocaptioner 运行 GUI uv run videocaptioner --help 运行 CLI uv run pyright 类型检查 uv run pytest tests/test_cli/ -q 运行测试 许可证 GPL-3.0
Top issues
#30「画中有声,字里有影」欢迎加入 VideoCaptioner 反馈QQ群!39 comments · 2024-11-18#326求大佬参与完成mac 版本36 comments · 2025-02-08#294想要个命令行cli 版本,方便自动生成字幕17 comments · 2025-01-31#1083什么鬼,1.4.1不支持客户端?15 comments · 2026-04-13#754转录失败 Faster Whisper 输出文件不存在12 comments · 2025-08-16#883单词级字幕重新字幕优化后出现较多时间戳与单词级不一致的情况11 comments · 2025-11-18#1183近日Deepseek API字幕优化Tokens消耗激增10 comments · 2026-08-18#10641.4.1版本没有安装包吗?8 comments · 2026-04-01
Discussions
#1201good0 comments · 2026-10-11#1185可以出一个批量字幕+合成视频的选项吗?1 comments · 2026-08-25#1180faster whisper large v2 转录速度感觉有点慢,应该怎么修改文件,cpu占用率一直徘徊在14%2 comments · 2026-08-16#1149支付宝显示支付成功,却没在API的钱包中看到入账,怎么回事?2 comments · 2026-06-12#1138手动下载了FasterWhisper,但是还是提醒我没有安装,大佬们求救3 comments · 2026-05-30#1110小白想求问各位大神,FasterWhisper语音转录失败0 comments · 2026-05-08#1098pip安装如何控制Whisper模型下载位置1 comments · 2026-05-03#1075字幕不能调大小3 comments · 2026-04-07
Latest release
v1.4.2 v1.4.2 2026-05-24What's Changed fix:修复空指针异常 by @nasa565 in https://github.com/WEIFENG2333/VideoCaptioner/pull/1045 fix: Correct macOS script path in the README file by @OrangeSAM in https://github.com/WEIFENG2333/VideoCaptioner/pull/1047 feat: Unified subtitle style system, CLI improvements, core bug fixes by @WEIFENG2333 in https://github.com/WEIFENG2333/VideoCaptioner/pull/1057 fix(asr): make handle_long_path idempotent for already-prefixed paths by @WEIFENG2333 in https://github.com/WEIFENG2333/VideoCaptioner/pull/1101 fix(subtitle): single-quote ass/fontsdir paths in preview FFmpeg filter by @WEIFENG2