A home that knows your habits.
Continue where you left off, see your streak, glance at what just landed in the library. Built from real reading-session data — not just file metadata.
Made for KOReader users who actually read.
Most library servers stop at file management. Tome connects to your e-reader, records every reading session, syncs positions both ways, and turns it into stats that get sharper the more you read.
Toggle theme in the header at any time · click any screenshot below to zoom.
Continue where you left off, see your streak, glance at what just landed in the library. Built from real reading-session data — not just file metadata.
Other tools document how to set up KOSync. Tome ships a plugin pre-configured with your server URL and a fresh API key — no manual entry, no account, no guessing.
.koplugin into KOReader's plugins folderTime on page, pages turned, device — every reading minute feeds your stats. Plain KOSync only syncs where you stopped.
Open the wrench menu, pick a series, hit "Download rest". Files arrive organised by book-type folder with proper filenames. No OPDS gymnastics.
Read on the couch in the browser, pick up on KOReader in bed, come back to the browser the next morning. Bidirectional. Offline-first — sessions queue and flush when you're back online.
KOSync identifies books by MD5 of the file — edit metadata, re-save, redownload and the sync history orphans. Tome resolves to a canonical book ID. Your reading history survives file changes.
Not using KOReader? Tome also serves an OPDS catalog for any reader that supports it.
Manga, light novels, multi-volume sagas — Tome groups volumes into arcs, tracks progress per book, and remembers which arc you finished. Status badges show ongoing vs completed.
Streaks, time-of-day heatmaps, reading pace, completion estimates. Every minute on your e-reader feeds back into actionable insight, not vanity metrics.
Link your Hardcover account and Tome keeps your public profile current — ratings (half-stars included), reading progress, finish dates. One-way and opt-in: Tome writes, never deletes.
If you haven't met Hardcover yet: it's the indie, community-run Goodreads alternative — ad-free, actively built in the open, with a proper public API. Exactly the kind of neighbour a self-hosted library wants.
Every cell is a day. Every shade is how much you read. Recognise your patterns — the weekend deep-dives, the late-night chapters, the dry spells.
Three themes built in — Light, Dark, Amber — plus custom palettes for the colour-coordinators. Click below to try one. (Your choice carries into the docs too.)
Tome ships as a PWA. Install it like a native app — sidebar nav, full-bleed reader, sync status in your pocket.
Several self-hosted ebook tools exist — here's where Tome sits.
Pick Calibre-Web for the largest ecosystem. Komga if you're comics-only. Kavita for a featureful all-rounder. Tome if reading-session tracking and KOReader integration are what you actually want.
One Docker image. SQLite under the hood. No external services required.
docker run -d \
--name tome \
--restart unless-stopped \
-p 8080:8080 \
-v ./data:/data \
-v ./books:/books \
-v ./bindery:/bindery \
ghcr.io/bndct-devops/tome:latest