Skip to content
Back to search

VideoCaptioner

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

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/weifeng2333--videocaptioner/badge.svg)](/listings/weifeng2333--videocaptioner)

HTML

<a href="/listings/weifeng2333--videocaptioner"><img src="/api/listings/weifeng2333--videocaptioner/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 146 lines · 1 finding marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img src="./docs/images/logo.png" alt="VideoCaptioner Logo" width="100">
  3. <h1>VideoCaptioner</h1>
  4. <p>基于大语言模型的视频字幕处理工具 — 语音识别、字幕优化、翻译、视频合成一站式处理</p>
  5. [在线文档](https://weifeng2333.github.io/VideoCaptioner/) · [CLI 使用](#cli-命令行) · [GUI 桌面版](#gui-桌面版) · [Claude Code Skill](#claude-code-skill)
  6. </div>
  7. ## 安装
  8. ```bash
  9. pip install videocaptioner # 安装 CLI + GUI 桌面版
  10. ```
  11. 免费功能(必剪语音识别、必应/谷歌翻译)**无需任何配置,安装即用**。
  12. ## CLI 命令行
  13. ```bash
  14. # 语音转录(免费,无需 API Key)
  15. videocaptioner transcribe video.mp4 --asr bijian
  16. # 字幕翻译(免费必应翻译)
  17. videocaptioner subtitle input.srt --translator bing --target-language en
  18. # 全流程:转录 → 优化 → 翻译 → 合成
  19. videocaptioner process video.mp4 --target-language ja
  20. # 字幕烧录到视频
  21. videocaptioner synthesize video.mp4 -s subtitle.srt
  22. # 下载在线视频
  23. videocaptioner download "https://youtube.com/watch?v=xxx"
  24. ```
  25. 需要 LLM 功能(字幕优化、大模型翻译)时,配置 API Key:
  26. ```bash
  27. videocaptioner config set llm.api_key <your-key>
  28. videocaptioner config set llm.api_base https://api.openai.com/v1
  29. videocaptioner config set llm.model gpt-4o-mini
  30. ```
  31. 配置优先级:`命令行参数 > 环境变量 (VIDEOCAPTIONER_*) > 配置文件 > 默认值`。运行 `videocaptioner config show` 查看当前配置。
  32. <details>
  33. <summary>所有 CLI 命令一览</summary>
  34. | 命令 | 说明 |
  35. |------|------|
  36. | `gui` | 打开桌面版。也可以直接运行 `videocaptioner-gui` |
  37. | `transcribe` | 语音转字幕。引擎:`faster-whisper`、`whisper-api`、`bijian`(免费)、`jianying`(免费)、`whisper-cpp` |
  38. | `subtitle` | 字幕优化/翻译。翻译服务:`llm`、`bing`(免费)、`google`(免费) |
  39. | `dub` | 根据字幕生成配音音轨或配音视频 |
  40. | `synthesize` | 字幕烧录到视频(软字幕/硬字幕) |
  41. | `process` | 全流程处理 |
  42. | `download` | 下载 YouTube、B站等平台视频 |
  43. | `config` | 配置管理(`show`、`set`、`get`、`path`、`init`) |
  44. 运行 `videocaptioner <命令> --help` 查看完整参数。完整 CLI 文档见 [docs/cli.md](docs/cli.md)。
  45. </details>
  46. ## GUI 桌面版
  47. ```bash
  48. pip install videocaptioner
  49. videocaptioner-gui # 显式打开桌面版
  50. videocaptioner gui # 等价命令
  51. videocaptioner # 无参数时也会打开桌面版
  52. ```
  53. <details>
  54. <summary>其他安装方式:Windows 安装包 / macOS 一键脚本</summary>
  55. **Windows**:从 [Release](https://github.com/WEIFENG2333/VideoCaptioner/releases) 下载安装包
  56. **macOS**:
  57. ```bash
  58. curl -fsSL https://raw.githubusercontent.com/WEIFENG2333/VideoCaptioner/master/scripts/run.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 80 on GitHub
  59. ```
  60. </details>
  61. <!-- <div align="center">
  62. <img src="https://h1.appinn.me/file/1731487405884_main.png" alt="界面预览" width="90%" style="border-radius: 5px;">
  63. </div> -->
  64. ![页面预览](https://h1.appinn.me/file/1731487410170_preview1.png)
  65. ![页面预览](https://h1.appinn.me/file/1731487410832_preview2.png)
  66. ## LLM API 配置
  67. LLM 仅用于字幕优化和大模型翻译,免费功能(必剪识别、必应翻译)无需配置。
  68. 支持所有 OpenAI 兼容接口的服务商:
  69. | 服务商 | 官网 |
  70. |--------|------|
  71. | **VideoCaptioner 中转站** | [api.videocaptioner.cn](https://api.videocaptioner.cn) — 高并发,性价比高,支持 GPT/Claude/Gemini 等 |
  72. | SiliconCloud | [cloud.siliconflow.cn](https://cloud.siliconflow.cn/i/HF95kaoz) |
  73. | DeepSeek | [platform.deepseek.com](https://platform.deepseek.com) |
  74. 在软件设置或 CLI 中填入 API Base URL 和 API Key 即可。[详细配置教程](https://weifeng2333.github.io/VideoCaptioner/config/llm)
  75. ## Claude Code Skill
  76. 本项目提供了 [Claude Code Skill](https://code.claude.com/docs/en/skills.md),让 AI 编程助手可以直接调用 VideoCaptioner 处理视频。
  77. 安装到 Claude Code:
  78. ```bash
  79. mkdir -p ~/.claude/skills/videocaptioner
  80. cp skills/SKILL.md ~/.claude/skills/videocaptioner/SKILL.md
  81. ```
  82. 然后在 Claude Code 中输入 `/videocaptioner transcribe video.mp4 --asr bijian` 即可使用。
  83. ## 工作原理
  84. ```
  85. 音视频输入 → 语音识别 → 字幕断句 → LLM 优化 → 翻译 → 视频合成
  86. ```
  87. - 词级时间戳 + VAD 语音活动检测,识别准确率高
  88. - LLM 语义理解断句,字幕阅读体验自然流畅
  89. - 上下文感知翻译,支持反思优化机制
  90. - 批量并发处理,效率高
  91. ## 开发
  92. ```bash
  93. git clone https://github.com/WEIFENG2333/VideoCaptioner.git
  94. cd VideoCaptioner
  95. uv sync && uv run videocaptioner # 运行 GUI
  96. uv run videocaptioner --help # 运行 CLI
  97. uv run pyright # 类型检查
  98. uv run pytest tests/test_cli/ -q # 运行测试
  99. ```
  100. ## 许可证
  101. [GPL-3.0](LICENSE)
  102. [![Star History Chart](https://api.star-history.com/svg?repos=WEIFENG2333/VideoCaptioner&type=Date)](https://star-history.com/#WEIFENG2333/VideoCaptioner&Date)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.