KindleStoryGraph v0.1.0

KindleStoryGraph v0.1.0

First release — StoryGraph sync for the native Kindle reader (jailbroken).

Synchronizes reading progress and reading status (currently reading / finished)
from the Kindle content catalog (cc.db) to The StoryGraph, without switching
reader apps.

Features

• cc.db reader — reads progress + status from the Kindle content catalog.
• StoryGraph sync — F1-scored title matching, status + progress updates over
  the same web-API layer as NickelStoryGraph.
• Opt-in allowlist (default) — select which books sync from the KUAL menu;
  sync_scope=all in config.ini syncs every book instead.
• Minimum-progress threshold (default 2 %) — ignores the Kindle's first-open
  jump to ~1 %.
• Manual mapping (manual_mappings.ini) — pin cde_key → StoryGraph id for
  titles the search can't identify.
• Diff-based sync — only progress changes are pushed, throttled per book.
• Manual ("Sync now") or daemon (15-min polling) operation.
• Static armhf (musl) binary + KUAL Next extension packaging.

Requirements

• Jailbroken Kindle (Véra), firmware 5.16.3+ (developed and tested on 5.20.1,
  Kindle Basic 2024).
• KUAL Next (or KUALA) launcher — classic KUAL is broken on firmware 5.19.4+.
• StoryGraph session cookies (StoryGraph has no public API).

Install

Copy extensions/kindlestorygraph/ to the Kindle and follow
docs/install.md (English) or docs/install.de.md (German).

Credits

This project builds on prior community reverse engineering: NickelStoryGraph,
zevisvei/kindle-reading-dashboard, kaikozlov/kindle.koplugin, KindleModding
(Véra, Hotfix, KUAL Next, MRPI, KPM), and others — see README.md for the full
list.

Developed with AI assistance under human review — see README.md.

---

Originally released on Codeberg on 2026-10-18.