Tome
Reference

Changelog

Release notes per version, newest first. Tome's release codenames follow a "synonyms for tome" theme — Codex, Grimoire, Atlas, Folio, and so on. The canonical source is CHANGELOG.md in the repo; this page mirrors it.

Reading time —

v1.0 — "Codex"

The first release that calls itself done. Stable schema, opinionated defaults, a coherent docs site. If you've been running Tome from main, this is where the floor stops moving.

Highlights

  • TomeSync KOReader plugin (v4): bidirectional position sync, reading-session tracking, in-plugin series browser, series download. Zero-config install — download the pre-baked .koplugin from Settings.
  • Web reader: EPUB (foliate-js) and CBZ (custom streaming) with themes, font controls, RTL toggle, spread mode, position memory via CFI.
  • Reading stats: three tabs (Overview / Habits / Library), 4-hour streak rollover, hour×DOW heatmap, period and monthly comparisons, completion estimates, per-book time, library growth.
  • Series & arcs: SeriesMeta status badge, admin Arc CRUD, series-wide progress aggregation, chapter vs volume detection for manga.
  • Roles & visibility: three-tier admin / member / guest model with server-enforced per-book visibility rules. Quick Connect for new devices.
  • Bindery: drop-folder ingestion with manual review (default) or auto-import on a timer. Content-hash dedup, filename-based series detection, metadata fetch from Hardcover / Google Books / Open Library.
  • Scribe (alpha): Claude Code skill for bulk ingest, metadata audits, and series-level annotation. Docs.
  • API tokens: universal-scope tome_* bearer tokens for every /api/* endpoint.
  • OPDS feed: standards-compliant Atom catalogue with per-user PINs.
  • Themes: light, dark, amber, plus user-defined 10-value palettes.
  • PWA: installable on iOS and Android with manifest + offline icons.

Stable surfaces

The following are considered stable as of 1.0 — backwards-incompatible changes will get a major-version bump:

  • The HTTP API at /api/*.
  • The OPDS feed at /opds/.
  • The TomeSync KOReader plugin protocol.
  • The environment variable names listed in Configuration.
  • The on-disk library layout (Series/ and Author/ folders).

Things still labelled alpha

  • Scribe command surface — syntax and config format may change.