NotebookLM SuperSkill

Generate slides, podcasts, infographics, and videos from NotebookLM notebooks using browser automation.

Features

• Slide Decks - Generate presentations for different audiences (technical, investor, customer, executive, beginner)
• Audio Overviews - Create AI podcast-style discussions in 80+ languages
• Infographics - Visual summaries in multiple orientations
• Video Overviews - Explainer videos with customizable themes

Installation

As a Claude Code Skill

1. Clone this repo to your skills directory:

git clone https://github.com/ainergiz/notebooklm-superskill.git ~/.claude/skills/notebooklm-superskill

2. Restart Claude Code to load the skill.

Standalone Usage

1. Clone the repository:

git clone https://github.com/ainergiz/notebooklm-superskill.git
cd notebooklm-superskill

2. Run any script (virtual environment is set up automatically):

python scripts/run.py auth_manager.py setup

Quick Start

1. Authenticate (One-Time)

python scripts/run.py auth_manager.py setup

A browser window opens. Log in to your Google account. The session is saved for future use.

2. Generate Content

# Slides
python scripts/run.py generate_slides.py --notebook-url URL --audience technical

# Audio podcast
python scripts/run.py generate_audio.py --notebook-url URL --format deep-dive

# Infographic
python scripts/run.py generate_infographic.py --notebook-url URL --orientation landscape

# Video
python scripts/run.py generate_video.py --notebook-url URL --format explainer

Options Reference

Slide Generation

Option	Values	Default
--audience	technical, investor, customer, executive, beginner	technical
--audiences	comma-separated list	-
--format	detailed, presenter	detailed
--length	short, default, long	default
--source	file path	-
--prompt	custom text	-

Audio Generation

Option	Values	Default
--format	deep-dive, brief, critique, debate	deep-dive
--language	en-US, es-ES, fr-FR, etc.	en-US
--prompt	custom text	-

Infographic Generation

Option	Values	Default
--orientation	square, portrait, landscape	landscape
--detail	concise, standard, detailed	standard
--prompt	custom text	-

Video Generation

Option	Values	Default
--format	brief, explainer	brief
--theme	retro-90s, futuristic, corporate, minimal	corporate
--custom-theme	custom description	-
--prompt	custom text	-

Common Options

All scripts support:

• --output DIR - Output directory
• --headless - Run without visible browser
• --help - Show help

Architecture

notebooklm-superskill/
├── SKILL.md              # Claude Code skill file
├── scripts/
│   ├── run.py            # Universal wrapper (handles venv)
│   ├── auth_manager.py   # Authentication
│   ├── generate_slides.py
│   ├── generate_audio.py
│   ├── generate_infographic.py
│   └── generate_video.py
└── data/                 # Runtime data (gitignored)
    └── browser_state/    # Cookies, profile

How It Works

1. Browser Automation - Uses Patchright (Playwright fork) with real Chrome for reliability
2. Anti-Detection - Persistent browser profile, cookie injection, human-like interactions
3. Artifact Monitoring - Detects generation completion via shimmer animation detection
4. Download Handling - Captures downloads via Playwright's download handler

Requirements

• Python 3.8+
• Google account with NotebookLM access
• Chrome browser (installed automatically by Patchright)

Troubleshooting

Authentication Expired

python scripts/run.py auth_manager.py reauth

Timeout During Generation

Audio and video generation can take 5-15 minutes. The scripts have built-in timeouts:

• Slides/Infographics: 3 minutes
• Audio: 10 minutes
• Video: 15 minutes

Browser Issues

# Reinstall Chrome for Patchright
python -m patchright install chrome

License

MIT