kindle-zotero_importer/plugin
Utku Bilen Demir 9a08cbbfc4 Kanzi 0.6.9: incremental recolours past highlights
- src/kindle_zotero_importer/cli.py: incremental now re-queues past highlights whose bracket colour changed ([r] on note etc.) and when colourMap in Settings changes (stores colourMap in final_plan for comparison)
- plugin/bootstrap.js: writeAnnotations now updates colour for existing annotations (so Full and incremental recolours work, not just new)
- Bump to 0.6.9 for auto-update
2026-09-22 19:44:13 +02:00
..
bootstrap.js Kanzi 0.6.9: incremental recolours past highlights 2026-09-22 19:44:13 +02:00
manager.html Kanzi 0.6.7: bracket colours [r]=grey + editable Settings 2026-09-22 15:19:27 +02:00
manifest.json Kanzi 0.6.9: incremental recolours past highlights 2026-09-22 19:44:13 +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.*.