Skip to main content
Start here after installing NoteWise. This page covers the first successful run only: create config, process one public YouTube video, and confirm the output file.
1

Create config

notewise setup
The setup wizard writes supported keys to ~/.notewise/config.env unless NOTEWISE_HOME points somewhere else.
2

Process one video

notewise process "https://youtu.be/VIDEO_ID"
By default this uses gemini/gemini-2.5-flash, requests English transcripts, and writes Markdown into ./output.
3

Check the result

ls output
The default file is a sanitized video title ending in .md.

​
Next steps

After the first run works, use the focused guides instead of repeating setup here:

Process options

Change output folders, formats, models, quizzes, transcripts, and dashboard behavior.

Provider setup

Pick a LiteLLM provider and model string for future runs.

Playlists and batches

Process full courses, URL lists, and reruns with cache-aware behavior.

Troubleshooting

Debug setup, YouTube, output, cache, and provider failures.

​
If the first run fails

Start with the health check, then open the troubleshooting guide if it reports a problem: 
notewise doctor
Do not share API keys, OAuth tokens, cookies, raw prompts, or provider payloads when asking for help.
Last modified on May 1, 2026