Harmonizing KOReader between devices

lee.hauser · 09-07-2026, 02:46 PM

I'm posting this question in a couple places to get maximum possible answers.

I use KOReader on both a Kobo Clara BW and a Boox Go 10.3 Gen 2 Lumi. I do most of my configuration on the Kobo, then have to reproduce everything on the Boox. Can I just copy the plugin and settings folders and files (as listed in the KOReader docs) from the Kobo to the Lumi? Are there things to watch for between the Kobo and Lumi (which uses Android)?

Thanks in advance!

Gormagon · 09-08-2026, 10:38 AM

Why don't you just try it? If it does not work just re-install the KOReader apk on the Boox device.

If I interpret the User Manual correctly it should work copying certain folders and files to transfer the settings to from one device to another:
"Backup your KOReader settings
In rare cases that you want to backup and restore your KOReader with all your settings, you can backup these folders and files under the KOReader installation directory. Then you can overwrite them after a clean installation to restore your settings:

Folders:
settings
styletweaks
Files:
data/cr3.ini
defaults.persistent.lua
history.lua
settings.reader.lua
settings/profiles.lua
Files under data/dict/ and /data/tessdata/ directories (if they exist)
INFO Your individual book settings and highlights are kept in the same directory as your books in a folder with the same name as your book. You can backup these folders separately if you wish."
https://koreader.rocks/user_guide/#L1-troubleshooting

Frenzie · 09-09-2026, 10:34 AM

The backup and restore primarily refers to the same device, or something close enough like one Kobo to another. Going between different systems may not work as well, especially Android which is the most different. That being said, generally it shouldn't hurt.

rantanplan · 09-09-2026, 11:03 AM

I think the settings.reader.lua file also stores the position of the home folder so synching that over different ecosystems can lead to problems.

lee.hauser · 09-11-2026, 12:44 AM

I did try to copy the KOReader folders from Kobo to Boox, after taking a backup of the Boox folders. The Kobo setup came close to working, but kept crashing randomly. I restored the Boox setup, and had much greater success simply copying the plugins folder from Kobo to Boox, which worked perfectly

09-07-2026, 02:46 PM	#1
lee.hauser Connoisseur Posts: 50 Karma: 10 Join Date: Sep 2010 Location: Seattle area Device: Kobo Clara BW, Boox Go 10.3 (Gen II) Lumi	Harmonizing KOReader between devices I'm posting this question in a couple places to get maximum possible answers. I use KOReader on both a Kobo Clara BW and a Boox Go 10.3 Gen 2 Lumi. I do most of my configuration on the Kobo, then have to reproduce everything on the Boox. Can I just copy the plugin and settings folders and files (as listed in the KOReader docs) from the Kobo to the Lumi? Are there things to watch for between the Kobo and Lumi (which uses Android)? Thanks in advance!

09-08-2026, 10:38 AM	#2
Gormagon monstrous mythical beast Posts: 177 Karma: 5078180 Join Date: May 2023 Location: Klopstokia Device: Tab Ultra C, Meebook P78 Pro, Viwoods AIPaper Reader, various NXTPAPER	Why don't you just try it? If it does not work just re-install the KOReader apk on the Boox device. If I interpret the User Manual correctly it should work copying certain folders and files to transfer the settings to from one device to another: "Backup your KOReader settings In rare cases that you want to backup and restore your KOReader with all your settings, you can backup these folders and files under the KOReader installation directory. Then you can overwrite them after a clean installation to restore your settings: Folders: settings styletweaks Files: data/cr3.ini defaults.persistent.lua history.lua settings.reader.lua settings/profiles.lua Files under data/dict/ and /data/tessdata/ directories (if they exist) INFO Your individual book settings and highlights are kept in the same directory as your books in a folder with the same name as your book. You can backup these folders separately if you wish." https://koreader.rocks/user_guide/#L1-troubleshooting Last edited by Gormagon; 09-13-2026 at 07:58 AM.

Thread Tools	Search this Thread
Show Printable Version Email this Page	Search this Thread: Advanced Search

Similar Threads
Thread	Thread Starter	Forum	Replies	Last Post
Synchronise KOReader files between devices	Extricated	PocketBook	1	02-03-2026 12:10 PM
two different devices and koreader sync	stregone	KOReader	2	04-17-2025 03:19 PM
What E-reader devices would work the best with KOReader?	nemiya	KOReader	7	11-13-2024 07:40 PM
KOReader problems with Boyue devices	chromeuser	KOReader	0	06-12-2016 06:39 PM
Harmonizing Kindle Direct and Smashwords	Marseille	Writers' Corner	8	04-28-2011 11:12 PM

09-09-2026, 10:34 AM	#3
Frenzie Wizard Posts: 1,844 Karma: 731691 Join Date: Oct 2014 Location: Antwerp Device: Kobo Aura H2O, Kobo Libra 2	The backup and restore primarily refers to the same device, or something close enough like one Kobo to another. Going between different systems may not work as well, especially Android which is the most different. That being said, generally it shouldn't hurt.

09-09-2026, 11:03 AM	#4
rantanplan Weirdo Posts: 1,276 Karma: 13516840 Join Date: Nov 2019 Location: Wuppertal, Germany Device: Kobo Libra 2, Kobo Sage, Kobo Aura H2O, reMarkable PaperPro	I think the settings.reader.lua file also stores the position of the home folder so synching that over different ecosystems can lead to problems.

09-11-2026, 12:44 AM	#5
lee.hauser Connoisseur Posts: 50 Karma: 10 Join Date: Sep 2010 Location: Seattle area Device: Kobo Clara BW, Boox Go 10.3 (Gen II) Lumi	I did try to copy the KOReader folders from Kobo to Boox, after taking a backup of the Boox folders. The Kobo setup came close to working, but kept crashing randomly. I restored the Boox setup, and had much greater success simply copying the plugins folder from Kobo to Boox, which worked perfectly

Advert

Advert