Deploy Now

SaaS Alternative

Goodreads StoryGraph Hardcover

Stars

255

Forks

12

Watchers

3

Developer links

KoShelf

Your e-reader already knows everything about your reading life, and KoShelf turns that KOReader metadata into a beautiful dashboard you can browse from any browser. The library overview gathers currently reading, completed, and unread books and comics, while each item's page collects your highlights, annotations, ratings, and review notes in one place. Reading statistics chart your time and pages with customizable activity heatmaps and weekly breakdowns, and per-item statistics reveal session counts, average session length, and reading speed for every book. A monthly calendar shows what you read on each day, and the yearly recap celebrates completions with monthly summaries of finished items and hours read. Supported books open right inside KoShelf's own reader, with keyboard navigation, a progress scrubber, and inline highlight notes. Metadata entries survive even when the original document disappears, because library archives preserve covers and reading data until the source returns. With writeback enabled in server mode, you can edit annotations, ratings, status, and covers from the browser, protected by revision checks and recoverable backups so external changes are never overwritten blindly. Search by title, author, or series, filter by reading status, and download original files whenever you need them. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. EUPL-1.2 licensed.

KoShelf
KoShelf
KoShelf
KoShelf
KoShelf

Benefits

  • Highlights Finally Leave The E-Reader
  • Every KOReader highlight, annotation, rating, and review note lands on the book's own web page, including page-numbered PDF annotations, searchable from any browser instead of trapped on one device.
  • Statistics That Show Habits
  • Reading time, pages read, activity heatmaps, and weekly breakdowns expose your real habits, while per-item statistics track sessions, average duration, and reading speed for every single book.
  • Library Survives Missing Files
  • Metadata entries and library archives preserve covers and reading data after documents and sidecars disappear, and a returning source restores the full entry automatically without re-importing anything.
  • Edit Safely From The Browser
  • Optional writeback lets you change annotations, ratings, status, and covers in server mode, guarded by revision checks against external edits and recoverable KOReader backups if anything goes wrong.

Features

  • In-App Book Reader
  • EPUB, FB2, MOBI, and CBZ files open directly in KoShelf with keyboard navigation, progress scrubber controls, and inline highlight notes, while unsupported documents remain downloadable in original form.
  • Reading Calendar And Recap
  • A monthly calendar maps reading activity day by day with monthly statistics, and the yearly recap builds a timeline of completions with hours read and per-item detail.
  • Server Or Static Site
  • The built-in web server watches files live with a configurable bind address and sub-path hosting, or KoShelf generates a complete static website you can host anywhere.
  • Flexible Authentication Options
  • Optional password authentication with session management protects the dashboard, or authentication can be delegated to trusted reverse proxies such as Home Assistant ingress or an SSO gateway.

Apps Similar to KoShelf