aravhawk/notebooklm

<!-- notebooklm-py v0.3.4 -->

NotebookLM Automation

Complete programmatic access to Google NotebookLM—including capabilities not exposed in the web UI. Create notebooks, add sources (URLs, YouTube, PDFs, audio, video, images), chat with content, generate all artifact types, and download results in multiple formats.

When This Skill Activates

Explicit: User says "/notebooklm", "use notebooklm", "install notebooklm", or mentions the tool by name

Intent detection: Recognize requests like:

• "Create a podcast about [topic]"
• "Summarize these URLs/documents"
• "Generate a quiz from my research"
• "Turn this into an audio overview"
• "Create flashcards for studying"
• "Generate a video explainer"
• "Make an infographic"
• "Create a mind map of the concepts"
• "Download the quiz as markdown"
• "Add these sources to NotebookLM"
• "Add this to Co-work" / "Make this work in Co-work"

Autonomy Rules

Run automatically (no confirmation):

• notebooklm status - check context
• notebooklm auth check - diagnose auth issues
• notebooklm list - list notebooks
• notebooklm source list - list sources
• notebooklm artifact list - list artifacts
• notebooklm language list - list supported languages
• notebooklm language get - get current language
• notebooklm language set - set language (global setting)
• notebooklm artifact wait - wait for artifact completion
• notebooklm source wait - wait for source processing
• notebooklm research status - check research status
• notebooklm research wait - wait for research
• notebooklm use <id> - set context
• notebooklm create - create notebook
• notebooklm ask "..." - chat queries (without --save-as-note)
• notebooklm history - display conversation history (read-only)
• notebooklm source add - add sources

Ask before running:

• notebooklm delete - destructive
• notebooklm generate * - long-running, may fail
• notebooklm download * - writes to filesystem
• notebooklm ask "..." --save-as-note - writes a note
• notebooklm history --save - writes a note

Quick Reference

| Task | Command | |------|---------| | List notebooks | notebooklm list | | Create notebook | notebooklm create "Title" | | Set context | notebooklm use <notebook_id> | | Show context | notebooklm status | | Add URL source | notebooklm source add "https://..." | | Add file | notebooklm source add ./file.pdf | | Add YouTube | notebooklm source add "https://youtube.com/..." | | List sources | notebooklm source list | | Wait for source processing | notebooklm source wait <source_id> | | Web research (fast) | notebooklm source add-research "query" | | Web research (deep) | notebooklm source add-research "query" --mode deep --no-wait | | Check research status | notebooklm research status | | Wait for research | notebooklm research wait --import-all | | Chat | notebooklm ask "question" | | Chat (specific sources) | notebooklm ask "question" -s src_id1 -s src_id2 | | Chat (with references) | notebooklm ask "question" --json | | Chat (save answer as note) | notebooklm ask "question" --save-as-note | | Show conversation history | notebooklm history | | Save all history as note | notebooklm history --save | | Get source fulltext | notebooklm source fulltext <source_id> | | Generate podcast | notebooklm generate audio "instructions" | | Generate video | notebooklm generate video "instructions" | | Generate report | notebooklm generate report --format briefing-doc | | Generate quiz | notebooklm generate quiz | | Generate flashcards | notebooklm generate flashcards | | Generate infographic | notebooklm generate infographic | | Generate mind map | notebooklm generate mind-map | | Generate slide deck | notebooklm generate slide-deck | | Revise a slide | notebooklm generate revise-slide "prompt" --artifact <id> --slide 0 | | Check artifact status | notebooklm artifact list | | Wait for completion | notebooklm artifact wait <artifact_id> | | Download audio | notebooklm download audio ./output.mp3 | | Download video | notebooklm download video ./output.mp4 | | Download slide deck (PDF) | notebooklm download slide-deck ./slides.pdf | | Download slide deck (PPTX) | notebooklm download slide-deck ./slides.pptx --format pptx | | Download report | notebooklm download report ./report.md | | Download mind map | notebooklm download mind-map ./map.json | | Download data table | notebooklm download data-table ./data.csv | | Download quiz | notebooklm download quiz quiz.json | | Download flashcards | notebooklm download flashcards cards.json | | List languages | notebooklm language list | | Set language | notebooklm language set zh_Hans |

Generation Types

All generate commands support:

• -s, --source to use specific source(s) instead of all sources
• --language to set output language (defaults to 'en')
• --json for machine-readable output
• --retry N to automatically retry on rate limits

| Type | Command | Options | Download | |------|---------|---------|----------| | Podcast | generate audio | --format [deep-dive\|brief\|critique\|debate], --length [short\|default\|long] | .mp3 | | Video | generate video | --format [explainer\|brief], --style [auto\|classic\|whiteboard\|kawaii\|anime\|watercolor\|retro-print\|heritage\|paper-craft] | .mp4 | | Slide Deck | generate slide-deck | --format [detailed\|presenter], --length [default\|short] | .pdf / .pptx | | Slide Revision | generate revise-slide "prompt" --artifact <id> --slide N | --wait, --notebook | (re-downloads parent deck) | | Infographic | generate infographic | --orientation [landscape\|portrait\|square], --detail [concise\|standard\|detailed] | .png | | Report | generate report | --format [briefing-doc\|study-guide\|blog-post\|custom], --append "extra instructions" | .md | | Mind Map | generate mind-map | (sync, instant) | .json | | Data Table | generate data-table | description required | .csv | | Quiz | generate quiz | --difficulty [easy\|medium\|hard], --quantity [fewer\|standard\|more] | .json/.md/.html | | Flashcards | generate flashcards | --difficulty [easy\|medium\|hard], --quantity [fewer\|standard\|more] | .json/.md/.html |

Common Workflows

Research to Podcast

1. notebooklm create "Research: [topic]"
2. notebooklm source add for each URL/document
3. Wait for sources: notebooklm source list --json until all status=READY
4. notebooklm generate audio "Focus on [specific angle]"
5. Check notebooklm artifact list for status
6. notebooklm download audio ./podcast.mp3 when complete

Document Analysis

1. notebooklm create "Analysis: [project]"
2. notebooklm source add ./doc.pdf (or URLs)
3. notebooklm ask "Summarize the key points"
4. Continue chatting as needed

Output Formats (--json)

// notebooklm list --json
{"notebooks": [{"id": "...", "title": "...", "created_at": "..."}]}

// notebooklm source list --json
{"sources": [{"id": "...", "title": "...", "status": "ready|processing|error"}]}

// notebooklm artifact list --json
{"artifacts": [{"id": "...", "title": "...", "type": "Audio Overview", "status": "in_progress|pending|completed|unknown"}]}

Error Handling

| Error | Cause | Action | |-------|-------|--------| | Auth/cookie error | Session expired | Re-run notebooklm login | | "No notebook context" | Context not set | Run notebooklm use <id> | | Rate limiting | Google throttle | Wait 5-10 min, retry | | Download fails | Generation incomplete | Check artifact list for status |

Known Limitations

• Audio, video, quiz, flashcard, infographic, and slide deck generation may fail due to Google rate limits
• Generation times: audio 10-20 min, video 15-45 min, quiz/flashcards 5-15 min
• This is an unofficial API — Google can change things without warning