[GUI Plugin] Annotations

[benweasel]

Hi and thanks in advance for your time and patience.
I'm using a Pocketbook PB634 on Calibre 8.8 - I manage to load books with no issues at all but I'm unable to fetch annotations from the books. This is the error I get

Eccezione non gestita stands for "Unmanaged exception"

calibre, version 8.8.0
ERRORE: Eccezione non gestita: <b>UnboundLocalError</b>:cannot access local variable 'finish' where it is not associated with a value

calibre 8.8  embedded-python: True
macOS-15.5-arm64-arm-64bit Darwin ('64bit', '')
('Darwin', '24.5.0', 'Darwin Kernel Version 24.5.0: Tue Apr 22 19:54:26 PDT 2025; root:xnu-11417.121.6~2/RELEASE_ARM64_T8112')
Python 3.11.12
OSX: ('15.5', ('', '', ''), 'arm64')
Interface language: it
EXE path: /Applications/calibre.app/Contents/MacOS/calibre
Successfully initialized third party plugins: Annotations (1, 17, 13) && Find Duplicates (1, 10, 9) && Goodreads (1, 8, 3) && Goodreads Sync (1, 16, 11) && PocketBook Improved Device Interface (1, 0, 4) && Pocketbook Collections (1, 2, 6)
Traceback (most recent call last):
  File "calibre_plugins.annotations.action", line 363, in fetch_usb_connected_device_annotations
    self.fetch_usb_device_annotations(self.get_connected_device_primary_name())
  File "calibre_plugins.annotations.action", line 407, in fetch_usb_device_annotations
    annotated_book_list = self.get_annotated_books_on_usb_device(reader_app)
                          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "calibre_plugins.annotations.action", line 624, in get_annotated_books_on_usb_device
    ra.get_active_annotations()
  File "/var/folders/q5/z79z5dzx1fl4b8fv0ws2z38r0000gn/C/calibre-p0rdivjv/calibre_annotations_plugin/PocketBook.py", line 62, in get_active_annotations
  File "/var/folders/q5/z79z5dzx1fl4b8fv0ws2z38r0000gn/C/calibre-p0rdivjv/calibre_annotations_plugin/PocketBook.py", line 344, in _fetch_annotations
  File "/var/folders/q5/z79z5dzx1fl4b8fv0ws2z38r0000gn/C/calibre-p0rdivjv/calibre_annotations_plugin/PocketBook.py", line 419, in _read_database_annotations
UnboundLocalError: cannot access local variable 'finish' where it is not associated with a value

Tried searching in the forum but no success so far. Any clues?

Thanks

[dunhill]

I think the clue is here:
UnboundLocalError: cannot access local variable 'finish' where it is not associated with a value
This means that within the Annotations plugin (specifically in the plugin's PocketBook.py file), there is a variable called finish that the code attempts to use, but it was never defined in certain cases.

[kuttan]

Dear all

I am the below error when i installed the annotation plugin in Calibre and get annotation.

I have setup new filed in calibre for pulling annotations. I have connected Kobo Libre Color. Please suggest.

Thank you.

calibre, version 8.10.0
ERROR: Unhandled exception: <b>TypeError</b>:'str' object is not callable

calibre 8.10  embedded-python: True
Linux-6.15.1-surface-2-x86_64-with-glibc2.36 Linux ('64bit', 'ELF')
('Linux', '6.15.1-surface-2', '#2 SMP PREEMPT_DYNAMIC Tue Jun 24 21:02:07 UTC 2025')
Python 3.11.12
Interface language: None
EXE path: /opt/calibre/bin/calibre
Successfully initialized third party plugins: Annotations (1, 17, 13) && Kobo Utilities (2, 24, 3)
Traceback (most recent call last):
  File "calibre_plugins.annotations.action", line 363, in fetch_usb_connected_device_annotations
    self.fetch_usb_device_annotations(self.get_connected_device_primary_name())
  File "calibre_plugins.annotations.action", line 407, in fetch_usb_device_annotations
    annotated_book_list = self.get_annotated_books_on_usb_device(reader_app)
                          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "calibre_plugins.annotations.action", line 624, in get_annotated_books_on_usb_device
    ra.get_active_annotations()
  File "/tmp/calibre-zng_zxr5/calibre_annotations_plugin/KoboTouch.py", line 72, in get_active_annotations
  File "/tmp/calibre-zng_zxr5/calibre_annotations_plugin/KoboTouch.py", line 378, in _fetch_annotations
TypeError: 'str' object is not callable

[cerebrollywood]

Hello everyone,

thanks to anyone involved in the making and sharing of this plugin. I'm not a tech savvy person but you this whole thread helped me retrieving my highlights and save them in Calibre (FINALLY!!!).

I do have a question, though. Now that the plugin created the custom column with the Annotations, how do I "import" them on a secondary device?

I have two Kobo, I use both of them to read depending if I'm out and about or just at home chilling. Through the KoboUtilities plugin I managed to sync the reading point between books. I was hoping to sync the highlights/annotations using this plugin. Is that possible? If so, how should I do it? So far, nothing I tried was successful (again, not very techy!)

Thank you so much

[aik099]

Originally Posted by kuttan

Dear all

I am the below error when i installed the annotation plugin in Calibre and get annotation.

I have setup new filed in calibre for pulling annotations. I have connected Kobo Libre Color. Please suggest.

Thank you.

calibre, version 8.10.0
ERROR: Unhandled exception: <b>TypeError</b>:'str' object is not callable

calibre 8.10  embedded-python: True
Linux-6.15.1-surface-2-x86_64-with-glibc2.36 Linux ('64bit', 'ELF')
('Linux', '6.15.1-surface-2', '#2 SMP PREEMPT_DYNAMIC Tue Jun 24 21:02:07 UTC 2025')
Python 3.11.12
Interface language: None
EXE path: /opt/calibre/bin/calibre
Successfully initialized third party plugins: Annotations (1, 17, 13) && Kobo Utilities (2, 24, 3)
Traceback (most recent call last):
  File "calibre_plugins.annotations.action", line 363, in fetch_usb_connected_device_annotations
    self.fetch_usb_device_annotations(self.get_connected_device_primary_name())
  File "calibre_plugins.annotations.action", line 407, in fetch_usb_device_annotations
    annotated_book_list = self.get_annotated_books_on_usb_device(reader_app)
                          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "calibre_plugins.annotations.action", line 624, in get_annotated_books_on_usb_device
    ra.get_active_annotations()
  File "/tmp/calibre-zng_zxr5/calibre_annotations_plugin/KoboTouch.py", line 72, in get_active_annotations
  File "/tmp/calibre-zng_zxr5/calibre_annotations_plugin/KoboTouch.py", line 378, in _fetch_annotations
TypeError: 'str' object is not callable

This question has been answered before in https://www.mobileread.com/forums/sh...postcount=1214 .

[aik099]

Originally Posted by cerebrollywood

Hello everyone,

thanks to anyone involved in the making and sharing of this plugin. I'm not a tech savvy person but you this whole thread helped me retrieving my highlights and save them in Calibre (FINALLY!!!).

I do have a question, though. Now that the plugin created the custom column with the Annotations, how do I "import" them on a secondary device?

I have two Kobo, I use both of them to read depending if I'm out and about or just at home chilling. Through the KoboUtilities plugin I managed to sync the reading point between books. I was hoping to sync the highlights/annotations using this plugin. Is that possible? If so, how should I do it? So far, nothing I tried was successful (again, not very techy!)

Thank you so much

No. This plugin can only write annotations into Calibre from the Device. Not write them back to Device.