Skip to content

0.2.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 22 Nov 19:32
· 26 commits to main since this release
0.2.0
9e22f1a

0.2.0 (2025-11-22)

The 0.2 release changes the way publisher page numbers (if available) are used when updating reading progress. Previously, publisher page numbers were used to estimate a progress percentage, which was compared to the number of pages in the selected edition, and the resulting page number was sent to Hardcover. This was done to solve issues with non-numeric and non-linear page numbers in publisher page maps.

For books with page maps that closely matched the selected edition, this resulted in sometimes surprising progress updates that didn't match the current page at all, but the result could be even worse if the selected edition's page count was very different from the page map's.

In 0.2, when a book has publisher page numbers available and enabled, the plugin will do its best to use those page numbers directly when updating. This has some caveats:

  • Pages read before "page 1" of the book (typically prologues and introductions) will be treated as page 1 when updating.
  • Epilogue pages after the end of the book (which also may be non-numeric) will be treated as the number of pages in the edition.
  • If the page map has fewer or more pages than the edition, reading progress in Hardcover may not have the most desirable page.
  • There may be some odd page maps with no or limited numeric page numbers which will probably not have good results.

This can mean that finished books don't reach 100%, or reach it too soon.

This is a compromise approach and has some negative tradeoffs compared to the previous implementation, but should be an overall improvement for most users.

However, if you don't like this behavior, you can disable publisher page numbers in KOReader (Bookmark>Settings>Stable page numbers>Use stable page numbers in 2025.10, or Bookmark>Reference pages>Use reference page numbers in previous versions), and the plugin will use the old system instead.

Note: KOReader 2025.10 also adds stable page numbers based on a number of characters per page. These are ignored by the plugin.

Added

  • Publisher page labels will now be used for reading progress without translation
  • Percentage calculation used to determine when to create new journal entries now uses the page
    label divided by edition page count. This is weird but ensures that journal reading percentage is close to the
    selected interval
  • Plugin will now ignore page mapping if publisher page labels are disabled in KOReader

Fixes

  • Switch to socket.http implementation to better support proxy usage

Chores

  • Fix zip release directory structure
Assets 3
Loading