Change the bookmark folder name from $nw to $bn (Bookmark Navigator) to make the purpose more clear and avoid conflicts with other potential uses. Updated across popup.js, README.md, and CLAUDE.md. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> |
||
|---|---|---|
| icons | ||
| popup | ||
| .gitignore | ||
| CLAUDE.md | ||
| LICENSE | ||
| manifest.json | ||
| README.md | ||
Bookmark Navigator
A Firefox extension that helps you navigate through curated lists of bookmarks using prev/next controls.
What It Does
Bookmark Navigator turns your Firefox bookmarks into navigable sequences. Create a folder named $bn in your bookmarks, add subfolders inside it, and each subfolder becomes a different bookmark list you can cycle through - perfect for daily news sites, tech blogs, reading lists, or any collection of pages you visit regularly.
When you click the extension icon, you'll see a dropdown to select which list you want to use, and prev/next buttons to navigate through the bookmarks in that list. The middle shows the current page title as a clickable link. Everything navigates in your current tab, and the extension remembers your position across sessions.
Setup
1. Install the Extension
Temporary Installation (recommended for personal use):
- Open Firefox and navigate to
about:debugging - Click "This Firefox" in the left sidebar
- Click "Load Temporary Add-on"
- Navigate to this directory and select
manifest.json
The extension stays active until you restart Firefox. For permanent installation, you'll need to sign it through addons.mozilla.org or use Firefox Developer Edition with xpinstall.signatures.required set to false in about:config.
2. Create Your Bookmark Lists
- Open Firefox Bookmarks Manager (
Ctrl+Shift+OorCmd+Shift+O) - Create a new folder named exactly
$bn - Inside
$bn, create subfolders - each represents a different bookmark list:News SitesTech BlogsDaily Reading- etc.
- Add bookmarks to each subfolder
Example structure:
Firefox Bookmarks
└── $bn
├── News Sites
│ ├── BBC News
│ ├── The Guardian
│ └── Reuters
├── Tech Blogs
│ ├── Hacker News
│ └── Ars Technica
└── Daily Reading
├── Site 1
└── Site 2
Usage
- Click the toolbar icon (bookmark symbol) to open the popup
- Select a list from the dropdown menu
- Navigate using the prev/next buttons
- Click the title in the middle to reload the current bookmark
Navigation Behavior
- Circular navigation - wraps around at list boundaries (next on the last item goes to first, prev on first goes to last)
- Current page detection - if you're already on a page in the list, the extension shows its title
- Position memory - when you close and reopen the popup, you're right where you left off
- In-tab navigation - all navigation happens in your current tab
Features
- Multiple bookmark lists via subfolder organization
- Persistent state - remembers your current list and position
- Smart URL matching - recognizes when you're on a bookmarked page (ignores query params and trailing slashes)
- Minimal UI - clean, functional design
- Dark mode support - automatically adapts to system theme
- No external dependencies - pure vanilla JavaScript
Customization
Managing Bookmarks
Simply use Firefox's native bookmark manager to add, remove, or reorder bookmarks. After making changes, reload the extension:
- Go to
about:debugging - Find "Bookmark Navigator"
- Click "Reload"
Styling
Edit popup/popup.css to customize the appearance:
- Light and dark mode themes
- Colors and spacing
- Font styles
Requirements
- Firefox 109 or later (Manifest V3 support)
- A
$bnfolder in your Firefox bookmarks with subfolders containing bookmarks