Documentation Index
Fetch the complete documentation index at: https://notewise.click/docs/llms.txt
Use this file to discover all available pages before exploring further.
notewise process accepts a YouTube video URL or a bare 11-character video ID. It fetches metadata and transcript text, generates notes with the configured LiteLLM model, writes files locally, and stores run metadata in SQLite.
Supported video inputs
| Input | Example |
|---|---|
| Watch URL | https://www.youtube.com/watch?v=VIDEO_ID |
| Short URL | https://youtu.be/VIDEO_ID |
| Embed URL | https://www.youtube.com/embed/VIDEO_ID |
/v/ URL | https://www.youtube.com/v/VIDEO_ID |
| Shorts URL | https://www.youtube.com/shorts/VIDEO_ID |
| Bare video ID | VIDEO_ID |
Basic command
Common options
| Option | Default | Use it for |
|---|---|---|
--model, -m | gemini/gemini-2.5-flash | Override the LiteLLM model for one run. |
--output, -o | ./output | Write files to a specific folder. |
--format | md | Write md, html, pdf, docx, or a comma-separated list. |
--language, -l | en | Specifies the transcript language; this option can be repeated. |
--target-language | English | Generate notes in another language. |
--temperature, -t | 0.7 | Change LLM temperature, range 0.0 to 1.0. |
--max-tokens, -k | provider default | Cap LLM output tokens. |
--force, -F | false | Ignore cache and regenerate. |
--no-ui | false | Disable the Rich live dashboard. |
--verbose, -v | false | Write DEBUG diagnostics to the session log. |
--quiz | false | Generate a quiz Markdown file. |
--export-transcript | none | Export transcript as txt or json. |
--timestamps | false | Prefix generated chapter headers with start times. |
--chapter-directory-output | false | Write per-chapter Markdown files when YouTube chapters exist. |
--cookie-file, --cookies | YOUTUBE_COOKIE_FILE | Read restricted videos with a Netscape cookies file. |
--use-combine-chunk | false | Use deprecated legacy chunk-combine behavior. |
Option examples
Chapter-aware generation is automatic when YouTube chapters exist. By default,
the final notes are bundled into one output file. Use
--chapter-directory-output
only when you want separate per-chapter Markdown files.