Skip to content

NickelReadingStats v0.3.0

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 22 Oct 09:06
· 2 commits to main since this release
v0.3.0
12746ee
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Chapter bars and time-left estimates now also work for books bought in a
Tolino store. This is also the first release built and published by CI on
GitHub.

Deutsch, kurz: Kapitelbalken und Restzeit-Schätzung funktionieren jetzt auch für Bücher aus einem Tolino-Shop (ohne Kopierschutz). Das Projekt ist von Codeberg nach GitHub umgezogen, und Releases werden ab jetzt automatisch gebaut. Installation wie bisher: Kobo.tgz nach .kobo/ kopieren und neu starten.

New

  • Tolino store books: chapter bars and the "time left" estimate now also
    work for books bought in a Tolino store. On a Tolino these are regular EPUBs
    stored under .kobo/kepub/, which the mod did not pick up before. Activity
    (reading time, sessions, pages per minute) was already recorded for them.
  • Encrypted (DRM) books are skipped deliberately: their chapters cannot be
    read without bypassing the DRM, which the mod does not do. They keep
    Activity data but show no chapter bars. Watermarked store books are not
    encrypted and are fully supported.

Compatibility

  • Kobo firmware 5.18 and 6.0: the firmware check (symbols, calling
    conventions, class layout, offsets) passes for Kobo 5.18.270971 and
    6.0.276679. The mod has not been tested on a Kobo device yet; feedback is
    welcome.
  • Tolino firmware 5.18 remains the tested platform (5.18.264769).

Project

  • Moved to GitHub: the repository is now
    dkuester/NickelReadingStats.
    The Codeberg repository is archived.
  • Releases are built by CI: Kobo.tgz is cross-built from the tagged
    commit and published with SHA256SUMS.
  • New README with screenshots, feature and compatibility tables. The
    technical details are in docs/ARCHITECTURE.md
    and docs/DEVELOPMENT.md.
  • The "time left" estimate is no longer listed as a known limitation; it has
    been accurate since v0.2.0.

Tested

On a Tolino with firmware 5.18.264769:

  • Store book without DRM: chapter bars, read chapters highlighted and "time
    left" estimate work.
  • Sideloaded EPUBs and Activity work as in v0.2.1.

Host tests (Qt 5 and Qt 6) and the ARM build run in CI. The firmware checks
against Tolino 5.18, Kobo 5.18 and Kobo 6.0 pass (run locally; the firmware
files are not part of the repository).

Known limitations

  • Encrypted (DRM) books show no chapter bars or "time left" estimate.
  • A book made of a single large HTML file shows a single chapter bar.
  • Kobo devices have not been tested on a device yet.
  • Firmware 5.18+ (Qt 6) only; firmware 4.x is not supported.

Install

  1. Download Kobo.tgz from the assets below (checksums in SHA256SUMS).
  2. Copy it to .kobo/ on the device.
  3. Eject; the device installs the update on the next start. If it does not
    restart by itself, restart it.

Updating from an earlier version needs no uninstall. To uninstall, place an
empty file readingstats_uninstall in the device root and restart.

Reverse-engineered with AI assistance; full credits and attribution are in
the README. Licensed under MIT.

Assets 4
Loading