Skip to content

docs: troubleshooting now references Chrome (not Chromium), add Windows kill cmd #39

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
chewinggum604-art wants to merge 1 commit into
base: master
Choose a base branch
from
Open

docs: troubleshooting now references Chrome (not Chromium), add Windows kill cmd #39

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 9 additions & 7 deletions references/troubleshooting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -79,10 +79,12 @@ TimeoutError: Waiting for selector failed

**Solution:**
```bash
# Kill hanging processes
pkill -f chromium
# Kill hanging processes (Linux/Mac)
pkill -f chrome

# Kill hanging processes (Windows)
taskkill /F /IM chrome.exe

# Clean browser state
python scripts/run.py cleanup_manager.py --confirm --preserve-library

Expand All @@ -93,14 +95,14 @@ python scripts/run.py auth_manager.py reauth
#### Browser not found error
**Solution:**
```bash
# Install Chromium via run.py (automatic)
# Install Chrome via run.py (automatic)
python scripts/run.py auth_manager.py status
# run.py will install Chromium automatically
# run.py will install Chrome automatically

# Or manual install if needed
cd ~/.claude/skills/notebooklm
source .venv/bin/activate
python -m patchright install chromium
python -m patchright install chrome
```

### Rate Limiting
Expand Down Expand Up @@ -276,7 +278,7 @@ except Exception as e:
```bash
#!/bin/bash
# Kill processes
pkill -f chromium
pkill -f chrome

# Backup library if exists
if [ -f ~/.claude/skills/notebooklm/data/library.json ]; then
Expand Down Expand Up @@ -323,7 +325,7 @@ python scripts/run.py auth_manager.py status
### Browser Errors
| Error | Cause | Solution |
|-------|-------|----------|
| Browser not found | Chromium missing | Use run.py (auto-installs) |
| Browser not found | Chrome missing | Use run.py (auto-installs) |
| Connection refused | Browser crashed | Kill processes, restart |
| Timeout waiting | Page slow | Increase timeout |
| Context closed | Browser terminated | Check logs for crashes |
Expand Down