kindle-zotero_importer/plugin
Utku Bilen Demir 11bd31020e British English + remove annotation URL parenthetical, private collector
- README.md: Anonymised (was Anonymized), Share anonymised (was anonymized, remove also annotation.utkubilen.de, private, no AI), Settings line private hashed only
- plugin/manager.html: anonymised sharing British, colour
- annotation.utkubilen.de DNS A added -> [REDACTED_IP], certbot SSL deployed, https://annotation.utkubilen.de/health ok
2026-09-23 11:17:49 +02:00
..
bootstrap.js Kanzi 0.6.9: incremental recolours past highlights 2026-09-22 19:44:13 +02:00
manager.html British English + remove annotation URL parenthetical, private collector 2026-09-23 11:17:49 +02:00
manifest.json Kanzi 0.6.12: readme restructure per request 2026-09-23 11:03:20 +02:00
prefs.js privacy: anonymized sharing on by default with opt-out, mention in README 2026-09-19 18:06:06 +02:00
README.md 0.6.4: incremental id-based import, Mappings/Integrated, black iA Duo, resizable tables 2026-09-16 14:44:31 +02:00

Kindle Zotero Importer Zotero Plugin

This is a hybrid Zotero plugin wrapper around the current Python importer. Zotero owns the user interface and writes native annotations through Zotero APIs; the Python project still performs parsing, matching, planning, EPUB positioning, and PDF positioning.

Use

  1. Install kindle-zotero-importer.xpi in Zotero through Tools > Plugins.
  2. Open Tools > Kindle Zotero Importer....
  3. Select the updated Kindle My Clippings.txt in the manager.
  4. Follow the current stage, percentage, and elapsed time in the manager.
  5. Review created, existing, updated, failed, and unresolved counts when it completes.

The plugin uses match-overrides.json from the project directory as the persistent source of title mappings and ignored titles. Generated JSON artifacts are still written to the project directory for audit and debugging.

Build XPI

From the repository root:

python scripts/build_plugin.py

The output is dist/kindle-zotero-importer.xpi.

The plugin manifest targets Zotero 6.999 through 10.0.*.