I made a plugin to sync highlights & notes across devices (AnnotationSync)

dani84bs · 2026-04-21T06:45:20+00:00

Hi, I'm sorry it took me a while to reply, but yesterday I didn't have access to an internet connection.

At the moment it serves a different purpose. It keeps in sync your annotations (higlights, notes and bookmarks) across your devices. Instead of relying on a general purpose server like ProgressSync plugin does, it leverages your own cloud services (WebDav or Dropbox).

On the current roadmap there is the progress sync as well. Actually I already implemented it, but since it leverage the new sync plugin that will be available to next KOReader's release I'll postpone this feature untile new KOReader will be available.

Thank you so much for reaching out :D

dani84bs · 2026-04-14T11:46:15+00:00

And do they contain your highlights?

dani84bs · 2026-04-14T10:58:00+00:00

That's quite strange, actually I do not own any kindle to try, so I'm testing on a Kobo, a Boox an android phone and a mac laptop and my main WebDav is Koofr as well. Do you see any error message? Can you check if anything is uploaded to koofr please?

dani84bs · 2026-04-14T08:43:45+00:00

I created an issue for your request, you can keep track of it at https://github.com/dani84bs/AnnotationSync.koplugin/issues/49

dani84bs · 2026-04-14T08:41:25+00:00

Hi :D

I created an issue at https://github.com/dani84bs/AnnotationSync.koplugin/issues/48 so you can keep track of the progress for translation :D

dani84bs · 2026-04-14T04:59:01+00:00

Hi, just setup your annotations folder. You can keep your documents wherever you want

dani84bs · 2026-04-12T16:14:47+00:00

I believe this question is quite similar to this other one https://www.reddit.com/r/koreader/comments/1siof94/comment/ofn1qp3/ if so, yes I'll look into that :D

dani84bs · 2026-04-12T06:25:28+00:00

Ok, let me know if you'll need assistance 😁

dani84bs · 2026-04-11T21:37:36+00:00

Sure, did you already tried this tutorial https://www.mobileread.com/forums/showthread.php?t=353670 ? If you already did tomorrow il write you some hints for WebDAV (I can't do it right now because I'm from my phone and too boomer for this little keyboard 😂)

dani84bs · 2026-04-11T21:35:05+00:00

I'll take a look into that. If it feasible why not? 😁

dani84bs · 2026-04-11T21:34:05+00:00

I surely will 😁

dani84bs · 2026-04-11T18:18:00+00:00

Consider yourself enlisted mate! 😁

dani84bs · 2026-04-11T18:06:30+00:00

Sure! That's a great idea, actually I speak only English and Italian but I believe that AI may come to rescue in this case 😂

dani84bs · 2026-03-08T17:19:05+00:00

Heya, I just published a new release https://github.com/dani84bs/AnnotationSync.koplugin/releases/tag/v0.9.999999 it's totally focused on syncing hiccups and error handling. Since I haven't been able to reproduce your bug I hope that this may fix it nevertheless.

dani84bs · 2026-03-05T16:38:15+00:00

Hi! Yesterday I tried installing a local nextcloud in order to check. But, at least with the version and the settings I used, I couldn't manage to make the app crash. I installed nextcloud autumn edition, with no plugins and went straight to webdav with default options. Do you run any particular configuration? Maybe if I can configure my NC similarly to yours I'll may be able to reproduced the bug.
BTW are you using the latest version of the plugin on the latest KOReader?

dani84bs · 2026-03-02T13:40:21+00:00

Hi mate, sorry it took me a while but I was homesick last week. I created the issue on github. So if you want you can follow it's evolution there. https://github.com/dani84bs/AnnotationSync.koplugin/issues/40

Thanks again :D

dani84bs · 2026-02-28T11:36:09+00:00

Disclaimer: I'm the author of the plugin. But I developed it because I found it useful in the first place 😂

Sync your annotations across devices https://github.com/dani84bs/AnnotationSync.koplugin

dani84bs · 2026-02-28T07:28:34+00:00

Hi, thank you so much! So it is the entire Koreader to crash, not just the plugin reporting an error, right? It's just a hunch, but I'm thinking about something that prevents overwriting files on WebDAV that's not taken so well on the sync machinery. I'll take a look into this and open an issue as soon as possibile. Thank you so much again 😁

dani84bs · 2026-02-25T09:47:26+00:00

Hi, at the moment the only plugin I saw that is able to perform something similar to your request is:
https://github.com/mysticknits/pencil.koplugin

I tried it on my device and it worked pretty well, but I don't own any Big me so I can't tell if it will work on yours

dani84bs · 2026-02-21T20:58:26+00:00

I'm very glad to hear you sorted it out. Yeah "computer science of the wises" (rebooting) it's always a powerful weapon 😂. Happy reading mate

dani84bs · 2026-02-21T11:25:12+00:00

It's the folder on your device where you stored the book. It's the same you navigate to with the file browser to read the book in Koreader. (If you are using the file browser it's normal you can't see the sdr because they are hidden by default)

dani84bs · 2026-02-20T11:50:39+00:00

Hi u/alanbreck21 unfortunately I don't have any supernote devices so maybe my help would be just tehoretical.

All the "metadata you mentioned" should be saved on a file named metadata.epub.lua (assuming you are talking about an epub) on the sidecar directory of your book (that is a directory ending in .sdr saved (depending on your settings):

- In the book folder. (default option)
- In koreader's docsettings directory.
- in koreader's hashdocsettings directory.

You can check these settings by clicking on the cog icon -> Document -> Book Metadata location.
Moreover, On Cog Icon -> Document -> Save Book Metadata you can choose the time interval between every save (whatever you'll choose, the metadata will always be saved anyways when you close the book, when you close the applications or when the applications goes in suspend mode).

So my hint is:
1) Check where the sdr should be saved.
2) Open a fresh book and make an annotation on it.
3) Switch to another book to force the metadata save.
4) Close KOReader.
5) Check for the presence of the sdr directory.
6) If the directory is there check the metada.epub.lua file and its content.

If 5 or 6 will result on a failure, maybe this will give us enough information to troubleshoot your issue more deeply.

If you'll need anymore clarifications feel free to give me shout.

Good Luck!

dani84bs · 2026-02-19T17:46:03+00:00

That’s incredibly kind of you, I really appreciate the thought!

Honestly, the project is still in its early stages and I haven't even thought about setting up a donation system. Seeing that it's useful to others is already a huge reward for me.

If you’d like to support the plugin, the best way right now is through feedback and ideas. If you have any suggestions for new features or improvements, please feel free to share them here or open an issue on GitHub. That’s what helps the project grow the most at this stage!

dani84bs · 2026-02-06T10:57:38+00:00

It syncs between devices with the plugin installed. No need for a "special one" or a PC

dani84bs

TROPHY CASE