Skip to main content

Basic usage

notewise process "https://youtube.com/watch?v=VIDEO_ID"
Notes are written to ./output/<sanitized video title>.md by default.

Accepted URL formats

# Standard watch URL
notewise process "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

# Short URL
notewise process "https://youtu.be/dQw4w9WgXcQ"

# Shorts URL
notewise process "https://www.youtube.com/shorts/dQw4w9WgXcQ"

# Embed URL
notewise process "https://www.youtube.com/embed/dQw4w9WgXcQ"

# Bare 11-character video ID
notewise process dQw4w9WgXcQ

Common Options

OptionFlagDescription
Output directory--output, -oSet output directory (default: ./output)
Model--model, -mSpecify LLM model (e.g., gpt-4o, groq/llama3-70b-8192)
Temperature--temperature, -tSet LLM temperature (0.0-1.0, default: 0.7)
Quiz--quizGenerate quiz with 10-15 MCQ questions
Export transcript--export-transcriptExport transcript as txt or json
Language--language, -lSet transcript language preference (can chain)
Force reprocess--force, -FRe-process cached videos
No UI--no-uiDisable Rich dashboard (for CI/cron)

Output Files

output
Video Title.md
Video Title_quiz.md
Video Title_transcript.txt
Video Title_transcript.json
Quiz and transcript files are only created when the corresponding flag is used. Chapter-aware videos (longer than 1 hour with chapter data) use a directory layout instead. See Output Format.

Inspect without processing

notewise info "https://youtube.com/watch?v=VIDEO_ID"
Fetches title, duration, chapter count, and available transcript languages — without generating any notes.
Last modified on March 28, 2026