TheDocumentation 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.
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.
Common options
These options are available on most download subcommands:| Option | Description |
|---|---|
OUTPUT_PATH | Destination file path. If omitted, a name is generated from the artifact title. |
-a, --artifact ID | Select a specific artifact by ID (supports partial IDs) |
--all | Download all completed artifacts of this type |
--latest | Download only the most recently created artifact (default when no selector is given) |
--earliest | Download only the oldest artifact |
--name NAME | Download artifact with a matching title (supports partial matches) |
--force | Overwrite existing files |
--dry-run | Show what would be downloaded without actually downloading |
--json | Output result as JSON |
Artifact type reference
| Type | Default extension | Format |
|---|---|---|
audio | .mp4 | Audio overview in MP4 container |
video | .mp4 | Video overview |
cinematic-video | .mp4 | Alias for download video |
slide-deck | .pdf | PDF (default) or .pptx with --format pptx |
infographic | .png | PNG image |
report | .md | Markdown extracted from the report artifact |
mind-map | .json | Hierarchical JSON tree |
data-table | .csv | CSV with UTF-8 BOM for Excel compatibility |
quiz | .json | JSON, Markdown, or HTML with --format |
flashcards | .json | JSON, Markdown, or HTML with --format |
audio — download an audio overview
audio — download an audio overview
Download an audio overview (podcast) as an MP4 file.
video — download a video overview
video — download a video overview
Download a video overview as an MP4 file.
cinematic-video — download a cinematic video
cinematic-video — download a cinematic video
Alias for
download video. Downloads a cinematic-style video overview as an MP4 file. Accepts the same options as video.slide-deck — download a slide presentation
slide-deck — download a slide presentation
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.
| Option | Values | Default | Description |
|---|---|---|---|
--format | pdf, pptx | pdf | Output file format |
PPTX download is not available in the NotebookLM web UI. Use this CLI command to get an editable PowerPoint file.
infographic — download an infographic
infographic — download an infographic
Download a generated infographic as a PNG image.
report — download a text report
report — download a text report
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.
mind-map — download a mind map
mind-map — download a mind map
Download a mind map as a JSON file containing a hierarchical tree structure. The JSON format is compatible with most mind map visualization tools.The output JSON uses the following structure:
data-table — download a data table
data-table — download a data table
Download a data table as a CSV file. The CSV uses UTF-8 with BOM encoding for compatibility with Excel on Windows and macOS.
quiz — download a quiz
quiz — download a quiz
Download a quiz in JSON (default), Markdown, or HTML format.
Output formats:
| Option | Values | Default | Description |
|---|---|---|---|
--format | json, markdown, html | json | Output format |
-n, --notebook ID | Notebook ID | active context | Specify notebook |
-a, --artifact ID | Artifact ID | latest | Select specific quiz artifact |
- 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
flashcards — download a flashcard deck
flashcards — download a flashcard deck
Download a flashcard deck in JSON (default), Markdown, or HTML format. The JSON output normalizes
Output formats:
f/b field names to front/back for easier processing.| Option | Values | Default | Description |
|---|---|---|---|
--format | json, markdown, html | json | Output format |
-n, --notebook ID | Notebook ID | active context | Specify notebook |
-a, --artifact ID | Artifact ID | latest | Select specific flashcard artifact |
- JSON — Structured data with
front/backfields (normalized from APIf/b) - Markdown — Human-readable cards in a readable list format
- HTML — Raw HTML as returned from NotebookLM
Batch download examples
You can download multiple artifacts at once using--all and preview the results first with --dry-run.