---
source_url: "https://www.mobileread.com/forums/showthread.php?t=372122"
title: KOReader plugin that syncs reading progress back to the Onyx Boox library - MobileRead Forums
mirrored_at: 2026-08-14T01:02:07.273Z
host: www.mobileread.com
cited_in_42a: true
mirror_canonical: "https://index.42a.ai/www.mobileread.com/forums/showthread.php__q__t_372122"
---

> **Original source:** https://www.mobileread.com/forums/showthread.php?t=372122

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](https://github.com/Tukks/onyxbooxsync.koplugin/releases/tag/v0.0.2), it seems to have fixed the sync error, but I'm not sur.

GitHub: [https://github.com/Tukks/onyxbooxsync.koplugin](https://github.com/Tukks/onyxbooxsync.koplugin)

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

Edit : The last version includes a companion app to perform the synchronization and can now synchronize reading time statistics. go check the readme for installation instruction.