aviz85/transcribe

Transcribe

First time? If setup_complete: false above, run ./SETUP.md first, then set setup_complete: true.

Generate SRT subtitle files from audio/video using ElevenLabs Scribe v2.

Quick Start

cd ~/.claude/skills/transcribe/scripts

# Basic transcription (auto-detect language)
npx ts-node transcribe.ts -i /path/to/video.mp4 -o /path/to/output.srt

# Specify language
npx ts-node transcribe.ts -i /path/to/video.mp4 -o /path/to/output.srt -l en

# Custom subtitle length (max words per entry)
npx ts-node transcribe.ts -i /path/to/video.mp4 -o /path/to/output.srt --max-words 6

# Custom max duration per subtitle
npx ts-node transcribe.ts -i /path/to/video.mp4 -o /path/to/output.srt --max-duration 4.0

Options

| Option | Short | Default | Description | |--------|-------|---------|-------------| | --input | -i | (required) | Input audio/video file | | --output | -o | (required) | Output SRT file path | | --language | -l | auto | Language code (en, he, ar, etc.) | | --max-words | | 5 | Max words per subtitle entry | | --max-duration | | 3.0 | Max seconds per subtitle entry | | --max-chars | | 70 | Max characters per subtitle entry | | --timing-offset | | 0.25 | Timing offset in seconds | | --json | | false | Also output raw transcript JSON |

Language Codes

• en - English
• he - Hebrew
• ar - Arabic
• es - Spanish
• fr - French
• de - German
• ru - Russian
• zh - Chinese
• ja - Japanese
• (or omit for auto-detection)

Output

The script generates:

1. .srt file - Standard subtitle file
2. .json file (optional) - Raw transcript with word-level timestamps

Environment

API key stored in scripts/.env:

ELEVENLABS_API_KEY=your_key_here