Usage

Extract subtitles from YouTube videos using yt-dlp, then summarize or return raw text.

Usage

• /yt-transcript <url> → Extract + summarize (default)
• /yt-transcript <url> --raw → Extract only, no summary

Implementation Steps

1. Parse Arguments

Check $ARGUMENTS for:

• YouTube URL (required, first argument)
• --raw flag (optional)

If no URL provided, show usage and exit.

2. Extract Subtitles

Use yt-dlp to download subtitles (prefer French, fallback to English):

yt-dlp --write-auto-subs --sub-langs "fr,en" --sub-format vtt --skip-download -o "/tmp/yt_%(id)s" "$URL"

3. Parse VTT File

• Locate /tmp/yt_*.vtt (fr preferred, fallback en)
• Strip headers, timestamps, duplicate lines, empty lines

4. Handle Output

If --raw flag present: Return cleaned transcript directly.

Otherwise: Summarize with V{n} prefix — Brief overview → Key points → Takeaways. Delete /tmp/yt_*.vtt after.

Error Handling

• No subtitles available: Inform user that the video has no auto-generated or manual subtitles
• Invalid URL: Show usage message
• yt-dlp missing: Suggest installation via brew install yt-dlp
• File not found: Check if extraction succeeded before parsing

Example Output Format

With summary (default):

V1: [Video Title]

📺 Overview: [Brief description]

🔑 Key Points:
├── Point 1
├── Point 2
└── Point 3

💡 Takeaways: [Main insights]

With --raw flag:

[Clean transcript text without timestamps or duplicates]