Turn long documents into smaller, heading-aware NotebookLM sources so reports, slide decks, quizzes, flashcards, and audio outputs stay more focused and useful.
Two interfaces, one core. The Desktop app provides a visual workflow. The CLI provides scriptable automation. Both use the same
nblmengine underneath.
- This page covers the Desktop app
- CLI.md covers the Python CLI
An Electron desktop client that wraps the nblm CLI into a full visual workflow — from PDF upload to NotebookLM Studio generation.
Set min and max pages per chunk, skip pages from the beginning (preface, TOC) or end (index, bibliography), and see the estimated chunk count before processing. The chunker splits at heading boundaries to keep each source semantically coherent.
Review, search, and edit generated chunks inline. Bulk select and delete, or refine titles and content before syncing.
Browse all your NotebookLM notebooks in one place. Open a workspace to see synced sources, manage studio jobs, and track outputs.
Inspect synced sources for any notebook. Select sources individually or in bulk to build studio queue batches.
Queue reports, slides, quizzes, flashcards, or audio jobs across sources. Filter by studio type, search by name or status. Retry failed jobs individually or in bulk — quota exhaustion is automatically detected.
Configure per-studio defaults: language (80+ languages), format, download format, and parallel request limits. Sync settings control parallel chunk uploads.
| Feature | Description |
|---|---|
| Bulk source upload | Upload dozens or hundreds of chunks to a single notebook in one operation with parallel processing |
| Bulk source delete | Select and delete multiple chunks at once from the catalog |
| Resume interrupted uploads | Sync tracks per-chunk status — come back tomorrow and only the remaining chunks get uploaded |
| Prompt library | Save reusable prompts per studio type and apply them from the queue builder |
| Skip pages | Exclude preface, table of contents, index, or bibliography pages before chunking |
| Versioned lineages | Multiple chunk versions of the same PDF, each with independent sync and studio state |
| Offline-first | Chunk and edit locally without a network connection — sync when ready |
- Install the Python CLI (needed by the desktop app):
pip install notebooklm-chunker
python -m playwright install chromium- Login to NotebookLM:
nblm loginDownload the latest release for your platform from GitHub Releases:
- macOS:
.dmgor.zip - Windows:
.exe(installer) or portable - Linux:
.AppImageor.deb
The desktop app expects nblm to be available on your system PATH.
cd desktop
npm install
npm run devOn first launch, the app verifies:
nblmis available on PATH- Playwright Chromium is installed
- NotebookLM auth state is ready
You can continue into the app for local-only work even if auth is not ready yet.
Platform-specific builds:
cd desktop
npm run build:mac # macOS (.dmg, .zip)
npm run build:win # Windows (.exe, portable)
npm run build:linux # Linux (.AppImage, .deb)The Python CLI is the automation engine. It handles document parsing, heading-aware chunking, NotebookLM uploads, and Studio generation.
For full CLI documentation, installation, config examples, and usage:
Quick start:
pip install notebooklm-chunker
python -m playwright install chromium
nblm login
nblm run --config ./nblm.tomlFor setup, testing, packaging, and GitHub release flow, see DEVELOPMENT.md.
MIT