poli0981andClaude Fable 5.2 d61318aed7 test(edit): cover the live-sync wiring that left EditTab
stores/edit-live.ts was untested — it is the block that used to sit in
EditTab's onMount, where nothing measured it. As a .ts module it counts, and
SonarCloud's new-code gate failed at 73.6 % (80 % required).

edit-live.test.ts drives it with wxt/browser mocked to hand-fired event
emitters and a hand-fired frame: one patch per frame, a parentless created
node ignored, nothing patched during Chrome's own import and one re-read
after it, a re-read on a wholesale reorder, and a teardown that detaches every
listener and drops what was queued. connectLive takes the batcher's scheduler
as an optional argument for that.

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

BookmarkMagic

License: GPL-3.0-or-later CI CodeQL 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ă.

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 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.

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 and feature ideas are best as issues — 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%