video-subtitle 0.1.0

Video subtitles: FFmpeg extract audio → Whisper ASR → SRT → FFmpeg burn-in
Documentation

video-subtitle

crates.io docs.rs

视频自动字幕：FFmpeg 提取音频 → Whisper 识别 → SRT → FFmpeg 烧录硬字幕。

同时提供 CLI 工具 与 Rust 库（video_subtitle）。

安装

从 crates.io（需先配置 Rust 与系统依赖）

cargo install video-subtitle

从源码

git clone https://github.com/kingning2/video-subtitle
cd video-subtitle
cargo install --path .

系统依赖

依赖 说明
FFmpeg 在 PATH 中可用，或运行时 --ffmpeg 指定
Whisper GGML 模型 如 ggml-small.bin
CMake + C++ 编译器 编译 whisper-rs 时需要（Windows 建议 VS Build Tools）

中文内容推荐使用 ggml-small.bin 或更大模型，-l zh。

用法

video-subtitle -i input.mp4 -m /path/to/ggml-small.bin -l zh
参数 说明
-i, --input 输入视频（必填）
-m, --model Whisper GGML 模型路径（必填）
-o, --output 输出视频（默认 {原名}_subtitled.mp4）
-l, --language 语言，如 zh、en；auto 为自动检测
--translate Whisper 翻译为英语（做中文字幕时不要加）
--srt-only 只生成 SRT，不烧录
--keep-temp 保留临时 .tmp.wav / .tmp.srt
--ffmpeg 指定 ffmpeg 可执行文件

仅生成字幕：

video-subtitle -i demo.mp4 -m ggml-small.bin -l zh --srt-only --keep-temp

作为库使用

use clap::Parser;
use video_subtitle::cli::Cli;
use video_subtitle::pipeline::run;

let cli = Cli::parse();
let output = run(&cli)?;
println!("SRT: {}", output.srt_path.display());

模块说明见 docs.rs。

发布到 crates.io（维护者）

  1. 在 crates.io 注册并获取 API Token
  2. 登录并发布（详见 PUBLISHING.md）：
cargo login
cargo publish

首次发布前本地检查：

cargo package --allow-dirty
cargo install --path . -f

注意：crate 依赖 whisper-rs，用户 cargo install 时会在本机编译 whisper.cpp，与直接 cargo build 相同。

License

MIT — 见 LICENSE.