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.
- 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
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.
| 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.
| 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.
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 upgradesrc/
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
MIT. sql.js is MIT licensed, see vendor/LICENSE-sql.js. Not affiliated with Kobo, Rakuten or the KOReader project.
