# Video Subtitles

> Generate SRT subtitles from video/audio with translation support. Transcribes Chinese (FunASR/Whisper), English (Whisper), Hebrew (ivrit.ai), translates between languages, burns subtitles into video. Use for creating captions, transcripts, or hardcoded subtitles.

- Skill: `xyva-yuangui/video-subtitles` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add xyva-yuangui/video-subtitles`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xyva-yuangui/video-subtitles/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: xyva-yuangui (https://skillmd.com/u/xyva-yuangui)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/xyva-yuangui/video-subtitles

---


# Video Subtitles

字幕生成助手。**触发后必须先询问用户确认**，再执行生成。

| 触发场景 | 询问确认内容 |
|----------|-------------|
| 字幕生成 | 确认视频路径、源语言、字幕格式 (SRT/内嵌) |
| 语音转录 | 确认音频/视频路径、输出格式 (文字/SRT) |
| 字幕翻译 | 确认源语言、目标语言、是否烧录 |
| 字幕烧录 | 确认视频路径、字幕文件、输出质量 |

**执行流程**: 触发 → 询问用户 → 用户确认 → 执行生成 → 返回文件路径

Full docs: read SKILL-REFERENCE.md

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

## Features

- **Chinese (中文)**: FunASR (Alibaba, recommended) or Whisper large-v3
- **English**: OpenAI Whisper large-v3
- **Hebrew**: ivrit.ai fine-tuned model
- **Auto-detect**: Automatically detects language and selects best model
- **Translation**: Translate between zh/en/he
- **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 zh    # Chinese (default)
./scripts/generate_srt.py video.mp4 --lang en    # English
./scripts/generate_srt.py video.mp4 --lang he    # Hebrew
```

## 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 zh/en/he` | Force input language (default: zh) |
| `-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