名称： video-subtitles
描述： 从视频/音频文件生成SRT字幕，支持翻译。支持希伯来语（ivrit.ai）和英语（whisper）转录、语言间翻译、将字幕烧录进视频。可用于创建字幕、文本转录，或为 WhatsApp/社交媒体生成硬编码字幕。

视频字幕生成

从视频或音频文件生成电影风格的字幕。支持转录、翻译，并可将字幕直接烧录到视频中。

功能特性

• 希伯来语：使用 ivrit.ai 微调模型（最佳希伯来语转录）
• 英语：使用 OpenAI Whisper large-v3 模型
• 自动检测：自动检测语言并选择最佳模型
• 翻译：支持希伯来语 → 英语翻译
• 烧录：将字幕硬编码到视频中（在任何地方都可见，包括 WhatsApp）
• 电影风格：自然的字幕断句（每行最多 42 个字符，持续时间 1-7 秒）

快速开始

# 生成纯文本转录
./scripts/generate_srt.py video.mp4

# 生成 SRT 字幕文件
./scripts/generate_srt.py video.mp4 --srt

# 将字幕烧录到视频中（始终可见）
./scripts/generate_srt.py video.mp4 --srt --burn

# 翻译为英语并烧录
./scripts/generate_srt.py video.mp4 --srt --burn --translate en

# 强制指定语言
./scripts/generate_srt.py video.mp4 --lang he    # 希伯来语
./scripts/generate_srt.py video.mp4 --lang en    # 英语

选项说明

输出文件

• 默认：纯文本转录输出到标准输出 (stdout)
• 使用 --srt：在输入文件旁创建 video.srt 文件
• 使用 --burn：创建带有硬编码字幕的 video_subtitled.mp4 文件

环境要求

• uv：Python 包管理器（自动安装依赖）
• ffmpeg-full：用于烧录字幕 (brew install ffmpeg-full)
• 模型文件：每个约 3GB，首次使用时自动下载

字幕样式

• 字体大小 12，白色文字带黑色描边
• 底部对齐，电影风格定位
• 每行最多 42 个字符，最多 2 行
• 在标点符号和停顿处自然断句