youtube-notetaker

YouTube Notetaker

When to Use

Use when this workflow matches the user request: >

_Source: dair-ai/dair-academy-plugins (MIT)._

Build a personal library of YouTube talks you study with. Each video becomes one plain markdown file: slide snapshots at their timestamps, a full timestamped transcript, and editable notes. A small bundled server renders the library as an interactive deep-dive in the browser. No database, no cloud service. Everything is files on disk you fully own.

Architecture (read this first)

The markdown library is the single source of truth. The artifact is a thin HTML shell that fetches from the server and writes notes back. Never hardcode video data into the HTML.

• Library: a plain folder, set by VIDEO_LIBRARY_DIR (default ~/video-deepdives/).
• One markdown file per video, filename slug = YouTube id (e.g. RtywqDFBYnQ.md).
• Frontmatter holds video metadata + a slides array.
• Body holds the full transcript as [HH:MM:SS] text lines.
• _media/ holds slide images, namespaced per video as <youtube_id>-slide-NN.jpg

to avoid collisions between videos.

• Server: scripts/serve.py, a single stdlib + PyYAML file. Start it with:

`` python3 scripts/serve.py --dir ~/video-deepdives --port 8000 ` It serves the artifact at /` and a small API the