kindle-zotero_importer/plugin
Utku Bilen Demir 4342b284ee Kanzi 0.6.15: robust unification (DOI/ISBN + normalised hash)
- src/kindle_zotero_importer/zotero_index.py already has DOI/ISBN, now import_plan.py passes doi/isbn/issn/publication_title to final_plan
- src/kindle_zotero_importer/final_plan.py: _normalise() + _hash_norm() (NFKC lower, de-hyphenate, strip punct, SHA256:16) and store doi/isbn/issn/publication_title/norm_hash per annotation for cross-library grouping
- plugin/manager.html: anonData now sends doi/isbn/issn/publication_title/norm_hash alongside citation_key/hash/colour for private aggregation
- vis ~/annotation/app.py: store new columns, migrate old DB, /common groups by COALESCE(doi,isbn,citation_key)+norm_hash, dashboard shows Recent with DOI/norm and Top + Common tables
- Bump to 0.6.15
2026-09-23 15:59:28 +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.15: robust unification (DOI/ISBN + normalised hash) 2026-09-23 15:59:28 +02:00
manifest.json Kanzi 0.6.15: robust unification (DOI/ISBN + normalised hash) 2026-09-23 15:59:28 +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.*.