介绍
# Video Subtitles
从视频或音频文件生成电影风格字幕。支持转录、翻译以及将字幕直接烧录到视频中。
## 功能
- **希伯来语**：ivrit.ai 微调模型（希伯来语转录效果最佳） - **英语**：OpenAI Whisper large-v3 - **自动检测**：自动检测语言并选择最佳模型 - **翻译**：希伯来语 → 英语翻译 - **烧录**：将字幕硬编码到视频中（在包括 WhatsApp 在内的任何地方均可见） - **电影风格**：自然的字幕断行（每行 42 字符，时长 1-7 秒）
## 快速开始
```bash # Plain transcript ./scripts/generate_srt.py video.mp4
# Generate SRT file ./scripts/generate_srt.py video.mp4 --srt
# Burn subtitles into video (always visible) ./scripts/generate_srt.py video.mp4 --srt --burn
# Translate to English + burn in ./scripts/generate_srt.py video.mp4 --srt --burn --translate en
# Force language ./scripts/generate_srt.py video.mp4 --lang he # Hebrew ./scripts/generate_srt.py video.mp4 --lang en # English ```
## 选项
| 标志 | 描述 | |------|-------------| | `--srt` | 生成 SRT 字幕文件 | | `--burn` | 将字幕烧录到视频中（硬编码，始终可见） | | `--embed` | 嵌入软字幕（可在播放器中切换） | | `--translate en` | 翻译为英语 | | `--lang he/en` | 强制指定输入语言 | | `-o FILE` | 自定义输出路径 |
## 输出
- **默认**：纯文本转录结果输出到 stdout - **使用 `--srt`**：在输入文件旁创建 `video.srt` - **使用 `--burn`**：创建带硬编码字幕的 `video_subtitled.mp4`
## 环境要求
- **uv**：Python 包管理器（会自动安装依赖） - **ffmpeg-full**：用于烧录字幕（`brew install ffmpeg-full`） - **模型**：每个约 3GB，首次使用时自动下载
## 字幕样式
- 字号 12，白色文字配黑色描边 - 底部对齐，电影风格定位 - 每行最多 42 字符，最多 2 行 - 在标点符号和停顿处自然断行