Register Guidelines E-Books Today's Posts Search

Go Back   MobileRead Forums > E-Book Software > Calibre > Plugins

Notices

Reply
 
Thread Tools Search this Thread
Old 07-27-2024, 02:51 PM   #1
kyx84
Member
kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.
 
Posts: 18
Karma: 368
Join Date: May 2024
Location: North America
Device: Kobo Clara BW + Koreader
Arrow [GUI Plugin] KOReader Sync

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.
Full and detailed readme can be found here

For Bug reports or Feature requests please use github template


Old thread
Attached Files
File Type: zip KOReader_Sync_v0.6.8.zip (70.0 KB, 1489 views)

Last edited by kyx84; 11-22-2024 at 02:30 PM. Reason: v0.6.7
kyx84 is offline   Reply With Quote
Old 07-27-2024, 02:53 PM   #2
kyx84
Member
kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.
 
Posts: 18
Karma: 368
Join Date: May 2024
Location: North America
Device: Kobo Clara BW + Koreader
Arrow

User feedback is needed

Last edited by kyx84; 08-05-2024 at 10:50 AM.
kyx84 is offline   Reply With Quote
Old 07-31-2024, 12:12 PM   #3
kyx84
Member
kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.
 
Posts: 18
Karma: 368
Join Date: May 2024
Location: North America
Device: Kobo Clara BW + Koreader
Cool

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)
kyx84 is offline   Reply With Quote
Old 07-31-2024, 01:44 PM   #4
theducks
Well trained by Cats
theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.
 
theducks's Avatar
 
Posts: 30,506
Karma: 58055868
Join Date: Aug 2009
Location: The Central Coast of California
Device: Kobo Libra2,Kobo Aura2v1, K4NT(Fixed: New Bat.), Galaxy Tab A
Quote:
Originally Posted by kyx84 View Post
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)
Moderator Notice
Done it

You should be able to do this very soon as you will reach whatever magic points level the forum requires.
theducks is offline   Reply With Quote
Old 07-31-2024, 02:06 PM   #5
igorius
Zealot
igorius began at the beginning.
 
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 02:12 PM.
igorius is offline   Reply With Quote
Old 08-05-2024, 10:48 AM   #6
kyx84
Member
kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.
 
Posts: 18
Karma: 368
Join Date: May 2024
Location: North America
Device: Kobo Clara BW + Koreader
Arrow

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 03:28 PM.
kyx84 is offline   Reply With Quote
Old 08-09-2024, 04:33 PM   #7
kyx84
Member
kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.
 
Posts: 18
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 04:37 PM.
kyx84 is offline   Reply With Quote
Old 08-14-2024, 12:09 PM   #8
Uncle Robin
Diligent dilettante
Uncle Robin ought to be getting tired of karma fortunes by now.Uncle Robin ought to be getting tired of karma fortunes by now.Uncle Robin ought to be getting tired of karma fortunes by now.Uncle Robin ought to be getting tired of karma fortunes by now.Uncle Robin ought to be getting tired of karma fortunes by now.Uncle Robin ought to be getting tired of karma fortunes by now.Uncle Robin ought to be getting tired of karma fortunes by now.Uncle Robin ought to be getting tired of karma fortunes by now.Uncle Robin ought to be getting tired of karma fortunes by now.Uncle Robin ought to be getting tired of karma fortunes by now.Uncle Robin ought to be getting tired of karma fortunes by now.
 
Uncle Robin's Avatar
 
Posts: 3,499
Karma: 49052844
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:
calibre, version 7.15.0
ERROR: Unhandled exception: <b>KeyError</b>:'column_date_sidecar_modified'

calibre 7.15 embedded-python: True
Windows-10-10.0.19045-SP0 Windows ('64bit', 'WindowsPE')
('Windows', '10', '10.0.19045')
Python 3.11.5
Windows: ('10', '10.0.19045', 'SP0', 'Multiprocessor Free')
Interface language: None
EXE path: C:\Program Files\Calibre2\calibre.exe
Successfully initialized third party plugins: DeDRM (10, 0, 9) && Calibre Power Search Plugin (2, 2, 0) && Count Pages (1, 13, 6) && EpubMerge (3, 1, 0) && Find Duplicates (1, 10, 9) && KOReader Sync (0, 6, 6) && KePub Input (3, 6, 6) && KePub Output (3, 6, 11) && Kindle hi-res covers (0, 5, 1) && Kobo Books (1, 9, 2) && Kobo Utilities (2, 17, 1) && KoboTouchExtended (3, 6, 11) && MultiColumnSearch (1, 0, 96) && Obok DeDRM (10, 0, 9) && Reading List (1, 15, 4) && Save Composite Custom Columns (1, 1, 1) && View Manager (1, 10, 3)
Traceback (most recent call last):
File "calibre\utils\config.py", line 430, in __getitem__
KeyError: 'column_date_sidecar_modified'

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
File "calibre_plugins.koreader.action", line 841, in sync_to_calibre
File "calibre_plugins.koreader.action", line 410, in update_metadata
File "calibre\utils\config.py", line 432, in __getitem__
KeyError: 'column_date_sidecar_modified'
Uncle Robin is offline   Reply With Quote
Old 08-14-2024, 04:08 PM   #9
kyx84
Member
kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.
 
Posts: 18
Karma: 368
Join Date: May 2024
Location: North America
Device: Kobo Clara BW + Koreader
Quote:
Originally Posted by Uncle Robin View Post
I just tried this for the first time in a very long time, this was the result

Spoiler:
calibre, version 7.15.0
ERROR: Unhandled exception: <b>KeyError</b>:'column_date_sidecar_modified'

calibre 7.15 embedded-python: True
Windows-10-10.0.19045-SP0 Windows ('64bit', 'WindowsPE')
('Windows', '10', '10.0.19045')
Python 3.11.5
Windows: ('10', '10.0.19045', 'SP0', 'Multiprocessor Free')
Interface language: None
EXE path: C:\Program Files\Calibre2\calibre.exe
Successfully initialized third party plugins: DeDRM (10, 0, 9) && Calibre Power Search Plugin (2, 2, 0) && Count Pages (1, 13, 6) && EpubMerge (3, 1, 0) && Find Duplicates (1, 10, 9) && KOReader Sync (0, 6, 6) && KePub Input (3, 6, 6) && KePub Output (3, 6, 11) && Kindle hi-res covers (0, 5, 1) && Kobo Books (1, 9, 2) && Kobo Utilities (2, 17, 1) && KoboTouchExtended (3, 6, 11) && MultiColumnSearch (1, 0, 96) && Obok DeDRM (10, 0, 9) && Reading List (1, 15, 4) && Save Composite Custom Columns (1, 1, 1) && View Manager (1, 10, 3)
Traceback (most recent call last):
File "calibre\utils\config.py", line 430, in __getitem__
KeyError: 'column_date_sidecar_modified'

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
File "calibre_plugins.koreader.action", line 841, in sync_to_calibre
File "calibre_plugins.koreader.action", line 410, in update_metadata
File "calibre\utils\config.py", line 432, in __getitem__
KeyError: 'column_date_sidecar_modified'
fixed in upcoming release, if you do not want to wait - uncheck Sync only if changes are more recent and try again
kyx84 is offline   Reply With Quote
Old 08-14-2024, 04:09 PM   #10
kyx84
Member
kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.
 
Posts: 18
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
kyx84 is offline   Reply With Quote
Old 08-14-2024, 08:36 PM   #11
Uncle Robin
Diligent dilettante
Uncle Robin ought to be getting tired of karma fortunes by now.Uncle Robin ought to be getting tired of karma fortunes by now.Uncle Robin ought to be getting tired of karma fortunes by now.Uncle Robin ought to be getting tired of karma fortunes by now.Uncle Robin ought to be getting tired of karma fortunes by now.Uncle Robin ought to be getting tired of karma fortunes by now.Uncle Robin ought to be getting tired of karma fortunes by now.Uncle Robin ought to be getting tired of karma fortunes by now.Uncle Robin ought to be getting tired of karma fortunes by now.Uncle Robin ought to be getting tired of karma fortunes by now.Uncle Robin ought to be getting tired of karma fortunes by now.
 
Uncle Robin's Avatar
 
Posts: 3,499
Karma: 49052844
Join Date: Sep 2019
Location: in my mind
Device: Kobo Sage; Kobo Libra H2O
Awesome, thanks for that!
Uncle Robin is offline   Reply With Quote
Old 08-16-2024, 11:56 AM   #12
Goldbucket
Junior Member
Goldbucket began at the beginning.
 
Posts: 5
Karma: 10
Join Date: Feb 2023
Device: Kobo Clara HD, Kobo Libra Colour
An chance to get this working, if the sidecar folders are stored in a different place (./docsettings). It's not about an SD Card, just the KOReader setting to prevent them from appearing in Nickel.
Goldbucket is offline   Reply With Quote
Old 08-25-2024, 01:51 PM   #13
Leilu
Member
Leilu began at the beginning.
 
Posts: 22
Karma: 10
Join Date: Feb 2023
Device: Kindle Oasis 3 / Kobo Libra 2
Thank you for taking over the development.
I've always wanted to be able to synchronize my reading progress on KOReader from Calibre but it's never worked. I'll give it a try.

Edit:

It's working. Thank you. I now have a way to transfer my reading progress if my e-reader breaks down.

I have several improvement ideas:
1- Add the possibility to sync the KOReader history with Calibre.
2- Improve the synchronization interface. With my 1,295 books, it's impossible to scroll to find the one that was successfully synchronized. Perhaps it would be better to sort or filter this sync screen. Maybe with only the synchronized one at the top or even hide all the others with the option to open a json log file for more details.
3- Add the ability to sync tags in both directions to take advantage of KOReader's new collections feature.
4- Add a progress bar to sync. Calibre that freezes for several tens of seconds is not very reassuring.

Last edited by Leilu; 08-26-2024 at 05:36 AM. Reason: feedback
Leilu is offline   Reply With Quote
Old 11-22-2024, 02:28 PM   #14
kyx84
Member
kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.
 
Posts: 18
Karma: 368
Join Date: May 2024
Location: North America
Device: Kobo Clara BW + Koreader
Quote:
Originally Posted by Leilu View Post
I have several improvement ideas:
1- Add the possibility to sync the KOReader history with Calibre.
2- Improve the synchronization interface. With my 1,295 books, it's impossible to scroll to find the one that was successfully synchronized. Perhaps it would be better to sort or filter this sync screen. Maybe with only the synchronized one at the top or even hide all the others with the option to open a json log file for more details.
3- Add the ability to sync tags in both directions to take advantage of KOReader's new collections feature.
4- Add a progress bar to sync. Calibre that freezes for several tens of seconds is not very reassuring.
all question/issues were submitted vial Github and tracked there if interested

Last edited by kyx84; 12-05-2024 at 09:57 PM. Reason: typo fix
kyx84 is offline   Reply With Quote
Old 11-22-2024, 02:29 PM   #15
kyx84
Member
kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.kyx84 has a complete set of Star Wars action figures.
 
Posts: 18
Karma: 368
Join Date: May 2024
Location: North America
Device: Kobo Clara BW + Koreader
v0.6.8

What's Changed
New Contributors
Full Changelog: https://github.com/harmtemolder/kore...0.6.7...v0.6.8
kyx84 is offline   Reply With Quote
Reply

Tags
calibre, kobo, koreader, plug-in, plugins


Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
[GUI Plugin] Goodreads Sync kiwidude Plugins 1776 12-19-2024 04:18 PM
[GUI Plugin] Skoob Sync thiago.eec Plugins 25 09-16-2024 09:51 AM
[GUI Plugin] BookFusion Cloud Sync skillachie Plugins 58 04-29-2023 03:42 AM
[GUI Plugin] KyBook3 Sync - replaced karl1c Plugins 45 04-23-2021 07:33 PM
[Gui Plugin] Cloud Sync kerimlcr Plugins 13 03-06-2018 06:13 AM


All times are GMT -4. The time now is 04:12 AM.


MobileRead.com is a privately owned, operated and funded community.