mcpField
V
video-subtitles

video-subtitles

github.com/thinkfleetaiCreative & media059 installsUpdated 36w ago
Repository

About video-subtitles

video-subtitles is a command-line skill for transcribing video or audio, translating Hebrew into English, and producing movie-style subtitles. It can export subtitle files or embed them in a video.

Key features

  1. 01Automatic language detection
  2. 02Hebrew and English transcription
  3. 03Hebrew-to-English translation
  4. 04SRT subtitle file generation
  5. 05Burn-in or toggleable subtitles
  6. 06Movie-style line breaks

Use cases

  1. 01Transcribing a video into plain text
  2. 02Creating an SRT file for a video
  3. 03Translating Hebrew video into English
  4. 04Making subtitles always visible in a video

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/thinkfleetai/thinkfleet-engine --skill video-subtitles

After installing, type/video-subtitlesin Claude Code to confirm it loaded.

Details

From the project README

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

FlagDescription
--srtGenerate SRT subtitle file
--burnBurn subtitles into video (hardcoded, always visible)
--embedEmbed soft subtitles (toggle in player)
--translate enTranslate to English
--lang he/enForce input language
-o FILECustom 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

Comments

Markdown supported