Convert YouTube videos and playlists into local study notes from your terminal.
Website Β· Docs Β· Install Β· Quickstart Β· Contributing
YouTube has become one of the richest learning platforms on the planet β university lectures, conference talks, technical deep-dives, language lessons, and entire courses are all freely available. But video is a passive medium. You watch, you nod, and two days later the details are gone.
NoteWise was built to fix that gap.
The idea is simple: your time watching a video is valuable. The notes that should come from it β the structured, searchable, reviewable kind β should not require an extra hour of your day. NoteWise automates that step. Point it at a YouTube URL and walk away with local Markdown study notes that are deeper and more useful than most people would write by hand.
Where it shines:
- π Students catching up on lecture recordings or supplementing textbooks with YouTube explanations
- π§βπ» Developers staying on top of conference talks, tutorials, and technical deep-dives without watching at 3x speed
- π Language learners extracting structured notes from native-language content
- π Researchers quickly distilling hours of talks into organized, searchable reference material
- π’ Teams turning internal video presentations into shareable written documentation
The output is not just a transcript summary. It is structured, hierarchical Markdown with headers, sub-topics, definitions, examples, and concepts explained in depth. Chapter-aware videos can be split into per-chapter files, and long courses can be processed into organized local notes. Everything lands in your filesystem: portable, searchable, and permanently yours.
uv tool install notewise
notewise setup
notewise process "https://youtu.be/VIDEO_ID"Generated notes land in ./output by default.
Prefer another install method?
# Try without installing
uvx notewise --help
# Standalone binary installer
curl -fsSL https://notewise.click/install | shWindows PowerShell:
irm https://notewise.click/install | iexSee the full installation guide for uv, uvx, pipx, pip, Docker, and standalone binaries.
Watch the full demo: demo/notewise.mp4
| Need | Go here |
|---|---|
| Install choices | Install NoteWise |
| First successful run | Quickstart |
| Processing flags and formats | Process videos |
| Provider/model setup | Providers |
| OAuth providers | OAuth |
| Playlists and batches | Playlists & batches |
| Troubleshooting | Troubleshooting |
| CLI command reference | Commands |
notewise process "https://youtu.be/VIDEO_ID" --format md,docx --quiz
notewise process "https://youtube.com/playlist?list=PLAYLIST_ID"
notewise doctor
notewise updatenotewise update checks the latest release and prints the right upgrade command group for standalone binary or Python package installs. Run notewise --help or open the command reference for the full CLI surface.
git clone https://github.com/whoisjayd/notewise
cd notewise
uv sync --dev
make testWebsite work uses Bun from website/:
bun install --frozen-lockfile
bun run lint
bunx tsc --noEmit
bun run buildDocs live in docs/. Do not run Prettier on Mintlify MDX; validate docs config with:
python -m json.tool docs/docs.json
node --check docs/umami.jsRead CONTRIBUTING.md before opening a PR.
MIT with Attribution. If you use NoteWise in a project or build on top of it, include credit and a link back to this repository.
NoteWise is built on a great open-source ecosystem. See GRATITUDE.md for acknowledgements.
Found a bug? Open an issue. Security concern? See SECURITY.md.
