![]() |
#1 |
Member
![]() ![]() ![]() ![]() Posts: 16
Karma: 368
Join Date: May 2024
Location: North America
Device: Kobo Clara BW + Koreader
|
![]()
KOReader calibre plugin
A calibre plugin to synchronize metadata from KOReader to calibre. KOReader creates sidecar files that hold read progress and annotations. This plugin reads the data from those sidecar files and updates calibre's metadata based on them. It is inspired by the Kobo Utilities plugin, that synchronizes reading progress between the original Kobo firmware ("Nickel") and custom columns in calibre. For best experience please use the latest KOReader release Using this plugin Download and install 1. Go to your calibre's Preferences > Plugins > Get new plugins and search for KOReader Sync 2. Click Install 3. Restart calibre Setup 1. Pick and choose the metadata you would like to sync and create the appropriate columns in calibre. These are your options: - A Floating point numbers column to store the current percent read, with Format for numbers set to `{:.0%}`. - An Integers column to store the current percent read. - A regular Text column to store the location you last stopped reading at. - A Rating column to store your rating of the book, as entered on the book's status page. - A Long text column to store your review of the book, as entered on the book's status page. - A regular Text column to store the reading status of the book, as entered on the book status page (Finished, Reading, On hold). - A Yes/No column to store the reading status of the book, as a boolean (Yes = Finished, No = everything else). - A Long text column to store your bookmarks and highlights of the book, with Interpret this column as set to Plain text formatted using markdown. (Highlights are an unordered list with their metadata in an HTML comment.) - A regular Text column to store the MD5 hash KOReader uses to sync progress to a KOReader Sync Server. (Progress sync in the KOReader app.) This might allow for syncing progress to calibre without having to connect your KOReader device, in the future. - A Date column to store when the last sync was performed. - A Long text column to store the contents of the metadata sidecar as HTML, with Interpret this column as set to HTML. 10. Add KOReader Sync to main toolbar when a device is connected, if it isn't there already. 11. Right-click the KOReader Sync icon and Configure. 12. Map the metadata you want to sync to the newly created calibre columns. 13. Click OK to save your mapping. 14. From now on just click the KOReader Sync icon to sync all mapped metadata for all books on the connected device to calibre. Things to consider - The plugin overwrites existing metadata in Calibre without asking. That usually isn’t a problem, because you will probably only add to KOReader’s metadata. But be aware that you might lose data in calibre if you’re not careful. - Pushing sidecars back to KOReader currently only happens for sidecars which are missing. For now, manually delete the `<bookname>.sdr` folder from the device before attempting to push the sidecars back to KOReader for any books you would like to overwrite the current metadata with Calibre's metadata. - When pushing missing sidecars to the device, no attempt is made to convert Calibre's metadata to account for changes in KOReader's sidecar format. Old metadata may work unpredictably if it's from a different version of KOReader. Code:
Original author grand me permission as source code contributor and now I will be maintaining and releasing this plugin. Since they is not actively maintaining it. For Bug reports or Feature requests please use github template Old thread Last edited by kyx84; Today at 03:12 PM. Reason: v0.6.7 |
![]() |
![]() |
![]() |
#3 |
Member
![]() ![]() ![]() ![]() Posts: 16
Karma: 368
Join Date: May 2024
Location: North America
Device: Kobo Clara BW + Koreader
|
![]()
New release: https://github.com/harmtemolder/kore...ses/tag/v0.6.4
(looking on how to upload it to the first post, since I do not have rights to edit my own post) |
![]() |
![]() |
![]() |
#4 | |
Well trained by Cats
![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() Posts: 30,203
Karma: 57978778
Join Date: Aug 2009
Location: The Central Coast of California
Device: Kobo Libra2,Kobo Aura2v1, K4NT(Fixed: New Bat.), Galaxy Tab A
|
Quote:
Moderator Notice Done it You should be able to do this very soon as you will reach whatever magic points level the forum requires. |
|
![]() |
![]() |
![]() |
#5 |
Zealot
![]() Posts: 118
Karma: 34
Join Date: Jun 2015
Device: ipad & inkpad X
|
Great update! Thanks a lot!
Last edited by igorius; 07-31-2024 at 01:12 PM. |
![]() |
![]() |
Advert | |
|
![]() |
#6 |
Member
![]() ![]() ![]() ![]() Posts: 16
Karma: 368
Join Date: May 2024
Location: North America
Device: Kobo Clara BW + Koreader
|
![]()
v0.6.5
What's Changed
Full Changelog: https://github.com/harmtemolder/kore...0.6.4...v0.6.5 Github: https://github.com/harmtemolder/kore...ses/tag/v0.6.5 Last edited by kyx84; 08-05-2024 at 02:28 PM. |
![]() |
![]() |
![]() |
#7 |
Member
![]() ![]() ![]() ![]() Posts: 16
Karma: 368
Join Date: May 2024
Location: North America
Device: Kobo Clara BW + Koreader
|
v0.6.6
What's Changed
Full Changelog: https://github.com/harmtemolder/kore...0.6.5...v0.6.6 Last edited by kyx84; 08-09-2024 at 03:37 PM. |
![]() |
![]() |
![]() |
#8 |
Diligent dilettante
![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() Posts: 3,430
Karma: 48736498
Join Date: Sep 2019
Location: in my mind
Device: Kobo Sage; Kobo Libra H2O
|
I just tried this for the first time in a very long time, this was the result
Spoiler:
|
![]() |
![]() |
![]() |
#9 |
Member
![]() ![]() ![]() ![]() Posts: 16
Karma: 368
Join Date: May 2024
Location: North America
Device: Kobo Clara BW + Koreader
|
|
![]() |
![]() |
![]() |
#10 |
Member
![]() ![]() ![]() ![]() Posts: 16
Karma: 368
Join Date: May 2024
Location: North America
Device: Kobo Clara BW + Koreader
|
v0.6.7
What's Changed
Full Changelog: https://github.com/harmtemolder/kore...0.6.6...v0.6.7 |
![]() |
![]() |
![]() |
#11 |
Diligent dilettante
![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() Posts: 3,430
Karma: 48736498
Join Date: Sep 2019
Location: in my mind
Device: Kobo Sage; Kobo Libra H2O
|
Awesome, thanks for that!
|
![]() |
![]() |
![]() |
Tags |
calibre, kobo, koreader, plug-in, plugins |
|
![]() |
||||
Thread | Thread Starter | Forum | Replies | Last Post |
[GUI Plugin] Goodreads Sync | kiwidude | Plugins | 1755 | 08-11-2024 08:43 PM |
[GUI Plugin] Skoob Sync | thiago.eec | Plugins | 24 | 02-19-2024 10:20 AM |
[GUI Plugin] BookFusion Cloud Sync | skillachie | Plugins | 58 | 04-29-2023 02:42 AM |
[GUI Plugin] KyBook3 Sync - replaced | karl1c | Plugins | 45 | 04-23-2021 06:33 PM |
[Gui Plugin] Cloud Sync | kerimlcr | Plugins | 13 | 03-06-2018 05:13 AM |