youtube-transcript

Turn a YouTube URL or supplied transcript into a timestamped Obsidian note.

Workflow

1. If neither URL nor transcript is provided, ask once for the missing source.
2. For a URL, run scripts/extract_subtitle.py <url> and read the selected .vtt or .srt path from its JSON output.
3. If extraction fails because yt-dlp is missing or subtitles are unavailable, say so and accept a manual transcript.
4. Transform the transcript using TEMPLATE.md; load it before writing the note.
5. Ask for a save location only if the user did not provide one. Use YYYY-MM-DD - [Video Title].md.

Content Rules

• Never invent facts; mark ambiguous claims as [uncertain: reason].
• Preserve timestamps for every important section.
• Explain methods, frameworks, and processes as clear steps or paragraphs.
• Use Obsidian callouts for quotes, tips, warnings, notes, and caveats.