Releases: BookFusion/koreader-plugin-releases
Release list
v1.2.1
New
- Book details — tapping a book used to give just its title and two buttons. It
now opens the book itself: cover, author, series, the format and size you would be
downloading, the year and language, how far through it you are, and its
description — with Download, Read and the other actions in the same place.
Fixes
- Steadier handling of network errors — an uncommon kind of connection failure
could stop the plugin with an error instead of reporting that the request failed.
Updating
On v1.1.4 or later, update in place from Tools → BookFusion → Updates.
On KOReader 2026.07 or later with plugin v1.1.3 or earlier, in-app updating cannot
install this release — download the zip below and replace your bookfusion.koplugin
folder once. Updates install normally from then on.
v1.2.0
New
- PDFs and comic books — a PDF, CBZ or CBR in your library now downloads in its
own format and opens natively in KOReader, with your place in the book syncing
across your devices. Highlights in a PDF sync both ways.
Fixes
- More accurate highlights — highlights are placed and drawn more accurately in
some books, both the ones you make in KOReader and the ones that come from your
other devices. - Reading positions from the web reader — more of them now open exactly where you
left off, in books where they could land at the start of the chapter instead. - Highlight times account for your time zone — a highlight's time is sent in UTC,
so it reads correctly in BookFusion wherever you are.
Coming from v1.1.2? This release also carries the v1.1.3 and v1.1.4 fixes:
highlight colours and note edits sync in from your other devices, pushing a reading
position works on every page of a book, and in-app updates work on KOReader 2026.07
and later.
Updating
On v1.1.4 or later, update in place from Tools → BookFusion → Updates.
On KOReader 2026.07 or later with plugin v1.1.3 or earlier, in-app updating cannot
install this release — download the zip below and replace your bookfusion.koplugin
folder once. Updates install normally from then on.
On KOReader 2026.03 and earlier, update in place from Tools → BookFusion →
Updates as usual.
v1.1.4
Fixes
- Pushing a reading position works on every page — on some pages the plugin could not read the current position, and "Pushing reading position…" stayed on screen with nothing happening. Positions now sync from anywhere in a book, and a sync that does fail says so instead of leaving the message up.
- In-app updates work again on KOReader 2026.07 and later — KOReader 2026.07 removed the archive call the updater used, so installing an update failed with "couldn't extract the update". The plugin now uses KOReader's current extraction API, and falls back to the old one on earlier KOReader versions.
- Quieter logs — KOReader no longer warns about a deprecated field in the plugin's metadata on every startup.
Updating
An update is installed by the version you already have, so if you are on KOReader 2026.07 or later and on plugin v1.1.3 or earlier, Tools → BookFusion → Updates cannot install this release — it will fail with "couldn't extract the update". Download the zip below and replace your existing bookfusion.koplugin folder once. From v1.1.4 onward, in-app updating works again.
On KOReader 2026.03 and earlier, update in place from Tools → BookFusion → Updates as usual.
v1.1.3
Fixes
- Reading positions from the web and mobile apps now restore correctly — opening a book you were reading elsewhere takes you to where you left off instead of jumping to the first page.
- Highlight colors now carry over into KOReader — a highlight made on the web or in the apps keeps its color, matched to the closest of KOReader's nine.
- Highlight color and note changes sync in — recoloring a highlight or editing its note on another device updates it in KOReader.
Updating
On KOReader 2026.07 or later, in-app updating cannot install this version. KOReader 2026.07 removed the archive call the updater used, so Tools → BookFusion → Updates fails with "couldn't extract the update". Download the zip below and replace your existing bookfusion.koplugin folder. (Fixed in v1.1.4, so later updates install normally.)
On KOReader 2026.03 and earlier: if you're on v1.1.0 or later, update in place from Tools → BookFusion → Updates. On earlier plugin versions, download the zip below and replace your existing bookfusion.koplugin folder.
v1.1.2
Fixes
- Reading time now syncs from KOReader — time you spend reading in KOReader is recorded on BookFusion, so books you read on your device move to Currently Reading and your reading activity is counted.
- Offline reading time uploads reliably — reading time recorded while offline is submitted the next time you open KOReader online.
v1.1.1
Fixes
- Non-Latin book titles in filenames — books with Cyrillic, Chinese/Japanese/Korean, or accented titles now download under their real name. Previously those characters were stripped out, which could leave a book with a blank filename and cause several such books to collapse into a single file — sharing one reading position and set of highlights.
- Renaming or moving a book no longer breaks sync — if you rename or move a downloaded book, whether inside KOReader or from a computer, reading progress and highlight sync keep working. Previously the book was treated as no longer downloaded and quietly stopped syncing.
Updating
If you're on v1.1.0, update in place from Tools → BookFusion → Updates. On earlier versions, download the zip below and replace your existing bookfusion.koplugin folder.
v1.1.0
BookFusion for KOReader v1.1.0
New
- In-app updates — check for and install new plugin versions from within KOReader, in the BookFusion menu under Updates. No need to download and copy files by hand.
Improvements
- Smoother sync — reading progress and highlights now sync without interrupting reading, so page turns stay responsive (previously syncing could freeze the screen for several seconds on some devices).
- Faster covers — book covers load faster and appear as soon as each one is ready.
v1.0.1
BookFusion KOReader Sync Plugin v1.0.1
This release includes a couple of quality-of-life improvements based on reader feedback after the initial launch.
Improvements
- Stay on the same library page after downloading
When downloading a book from a paginated library view, KOReader now keeps you on the same page instead of returning you to page 1 after the download finishes.
- Browse Books can now be used as an action
The Browse Books menu item is now available as an action/gesture item, making it possible to assign it to gestures, shortcut buttons, or Simple UI actions for quicker access without navigating through KOReader menus.
v1.0.0
We're shipping the first public release of the BookFusion KOReader plugin. Install it once and your entire BookFusion library(ebooks & articles), reading progress, and highlights stay in sync — on every KOReader device.
What's New
- Library browser — Browse your BookFusion library directly inside KOReader, organized by Series, Tags, custom shelves, and smart shelves.
- Flexible downloads — Download books to any folder or multiple folders on your device.
- Two-way sync — Reading position and highlights sync across KOReader devices and the BookFusion iOS, Android, and web apps.
- Gesture support — Push and pull progress and highlights with taps and gestures, fully configurable in KOReader's Gesture Manager.
- Reading time tracking — Per-book reading time is tracked and included in your weekly BookFusion email summaries.
- Rich metadata — Series, Tags, and Cover art sync automatically on download.
- Auto-sync — Optionally enable background sync, with support for fetch on resume and unlock.