Firefox Bookmark Manager

Because somehow you ended up with 2000 bookmarks and you're pretty sure half of them are dead links from 2015.

What This Does

• Analyze - See just how deep your bookmark rabbit hole goes
• Check - Find out which of your bookmarks lead to the void (404s, timeouts, SSL disasters)
• Reorganize - Unfuck your folder structure (programmatically!)

Built by someone who had 7 levels of nested folders and needed an intervention.

Install

git clone https://github.com/willc/firefox-bookmark-manager.git
cd firefox-bookmark-manager
pip install -r requirements.txt

Or if you want to install it properly:

pip install -e .

How To Use This Thing

First, get your bookmarks out of Firefox:

1. Bookmarks → Manage Bookmarks (Ctrl+Shift+O)
2. Import and Backup → Backup
3. Save it somewhere as bookmarks.json

See what you're working with

python -m bookmark_manager.cli analyze bookmarks.json

This'll show you:

• How many bookmarks you've hoarded
• Which domains you bookmark the most (probably GitHub)
• Your folder structure (including that embarrassing 7-level deep pentest folder)
• How badly you need help

Find the dead ones

python -m bookmark_manager.cli check bookmarks.json

Goes through every bookmark and tries to load it. Outputs:

• Which ones are dead (404, connection failed, etc.)
• A detailed report saved to bookmarks_dead_links.txt
• A success rate that will probably make you sad

Options:

• --workers N - How many to check at once (default: 10, don't go crazy)
• --timeout N - How long to wait before giving up (default: 10 seconds)

Reorganize everything

python -m bookmark_manager.cli reorganize bookmarks.json output.json --config reorganize_config.json

See examples/reorganize_config.json for how to configure this. Or write your own script - this is Python, do whatever you want.

Putting the clean bookmarks back

1. Firefox → Bookmarks → Manage Bookmarks
2. Import and Backup → Restore → Choose File
3. Pick your shiny new bookmarks file

WARNING: This nukes your current bookmarks and replaces them. Export a backup first unless you enjoy chaos.

Requirements

• Python 3.7+ (if you're still on 2.7, we need to talk)
• requests library (for actually checking if URLs work)

License

MIT - do whatever, just don't blame me if it breaks something

Credits

Made by @willc after realizing he had bookmarks from the Bush administration