Bookmark Navigator is a Firefox extension that helps you navigate through curated lists of bookmarks.
Bert van der Weerd a411ee8945 Rename special folder from $nw to $bn
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>
2025-12-04 22:59:21 +01:00
icons initial 2025-12-04 22:36:25 +01:00
popup Rename special folder from $nw to $bn 2025-12-04 22:59:21 +01:00
.gitignore added .gitignore 2025-12-04 22:44:15 +01:00
CLAUDE.md Rename special folder from $nw to $bn 2025-12-04 22:59:21 +01:00
LICENSE initial 2025-12-04 22:36:25 +01:00
manifest.json initial 2025-12-04 22:36:25 +01:00
README.md Rename special folder from $nw to $bn 2025-12-04 22:59:21 +01:00

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):

  1. Open Firefox and navigate to about:debugging
  2. Click "This Firefox" in the left sidebar
  3. Click "Load Temporary Add-on"
  4. 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

  1. Open Firefox Bookmarks Manager (Ctrl+Shift+O or Cmd+Shift+O)
  2. Create a new folder named exactly $bn
  3. Inside $bn, create subfolders - each represents a different bookmark list:
    • News Sites
    • Tech Blogs
    • Daily Reading
    • etc.
  4. 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

  1. Click the toolbar icon (bookmark symbol) to open the popup
  2. Select a list from the dropdown menu
  3. Navigate using the prev/next buttons
  4. 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:

  1. Go to about:debugging
  2. Find "Bookmark Navigator"
  3. 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 $bn folder in your Firefox bookmarks with subfolders containing bookmarks