0.4.0

0.4.0 (2026-04-26)

Added

• Added option to show a confirmation when changing a book's currently read status to reduce misclick issues

0.3.1

0.3.1 (2026-02-18)

Added

• Added support for Updates Manager Plugin (min: v1.4.0)

Fixes

• Fix page change gestures causing a refresh (even when there are no pages to navigate to) of the suggest a book, and
  book/edition linking dialogs

0.3.0

0.3.0 (2026-01-24)

This release restores a previously removed feature, 'suggest a book', with some new functionality. This displays a list of up to 10 books in random order from your Hardcover Want to Read list.

This was removed previously because of the lack of integration with KOReader. Now, tapping one of the suggested books will also start a file search for that book.

Added

• Added "suggest a book" to hardcover menu. Displays 10 books from your to-read list at random.
• Plugin will now consider the hardcover-slug ebook identifier in addition to hardcover identifier (
  by @yd4dev)

Fixes

• Fix page map crash when loading document formats that don't support page maps (like CBR)
• Fix page map crash when document is out of range of the active page map

0.2.0

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

0.0.13

0.1.3 (2025-09-10)

🚀 Added

• Register action to immediately update reading
  progress #19
• Add event to open journal entry dialog #27

0.1.2

0.1.2 (2025-05-13)

🚀 Added

• Hardcover menu now visible in both reading view and file manager view
• Sort ebooks above physical books in edition list

🩹 Fixes

• Remove 50 book limit from edition selection

0.1.1

0.1.1 (2025-04-12)

🚀 Added

• Reduce data requested from search API endpoint

🩹 Fixes

• Fix missing invalid API key warning after request failure

🧹 Chores

• Remove dependency on coverbrowser plugin

0.1.0

0.1.0 (2025-03-21)

🚀 Added

• Prompt to enable wifi if needed before opening journal dialog

🧹 Chores

• Include user agent in requests to hardcover API

🩹 Fixes

• Always show book format and reader count in list view
• Fix potential crash when document is no longer available when fetching book cache
• Fix crash at some font sizes when using compatibility mode and searching for books with long author names
• Fix compatibility mode not displaying authors at some font sizes
• Fix compatibility mode not displaying edition type at some font sizes

0.0.8

0.0.8 (2025-01-16)

🚀 Added

• Display edition language and series in book searches
• Add option to turn on/off wifi automatically for background updates on some devices where possible
• Changed manual page update dialog to allow updating by document page or hardcover page with synchronized display

🩹 Fixes

• Fix crash when navigating to previous page in search menu after images have loaded
• Fix crash related to book settings when active document has been closed
• Fall back to less specific reading format when edition format is unavailable
• Fix ISBN values with hyphens being ignored by automatic book linking
• Fix pages exceeding a document's page map being treated as lower numbers than previous page

🧹 Chores

• Renamed lib directory and config.lua to prevent conflicts with other plugins

⚠️ Upgrading

The plugin now looks for hardcover_config.lua instead of config.lua. Rename this file (which contains your API key)
on your device.

0.0.7

0.0.7 (2024-12-30)

🚀 Added

• Added option to update books by percentage completed rather than timed updates
• Display error and disable some functionality when Hardcover API indicates that API key is not valid, in preparation
  for upcoming API key reset
• Allow linking books, enabling/disabling book tracking from KOReader's gesture manager

🩹 Fixes

• Fix crash when linking book from hardcover menu
• Fix automatic book linking not working unless track progress (or always track progress) already set
• Fix manual and automatic book linking not working for hardcover identifiers
• Fix failure to mark book as read when end of book action displays a dialog
• Fix a crash when searching without an internet connection
• Fix page update tracking not working correctly when using "always track progress" setting
• Fix off-by-one page number issue when document contains a page map
• Fix unable to set edition if that edition already set in hardcover

🧹 Chores

• Update default edition selection in journal dialog to use multiple API calls instead of one due to upcoming Hardcover
  API limits
• Fetch book authors from cached column in Hardcover API