WEIFENG2333 /VideoCaptioner

🎬 卡卡字幕助手 | VideoCaptioner - 基于 LLM 的智能字幕助手 - 视频字幕生成、断句、校正、字幕翻译全流程处理!- A powered tool for easy and efficient video subtitling.

★ 16,539⑂ 1,441👁 56⑃ 114● 1,020▤ 11
PythonGPL-3.0Created 2024-10-31www.videocaptioner.cn
Download: v1.4.2v1.4.2 ↓1.4.22026-05-24
+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

Discussions

Latest release

v1.4.2 v1.4.2 2026-05-24
What'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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON