kindle-zotero_importer/plugin
Utku Bilen Demir 935bc049ce Kanzi 0.6.7: bracket colours [r]=grey + editable Settings
- src/kindle_zotero_importer/import_plan.py: add DEFAULT_COLOUR_MAP with grey->[r] per request (y/o/r/grey/gray/red/g/b/p/m etc.), _extract_colour() strips leading [code] and maps to hex, _annotation_stub() uses it, build_import_plan() accepts colour_map
- src/kindle_zotero_importer/cli.py: _load_colour_map() from workdir/colour-map.json or plugin-config.json colourMap, passed to build_import_plan (incremental + full)
- plugin/bootstrap.js: saveSettingsFromManager() persists colourMap to plugin-config.json + colour-map.json, getRuntimeSettings() loads it, loadColourMap() helper, label Kanzi
- plugin/manager.html: Settings → Highlight colours editor (table bracket→hex with colour picker, preview, +Add, Reset, grey=[r] note, example [o] orange), saveSettings() collects colourMap, init uses F tokens
- plugin/manifest.json: name Kanzi, 0.6.6→0.6.7, description Kindle annotations to Zotero
- README.md: Kanzi title, Tools → Kanzi…, colours tip with British spelling
- updates.json: add 0.6.7 on top
2026-09-22 15:19:27 +02:00
..
bootstrap.js Kanzi 0.6.7: bracket colours [r]=grey + editable Settings 2026-09-22 15:19:27 +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.7: bracket colours [r]=grey + editable Settings 2026-09-22 15:19:27 +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.*.