poli0981andClaude Opus 5.5 76a57fb739 docs: GO for Firefox and Edge as v1.3; the roadmap under maintenance mode
Recorded now rather than with the port, because the maintenance
announcement names it (docs/15, docs/00 §7). Settled with the owner: gecko
id bookmarkmagic@poli0981.dev, desktop only (Firefox for Android has no
bookmarks API), MV3 everywhere, and Firefox separators shown, protected and
warned about rather than stored in a file format.

The roadmap is pruned to what MAINTENANCE.md allows: scheduled snapshots
need the alarms permission and leave it; the permission rule joins the never
list; the fflate zip export, the duplicate auto-merge assistant and
bookmarklet notes are not planned; the old v1.3 "resilience" becomes v1.4.

MAINTENANCE.md no longer lists "a dependency advisory" as a release trigger
on its own: with no runtime dependencies, an advisory against the build
tools needs a release only if it changed what ships.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-18 21:03:47 +07:00
2026-11-10 11:18:58 +07:00
2026-07-25 19:21:07 +07:00

BookmarkMagic

Status: maintenance mode License: GPL-3.0-or-later CI CodeQL Qodana Quality gate Coverage Chrome Web Store Runtime dependencies: 0

Move your bookmarks between browsers the simple way: with a file. No account, no cloud sync, 100% offline.

A Chrome (MV3) extension for importing, exporting and editing bookmarks and folder trees. English · Tiếng Việt · 日本語 · 简体中文 · Română.

Project status

Maintenance mode since 2026-11-18 — see MAINTENANCE.md. Bug, UI/UX, accessibility and translation fixes, dependency and security updates, and features already on the roadmap still land; requests for new features beyond that are closed automatically. Ideas are welcome in Discussions › Ideas.

Screenshots

Import Edit
The import tab's drop zone, listing the formats it reads The edit tree: folders with counts, bookmarks with their domains, toolbar with search, new folder, sort and duplicates
Export Settings
The export tab: folder picker on the left, format cards on the right Settings: language, theme, and four defaults

Taken with neutral sample data by node scripts/screenshots.mjs --shoot, never from anyone's real profile.

What it does

  • Import HTML, CSV and JSON bookmark files — including Chrome's own Bookmarks file from the profile folder and Firefox's JSON backups, the copies you have when a browser will not start. A full preview comes first: counts, folders, depth, duplicates and warnings before anything is written.
  • Choose how: into a new dated folder (the safe default), merged into the folders you already have (reused, not copied), or replacing everything. Replace tells you exactly what it will delete, saves a JSON safety backup first, and deletes nothing until that backup is proven — and restoring that backup puts the Bookmarks bar, Other and Mobile bookmarks back where they were.
  • Export everything, or just the folders you pick, to HTML (Chrome, Edge, Brave, Firefox, Safari, Vivaldi, Opera), JSON, CSV or Markdown.
  • Edit the tree: search, rename, drag to move or reorder, sort a folder A→Z, create folders, delete, and find duplicate links — every action reachable from the keyboard.

Accessibility

Everything works without a mouse, a screen reader is told what is on screen and what an import did, contrast themes and reduced motion are respected, and the page declares the language you chose. The goal is WCAG 2.2 AA; it is a goal, not a claim — nobody has audited it.

ACCESSIBILITY.md has the detail: the keys, what was tested and with which screen reader, what is known not to work well yet, and how to report a barrier.

Privacy

This is the whole point of the project, so it is worth being precise.

  • No network access at all. Not analytics, not telemetry, not update pings. There is no server, and the code makes no network calls. The browser backs that up: the extension's content security policy makes Chrome refuse fetch, XHR, WebSocket, EventSource and beacon requests, and remote images, fonts, media and frames. On top of that, npm run check:manifest scans the shipped bundle for network APIs (WebRTC included, which no CSP directive covers) and npm run guard scans the source.
  • Exactly two permissions: bookmarks and storage. No host permissions, no content scripts, no background worker. Two gates enforce it: a unit test over wxt.config.ts, and npm run check:manifest, which CI runs against the built manifest.json — because a build can add what the config never asked for.
  • Zero runtime dependencies. Nothing is installed at runtime; the only third-party code in the package is what the build compiles in — the Svelte runtime with its clsx helper and WXT's one-line browser shim, all MIT (legal/THIRD_PARTY_NOTICES.md). The build fails if anything else would ship.
  • A short diagnostics log (error codes and counts, never titles or addresses) lives in memory while a tab is open, so you can copy it into a bug report. It never leaves your computer unless you paste it somewhere.
  • Settings use chrome.storage.local, never storage.sync, so even your preferences stay off any vendor cloud.

Full policy: legal/PRIVACY.md.

Honest limitations

  • Favicons cannot be imported — the bookmarks API has no favicon field.
  • Imported bookmarks get today's date. Chrome does not let an extension set a bookmark's original creation date. Your exported files keep the real ones.
  • CSV is a flattened view: empty folders and "which folder is the toolbar" are not preserved. Use HTML or JSON for a faithful backup.
  • Markdown is share-only — BookmarkMagic cannot read it back.

Install

From the Chrome Web Store: here

Requires Chrome 136 or later (April 2025), or any Chromium browser of the same vintage — Edge, Brave, Vivaldi, Opera. On an older browser the store keeps the version you already have and simply stops updating it.

From source (Node.js 26):

npm ci && npm run build

Then load .output/chrome-mv3/ at chrome://extensions with Developer mode on.

Development

npm run dev

npm run verify is the gate everything else answers to — lint, type-check (svelte-check on the TypeScript 6 API, then tsc 7), knip, the grep gate, the licence gate and the test suite, in that order. It must be green before every commit; npm run verify:full adds coverage, the build and the built-manifest check, and must be green before anything release-bearing.

node scripts/screenshots.mjs serves the built extension with sample bookmarks and a fake chrome, for looking at every page without loading the extension (--shoot also captures the store screenshots).

The docs/ directory is the binding specification, not notes: where code and docs disagree, the docs win. Start with CLAUDE.md, then docs/00–docs/02.

Contributing

Bug reports and translation fixes are welcome — the issue forms ask for what is needed, and none of them requires you to write code. The project is in maintenance mode, so a request for a feature that is not on the roadmap is closed automatically (MAINTENANCE.md).

If a bookmark file will not import, that is the most useful report there is, because the sample becomes a permanent test. Sanitize it first:

node scripts/sanitize-bookmarks.mjs your-bookmarks.html

That strips every address and title but keeps the structure, encoding and timestamps a parser bug depends on — so the sanitized file still reproduces the problem without handing over your browsing history.

CONTRIBUTING.md has the rest: the setup, the rules that are not negotiable, and how a reported file becomes a regression test.

Security issues: please follow SECURITY.md rather than opening a public issue.

Contact

For Write to
Security vulnerabilities (if you have no GitHub account) security@poli0981.dev
Privacy questions, removing a sample you sent privacy@poli0981.dev
An accessibility barrier (if you have no GitHub account) accessibility@poli0981.dev
The terms (EULA, disclaimer) legal@poli0981.dev
Licensing and permission questions copyright@poli0981.dev
Formal copyright (DMCA) notices dmca@poli0981.dev
A copy or listing pretending to be BookmarkMagic takedown@poli0981.dev
Contributing and code of conduct code@poli0981.dev
Sponsorship · collaboration · press sponsor@ · collab@ · press@poli0981.dev

Bugs are best as issues and ideas as Discussions — they help the next person too. The extension itself never shows or uses any of these addresses.

Support development

Entirely optional — BookmarkMagic is free software either way.

GitHub Sponsors · Ko-fi · Buy Me a Coffee · Patreon · PayPal

Licence

Copyright © 2026 skullmute (poli0981). GPL-3.0-or-later. Also see legal/EULA.md, legal/DISCLAIMER.md and legal/THIRD_PARTY_NOTICES.md. Licensing questions: copyright@poli0981.dev.

The BookmarkMagic name and icon identify this project. The GPL lets anyone fork the code; it does not let a fork present itself as this project.

Not affiliated with or endorsed by Google, Chrome, Mozilla, Firefox or any browser vendor. Browser names are trademarks of their respective owners.

S
Description
No description provided
Readme GPL-3.0
3 MiB
0 Stars 1 Watchers 0 Forks
Languages
TypeScript 75.8%
Svelte 14.5%
JavaScript 9.2%
CSS 0.4%