Video Subtitle CLI Tool

一键为视频/音频添加字幕的命令行工具 | CLI tool for adding subtitles to video/audio

功能特性 ✨

• 支持多种视频格式（MP4/MKV/AVI/MOV）和音频格式（MP3/WAV/M4A/FLAC）
• 使用OpenAI Whisper模型进行语音识别
• 生成SRT字幕文件
• 可选将字幕直接嵌入视频文件
• 断点续做（使用--force强制重新生成）

安装依赖 📦

1. 安装FFmpeg

# MacOS
brew install ffmpeg

# Windows (使用 Chocolatey)
choco install ffmpeg

# Linux
sudo apt install ffmpeg

2. 安装Node.js

需要Node.js 16+ 官网下载

3. 安装工具

npm install -g video-subtitle-cli

4. 下载 whisper 模型

npx whisper-node
``

## 使用方法 🚀

### 基本命令

```bash
video-subtitle -i input.mp4

完整选项

video-subtitle \
  -i <输入文件路径> \
  --model <模型名称> \  # 默认large-v3
  --embed \            # 嵌入字幕到视频（仅视频有效）
  --force              # 跳过缓存，强制重新生成

常用示例

1. 为视频生成字幕：

video-subtitle -i sample.mp4

2. 使用base模型快速生成：

video-subtitle -i lecture.mp3 --model base

3. 嵌入字幕到视频：

video-subtitle -i demo.mkv --embed

4. 强制重新生成所有文件：

video-subtitle -i interview.mp4 --force

参数说明 ⚙️

| 参数 | 描述 | 默认值 | |-------------|----------------------|-----------| | -i, --input | 输入文件路径（必须） | 无 | | -m, --model | Whisper模型 | large-v3 | | -e, --embed | 嵌入字幕到视频 | false | | -f, --force | 强制重新生成 | false |

文件结构 📂

处理完成后会在output/目录生成：

output/
└── 输入文件名/
    ├── 文件名.srt         # 字幕文件
    ├── 文件名.json       # 完整识别结果
    └── 文件名_with_subs.mp4  # 带字幕视频（使用--embed时生成）

常见问题 ❓

Q: 支持哪些语言？
A: 支持中文、英语、日语等多语言识别，自动检测输入语言。

Q: 如何选择模型？
A: 可用模型：tiny, base, small, medium, large-v3。模型越大精度越高，但速度越慢。

Q: 处理时间多久？
A: 取决于硬件配置，1分钟视频大约需要：

• base模型：~30秒
• large-v3模型：~2分钟

技术支持 💻

遇到问题请提交issue： GitHub Issues

License: MIT
Version: 1.0.0
Author: Conan