MobileRead Forums - View Single Post - KOReader plugin that syncs reading progress back to the Onyx Boox library

Tumeconnais · 02-17-2026, 09:11 AM

Hey everyone,

I use KOReader as my main reader on an Onyx Boox Go 7, but one thing always bugged me: the Boox library has no idea what I'm reading or how far I am, since KOReader handles everything independently. So I built a small plugin to fix that.

What it does:

Syncs your current page position (e.g. "173/488") to the Boox Library
Sets the reading status (New / Reading / Finished) based on KOReader's status
Updates the "last accessed" timestamp so books sort correctly in the Boox library
Includes a bulk update option from the file browser menu — scans the current directory and pushes progress for all books at once, so you don't have to open each one individually

Installation:

Create a folder in koreader/plugins/onyx_sync.koplugin
Copy main.lua and _meta.lua into the folder
Restart KOReader.
Ensure the plugin is enabled in KOReader settings.

It's still a Beta, sometime it fails to sync and I don't know really why, an issue is open. I released a V0.0.2 https://github.com/Tukks/onyxbooxsyn...ses/tag/v0.0.2, it seems to have fixed the sync error, but I'm not sur.

GitHub: https://github.com/Tukks/onyxbooxsync.koplugin

Would love feedback, especially from people on other Boox models to see if it works flawlessly. PRs welcome!

02-17-2026, 09:11 AM	#1
Tumeconnais Junior Member Posts: 4 Karma: 10 Join Date: Jan 2013 Device: Kobo Glo By fnac	KOReader plugin that syncs reading progress back to the Onyx Boox library Hey everyone, I use KOReader as my main reader on an Onyx Boox Go 7, but one thing always bugged me: the Boox library has no idea what I'm reading or how far I am, since KOReader handles everything independently. So I built a small plugin to fix that. What it does: Syncs your current page position (e.g. "173/488") to the Boox Library Sets the reading status (New / Reading / Finished) based on KOReader's status Updates the "last accessed" timestamp so books sort correctly in the Boox library Includes a bulk update option from the file browser menu — scans the current directory and pushes progress for all books at once, so you don't have to open each one individually Installation: Create a folder in koreader/plugins/onyx_sync.koplugin Copy main.lua and _meta.lua into the folder Restart KOReader. Ensure the plugin is enabled in KOReader settings. It's still a Beta, sometime it fails to sync and I don't know really why, an issue is open. I released a V0.0.2 https://github.com/Tukks/onyxbooxsyn...ses/tag/v0.0.2, it seems to have fixed the sync error, but I'm not sur. GitHub: https://github.com/Tukks/onyxbooxsync.koplugin Would love feedback, especially from people on other Boox models to see if it works flawlessly. PRs welcome!