Skip to content

troubleshooting.md

Latest commit

 

History

History
executable file
·
59 lines (46 loc) · 2.31 KB

troubleshooting.md

File metadata and controls

executable file
·
59 lines (46 loc) · 2.31 KB

Troubleshooting

Fresh start / Deep cleanup

If you're experiencing persistent issues, corrupted data, or want to start completely fresh:

⚠️ CRITICAL: Close ALL Chrome/Chromium instances before cleanup! Open browsers can prevent cleanup and cause issues.

Recommended workflow:

  1. Close all Chrome/Chromium windows and instances
  2. Ask: "Run NotebookLM cleanup and preserve my library"
  3. Review the preview - you'll see exactly what will be deleted
  4. Confirm deletion
  5. Re-authenticate: "Open NotebookLM auth setup"

What gets cleaned:

  • Browser data, cache, Chrome profiles
  • Temporary files and logs
  • Old installation data
  • Preserved: Your notebook library (when using preserve option)

Useful for:

  • Authentication problems
  • Browser session conflicts
  • Corrupted browser profiles
  • Clean reinstalls
  • Switching between accounts

Browser closed / newPage errors

  • Symptom: browserContext.newPage: Target page/context/browser has been closed.
  • Fix: The server auto‑recovers (recreates context and page). Re‑run the tool.

Profile lock / ProcessSingleton errors

  • Cause: Another Chrome is using the base profile.
  • Fix: NOTEBOOK_PROFILE_STRATEGY=auto (default) falls back to isolated per‑instance profiles; or set isolated.

Authentication issues

Quick fix: Ask the agent to repair authentication; it will run get_health → setup_auth → get_health.

For persistent auth failures:

  1. Close ALL Chrome/Chromium instances
  2. Ask: "Run NotebookLM cleanup with library preservation"
  3. After cleanup completes, ask: "Open NotebookLM auth setup"
  4. This creates a completely fresh browser session while keeping your notebooks

Auto-login (optional):

  • Set AUTO_LOGIN_ENABLED=true with LOGIN_EMAIL, LOGIN_PASSWORD environment variables
  • For automation workflows only

Typing speed too slow/fast

  • Adjust TYPING_WPM_MIN/MAX; or disable stealth typing by setting STEALTH_ENABLED=false.

Rate limit reached

  • Symptom: "NotebookLM rate limit reached (50 queries/day for free accounts)".
  • Fix: Use re_auth tool to switch to a different Google account, or wait until tomorrow.
  • Upgrade: Google AI Pro/Ultra gives 5x higher limits.

No notebooks found

  • Ask to add the NotebookLM link you need.
  • Ask to list the stored notebooks, then choose the one to activate.