/notebook-lm-extension

Primary LanguageJavaScript

NotebookLM Audio Overview Extension

A cross-browser extension that automatically creates NotebookLM audio overviews for any webpage with a single click.

Features

  • 🤖 Fully Automated: Creates notebook, adds webpage source, and starts audio generation
  • 📄 Extract main content from any webpage intelligently
  • 🔗 Automatically adds webpage as URL source in NotebookLM
  • 🎵 Triggers audio overview generation automatically
  • 💾 Backup content download option
  • 🌐 Cross-browser compatibility (Chrome & Firefox)
  • 📁 Right-click context menu integration

Installation

Chrome/Chromium

  1. Open Chrome and navigate to chrome://extensions/
  2. Enable "Developer mode" in the top right
  3. Click "Load unpacked" and select this extension directory
  4. The extension icon will appear in your toolbar

Firefox

  1. Open Firefox and navigate to about:debugging
  2. Click "This Firefox" in the sidebar
  3. Click "Load Temporary Add-on"
  4. Select the manifest.json file in this directory
  5. The extension will be loaded temporarily

Usage

Method 1: Extension Popup (Recommended)

  1. Navigate to any webpage you want to create an audio overview for
  2. Click the NotebookLM extension icon in your browser toolbar
  3. Click "Generate Audio Overview"
  4. Automation starts automatically:
    • NotebookLM opens in a new tab
    • Creates a new notebook
    • Adds the webpage as a URL source
    • Starts audio overview generation
  5. Switch to the NotebookLM tab to monitor progress
  6. Your audio overview will be ready when processing completes!

Method 2: Context Menu

  1. Right-click anywhere on a webpage
  2. Select "Generate NotebookLM Audio Overview" from the context menu
  3. Same automation process runs automatically

How It Works

  1. Content Extraction: Intelligently extracts main content from the webpage, filtering out navigation, ads, and other non-essential elements
  2. NotebookLM Automation:
    • Opens NotebookLM in a new tab
    • Waits for page to load completely
    • Creates a new notebook automatically
    • Adds the original webpage URL as a source
    • Triggers audio overview generation
  3. Fallback Options: Provides content download as backup if automation encounters issues

File Structure

├── manifest.json              # Extension configuration
├── content.js                 # Content script for page extraction
├── background.js              # Background service worker with automation
├── notebooklm-automation.js   # NotebookLM automation script
├── popup.html                 # Extension popup interface
├── popup.js                   # Popup functionality
├── icons/                     # Extension icons
│   ├── icon.svg              # Source SVG icon
│   ├── icon16.png            # 16x16 toolbar icon
│   ├── icon32.png            # 32x32 extension icon
│   ├── icon48.png            # 48x48 extension icon
│   ├── icon128.png           # 128x128 store icon
│   └── README.md             # Icon requirements
└── README.md                  # This file

Permissions Explained

  • activeTab: Access the current tab's content for extraction
  • scripting: Inject content scripts for extraction and automation
  • downloads: Allow downloading extracted content as backup
  • storage: Store temporary automation data
  • contextMenus: Add right-click menu option
  • tabs: Monitor tab loading for automation timing
  • https://notebooklm.google.com/*: Access NotebookLM for automation

Development

To modify the extension:

  1. Make your changes to the source files
  2. Reload the extension in your browser's extension management page
  3. Test the changes on various websites

Limitations

  • Interface Dependencies: Automation relies on NotebookLM's current interface structure
  • Authentication Required: Must be logged into Google account with NotebookLM access
  • Content Extraction: Some websites may have content extraction limitations due to dynamic loading
  • Browser Security: Cannot directly upload files due to security restrictions, uses URL sources instead
  • Rate Limits: Subject to NotebookLM's usage limits and quotas

Troubleshooting

  • Automation Fails: Check browser console for errors, try reloading the extension
  • Content Not Extracted: Some sites block content extraction, try the backup download option
  • NotebookLM Not Loading: Ensure you're logged into your Google account
  • Audio Generation Doesn't Start: May require manual trigger if interface changes

Contributing

Feel free to submit issues and enhancement requests!