video-subtitles

Video Subtitles

Generate movie-style subtitles from video or audio files. Supports transcription, translation, and burning subtitles directly into video.

Features

• Hebrew: ivrit.ai fine-tuned model (best Hebrew transcription)
• English: OpenAI Whisper large-v3
• Auto-detect: Automatically detects language and selects best model
• Translation: Translate Hebrew → English
• Burn-in: Hardcode subtitles into video (visible everywhere, including WhatsApp)
• Movie-style: Natural subtitle breaks (42 chars/line, 1-7s duration)

Quick Start

# 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

## Options

| Flag | Description |
|------|-------------|
| `--srt` | Generate SRT subtitle file |
| `--burn` | Burn subtitles into video (hardcoded, always visible) |
| `--embed` | Embed soft subtitles (toggle in player) |
| `--translate en` | Translate to English |
| `--lang he/en` | Force input language |
| `-o FILE` | Custom output path |

## Output

- **Default**: Plain text transcript to stdout
- **With `--srt`**: Creates `video.srt` alongside input
- **With `--burn`**: Creates `video_subtitled.mp4` with hardcoded subs

## Requirements

- **uv**: Python package manager (auto-installs dependencies)
- **ffmpeg-full**: For burning subtitles (`brew install ffmpeg-full`)
- **Models**: ~3GB each, auto-downloaded on first use

## Subtitle Style

- Font size 12, white text with black outline
- Bottom-aligned, movie-style positioning
- Max 42 chars/line, 2 lines max
- Natural breaks at punctuation and pauses