68 lines
2.0 KiB
Markdown
68 lines
2.0 KiB
Markdown
---
|
||
name: video-subtitles
|
||
description: "从视频/音频生成SRT字幕，支持翻译。"
|
||
---
|
||
|
||
# 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
|
||
|
||
```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
|
||
```
|
||
|
||
## 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
|