Skip to content
AstralunaProjectPublic

About

Your reading year in review from Kobo and KOReader. Books, hours, streaks and share cards, 100% in your browser.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

readrecap

CI License: MIT

Your reading year in review from Kobo and KOReader. Books, hours, streaks and share cards, 100% in your browser.

Open readrecap → · no login, no upload. No e-reader at hand? Try the sample data button.

Reading year in review with books finished, hours and a reading calendar

What you get

  • Books finished in the year, with author and date, and the change from the year before
  • Time reading, pages, reading days and the longest streak
  • Books per month, reading time by hour of the day, and a calendar of every reading day
  • Highlights of the year: longest book, fastest finish, most read author, favorite time and day, longest sitting
  • Share card: a 1080×1350 PNG with the year's books as spines on a shelf

Your history stays on your device

The database is opened in the browser with sql.js (SQLite compiled to WebAssembly, vendored in vendor/). There is no server, no account and no analytics; the page only loads its own files.

Where the files are

App File How to get it
Kobo KoboReader.sqlite Connect by USB, open the hidden .kobo folder on the KOBOeReader drive and copy it
KOReader statistics.sqlite3 In KOReader's settings folder: .adds/koreader/settings/ on a Kobo, koreader/settings/ on Android

Both files can be dropped at once; books read in both apps are merged by title and author.

What each source can tell

KOReader Kobo
Books finished and when Inferred: the first time the last 2% (at least two pages) is read ReadStatus = 2 and LastTimeFinishedReading
Time reading Per page view (page_stat_data), so per day and hour Total per book only (TimeSpentReading), counted in the year it was finished or last opened
Pages, calendar, streaks, time of day Yes No: Kobo does not keep reading days
Highlights Not dated in the statistics Bookmark rows with text, dated by DateCreated

Kobo stores dates in UTC; everything is shown in your time zone. Older Kobo firmware without the newer columns still works, with fewer details.

Development

No build step: plain ES modules, typed with JSDoc and checked by TypeScript. The tests build real SQLite databases with the same schemas using sql.js.

npm install
npm run check   # TypeScript
npm test        # node:test
npm run serve   # http://localhost:8000
npm run vendor  # copies sql.js from node_modules into vendor/ after an upgrade
src/
  kobo.js, koreader.js, load.js   database readers
  library.js                      shared model and merging
  stats.js, format.js             year review
  charts.js, card.js              drawing
  app.js, demo.js                 page

License

MIT. sql.js is MIT licensed, see vendor/LICENSE-sql.js. Not affiliated with Kobo, Rakuten or the KOReader project.

About

Your reading year in review from Kobo and KOReader. Books, hours, streaks and share cards, 100% in your browser.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages