Grimmory KOReader Client v2.0.0

Grimmory KOReader Client v2.0.0

First public Grimmory-native release, published on 12 August 2026. Both plugin
archives are versioned and released together; install both for the complete
client.

Downloads

• grimmory.koplugin-2.0.0.tar.gz — library browsing, downloads, accounts,
  connection tools, and updates
• grimmory_sync.koplugin-2.0.0.tar.gz — reading progress, EPUB annotations,
  reading sessions, and shelf collection sync
• manifest.json — checksums and metadata used by the in-app updater

Do not use GitHub's automatically generated source-code archives as KOReader
plugins. See the installation guide
for clean-install and legacy BookLore replacement instructions.

Highlights

• Renamed the two plugins and their settings, caches, queues, updater staging,
  artifacts, and user agents to Grimmory conventions.
• Added canonical Grimmory Book/BookFile normalization, paginated library
  traversal, corrected sorting and filtering, exact primary/alternative file
  selection, and downloads.
• Moved progress to Grimmory's App progress API and selected-file identity, with
  EPUB XPointer/CFI conversion, exact PDF/CBX pages, and percentage-based
  FB2/MOBI/AZW3 progress.
• Added opt-in conflict-safe EPUB highlight/note sync, durable reading-session
  sync, and additive shelf mirroring into scoped KOReader collections.
• Added the Connection & Sync panel with explicit connection attempts, sync
  settings, device/server positions, and a pending-book badge.
• Made queued progress account-, server-, book-, and file-aware; background
  bulk sync pulls before pushing so newer server progress remains a conflict.
• Hardened downloads, logging, Tailscale installation, and the paired-plugin
  updater with checksums, safe archive validation, backups, rollback, and
  interruption recovery.
• Added locked and pinned CI dependencies plus Lua, JavaScript, Python, visual,
  packaging, release-validation, and real-device/real-server acceptance gates.
• Replaced external service artwork with original generic icons and documented
  security, contribution, provenance, compatibility, and privacy boundaries.

The tested reproducibility baseline is Grimmory v3.3.1. Newer Grimmory releases
may work, but should be validated against the compatibility suite before being
declared supported.

This is intentionally a clean install. Historical v1.0.0 BookLore plugin data
and settings are not migrated in place.

For the complete itemized history, see the changelog.