Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/teng-lin/notebooklm-py/llms.txt

Use this file to discover all available pages before exploring further.

The download command group saves completed artifacts to your local filesystem. You can download the latest artifact, a specific artifact by ID or name, or all artifacts of a given type at once. The CLI handles authentication for download URLs automatically using your saved session.
notebooklm download <type> [OUTPUT_PATH] [OPTIONS]

Common options

These options are available on most download subcommands:
OptionDescription
OUTPUT_PATHDestination file path. If omitted, a name is generated from the artifact title.
-a, --artifact IDSelect a specific artifact by ID (supports partial IDs)
--allDownload all completed artifacts of this type
--latestDownload only the most recently created artifact (default when no selector is given)
--earliestDownload only the oldest artifact
--name NAMEDownload artifact with a matching title (supports partial matches)
--forceOverwrite existing files
--dry-runShow what would be downloaded without actually downloading
--jsonOutput result as JSON

Artifact type reference

TypeDefault extensionFormat
audio.mp4Audio overview in MP4 container
video.mp4Video overview
cinematic-video.mp4Alias for download video
slide-deck.pdfPDF (default) or .pptx with --format pptx
infographic.pngPNG image
report.mdMarkdown extracted from the report artifact
mind-map.jsonHierarchical JSON tree
data-table.csvCSV with UTF-8 BOM for Excel compatibility
quiz.jsonJSON, Markdown, or HTML with --format
flashcards.jsonJSON, Markdown, or HTML with --format

Download an audio overview (podcast) as an MP4 file.
notebooklm download audio [OUTPUT_PATH] [OPTIONS]
# Download the latest podcast
notebooklm download audio ./podcast.mp4

# Download all audio artifacts
notebooklm download audio --all

# Preview what would be downloaded
notebooklm download audio --all --dry-run

# Download a specific artifact by ID
notebooklm download audio ./podcast.mp4 --artifact abc123

# Force overwrite existing file
notebooklm download audio ./podcast.mp4 --force
Download a video overview as an MP4 file.
notebooklm download video [OUTPUT_PATH] [OPTIONS]
# Download the latest video
notebooklm download video ./overview.mp4

# Download the earliest video
notebooklm download video --earliest

# Download all videos
notebooklm download video --all

# JSON output for scripting
notebooklm download video ./overview.mp4 --json
Alias for download video. Downloads a cinematic-style video overview as an MP4 file. Accepts the same options as video.
notebooklm download cinematic-video [OUTPUT_PATH] [OPTIONS]
notebooklm download cinematic-video ./documentary.mp4

notebooklm download cinematic-video --latest --json
Download a slide deck as PDF (default) or editable PowerPoint. Downloading as PPTX is a beyond-web-UI feature — the NotebookLM web interface only offers PDF export.
notebooklm download slide-deck [OUTPUT_PATH] [OPTIONS]
OptionValuesDefaultDescription
--formatpdf, pptxpdfOutput file format
# Download latest slide deck as PDF
notebooklm download slide-deck ./slides.pdf

# Download as editable PowerPoint
notebooklm download slide-deck --format pptx

# Download a specific deck by name
notebooklm download slide-deck --name "Final Presentation"

# Preview all slide decks
notebooklm download slide-deck --all --dry-run
PPTX download is not available in the NotebookLM web UI. Use this CLI command to get an editable PowerPoint file.
Download a generated infographic as a PNG image.
notebooklm download infographic [OUTPUT_PATH] [OPTIONS]
# Download the latest infographic
notebooklm download infographic ./infographic.png

# Download all infographics
notebooklm download infographic --all

# Download by artifact ID
notebooklm download infographic ./overview.png --artifact art456
Download a report (Briefing Doc, Study Guide, Blog Post, or Custom) as a Markdown file. The CLI extracts the markdown content from the artifact automatically.
notebooklm download report [OUTPUT_PATH] [OPTIONS]
# Download the latest report
notebooklm download report ./report.md

# Download a study guide by name
notebooklm download report --name "Study Guide"

# Download all reports
notebooklm download report --all

# Download to a specific path
notebooklm download report ./study-guide.md
Download a mind map as a JSON file containing a hierarchical tree structure. The JSON format is compatible with most mind map visualization tools.
notebooklm download mind-map [OUTPUT_PATH] [OPTIONS]
The output JSON uses the following structure:
{
  "name": "Main Topic",
  "children": [
    {
      "name": "Subtopic A",
      "children": [
        { "name": "Detail 1", "children": [] },
        { "name": "Detail 2", "children": [] }
      ]
    },
    {
      "name": "Subtopic B",
      "children": []
    }
  ]
}
# Download the latest mind map
notebooklm download mind-map ./concept-map.json

# Download all mind maps
notebooklm download mind-map --all

# Preview without downloading
notebooklm download mind-map --all --dry-run
Download a data table as a CSV file. The CSV uses UTF-8 with BOM encoding for compatibility with Excel on Windows and macOS.
notebooklm download data-table [OUTPUT_PATH] [OPTIONS]
# Download the latest data table
notebooklm download data-table ./data.csv

# Download and open directly in Excel (BOM encoding handles this)
notebooklm download data-table ./research-data.csv

# Download all data tables
notebooklm download data-table --all

# Download a specific table by name
notebooklm download data-table --name "Market Comparison"
Download a quiz in JSON (default), Markdown, or HTML format.
notebooklm download quiz [OUTPUT_PATH] [OPTIONS]
OptionValuesDefaultDescription
--formatjson, markdown, htmljsonOutput format
-n, --notebook IDNotebook IDactive contextSpecify notebook
-a, --artifact IDArtifact IDlatestSelect specific quiz artifact
Output formats:
  • JSON — Structured data preserving all API fields: answerOptions, rationale, isCorrect, hint
  • Markdown — Human-readable with checkboxes indicating correct answers
  • HTML — Raw HTML as returned from NotebookLM
# Download quiz as JSON (default)
notebooklm download quiz quiz.json

# Download as markdown with answers marked
notebooklm download quiz --format markdown quiz.md

# Download as raw HTML
notebooklm download quiz --format html quiz.html

# Download a specific quiz by artifact ID
notebooklm download quiz --artifact art789 quiz.json
Download a flashcard deck in JSON (default), Markdown, or HTML format. The JSON output normalizes f/b field names to front/back for easier processing.
notebooklm download flashcards [OUTPUT_PATH] [OPTIONS]
OptionValuesDefaultDescription
--formatjson, markdown, htmljsonOutput format
-n, --notebook IDNotebook IDactive contextSpecify notebook
-a, --artifact IDArtifact IDlatestSelect specific flashcard artifact
Output formats:
  • JSON — Structured data with front/back fields (normalized from API f/b)
  • Markdown — Human-readable cards in a readable list format
  • HTML — Raw HTML as returned from NotebookLM
# Download flashcards as JSON
notebooklm download flashcards cards.json

# Download as markdown for reading
notebooklm download flashcards --format markdown cards.md

# Download as raw HTML
notebooklm download flashcards --format html cards.html

# Download a specific deck
notebooklm download flashcards --artifact art321 cards.json

Batch download examples

You can download multiple artifacts at once using --all and preview the results first with --dry-run.
# Preview all audio artifacts before downloading
notebooklm download audio --all --dry-run

# Download all audio artifacts
notebooklm download audio --all

# Download all reports to a directory
mkdir -p ./reports
notebooklm download report --all

# Download all infographics with JSON output for logging
notebooklm download infographic --all --json

Build docs developers (and LLMs) love