VideoCaptioner README

The project's README from github.com/WEIFENG2333/VideoCaptioner. As one markdown file: README.md.

VideoCaptioner Logo

VideoCaptioner

基于大语言模型的视频字幕处理工具 — 语音识别、字幕优化、翻译、视频合成一站式处理

在线文档 · CLI 使用 · GUI 桌面版 · Claude Code Skill

安装

pip install videocaptioner          # 安装 CLI + GUI 桌面版

免费功能（必剪语音识别、必应/谷歌翻译）无需任何配置，安装即用。

CLI 命令行

# 语音转录（免费，无需 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：

videocaptioner config set llm.api_key <your-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 桌面版

pip install videocaptioner
videocaptioner-gui                  # 显式打开桌面版
videocaptioner gui                  # 等价命令
videocaptioner                      # 无参数时也会打开桌面版
其他安装方式：Windows 安装包 / macOS 一键脚本

Windows：从 Release 下载安装包

macOS：

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：

mkdir -p ~/.claude/skills/videocaptioner
cp skills/SKILL.md ~/.claude/skills/videocaptioner/SKILL.md

然后在 Claude Code 中输入 /videocaptioner transcribe video.mp4 --asr bijian 即可使用。

工作原理

音视频输入 → 语音识别 → 字幕断句 → LLM 优化 → 翻译 → 视频合成

开发

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

Star History Chart

VideoCaptioner (WEIFENG2333/VideoCaptioner)

Searching Database…

16.3K ·GitHub
VideoCaptioner
Что это такое?VideoCaptioner (卡卡字幕助手) — это помощник для работы с субтитрами на основе LLM: он распознаёт речь, вычитывает и переводит субтитры, а затем вшивает их обратно в видео.
Это десктопная программа или утилита командной строки?И то, и другое. Есть CLI на Python (videocaptioner) и десктопное приложение с графическим интерфейсом, которое открывается командой 'videocaptioner gui'; ещё в комплекте есть Claude Code Skill, позволяющий ИИ-ассистентам для кодинга управлять программой.
Нужны ли мне какие-то API-ключи, чтобы всё заработало?Нет — распознавание речи Bijian и перевод через Bing/Google доступны бесплатно сразу после установки. API-ключ нужен только для функций на базе LLM: вычитки субтитров и перевода через LLM.
Могут ли кодинг-ассистенты вроде Claude Code использовать его напрямую?Да — в проекте есть Claude Code Skill. После его установки введите в Claude Code команду /videocaptioner transcribe video.mp4 --asr bijian, и ассистент обработает видео за вас.
Платно ли им пользоваться?Инструмент бесплатный и с открытым кодом под лицензией GPL-3.0. Встроенные движки ничего не стоят — платить нужно только своему провайдеру LLM за вычитку субтитров и ИИ-перевод.
Может ли он озвучивать видео ИИ-голосами?Да — команда dub создаёт звуковую дорожку с закадровым голосом или полностью дублированное видео на основе ваших субтитров.
Мне нужно самому приносить видеофайл?Не обязательно — команда download может скачать видео с YouTube, Bilibili и других платформ перед обработкой.
What are similar projects?pyvideotrans, autoclip, VideoHighlighter, autoshorts, open-edit, omarchy-meeting-recorder, buzz, no-tipe-releases
Which topics is it in?translate, youtube-downloader, transcription, whisper, speech-recognition, video-processing, video, desktop, gplv3, gui, claude-code, desktop-app
Creator
WEIFENG2333
Size
64.2 MB
Stars
16.3K
Updated
CommitMay 24Releasev1.4.2May 24
Age
1y
Commits · 90 Days