youtube-transcript

Quick Start

# Download transcript (markdown with timestamps)
python scripts/download_transcript.py "https://youtube.com/watch?v=VIDEO_ID"

# Output: VideoTitle.en.md

Options

| Option | Default | Description | |--------|---------|-------------| | --lang LANG | en | Language code | | --format {md,vtt} | md | Output format | | --output-dir DIR | . | Output directory | | --auto-only | - | Auto-generated subs only | | --list | - | List available subtitles | | --check-setup | - | Verify environment |

Examples

# List available subtitles
python scripts/download_transcript.py "URL" --list

# Download VTT format
python scripts/download_transcript.py "URL" --format vtt

# Spanish transcript to specific folder
python scripts/download_transcript.py "URL" --lang es --output-dir ./transcripts

Output Formats

Markdown (default):

# Transcript

**[00:00:00]** Hello everyone and welcome back.

**[00:00:03]** Today we'll be discussing...

VTT:

WEBVTT

00:00:00.000 --> 00:00:03.500
Hello everyone and welcome back.

Setup

# Check environment
python scripts/download_transcript.py --check-setup

# Install yt-dlp
brew install yt-dlp    # macOS
pip install yt-dlp     # in venv