BookBridge does not automatically recognize books downloaded from CWA via OPDS in KOReader

[Thomase004]

Hi everyone,

I’m trying to set up BookBridge with Calibre-Web Automated (CWA) and KOReader on a Kindle Paperwhite 2. Most of the setup is working, but I’m stuck on one issue: books downloaded directly from CWA via OPDS are not automatically recognized by BookBridge.

My setup:
Synology NAS (DS220+)
Calibre-Web Automated (CWA) 4.0.8
BookBridge (latest Docker image)
KOReader on a Kindle Paperwhite 2
BookBridge’s BridgeSync plugin installed and connected
CWA integration configured in BookBridge
KOReader Sync enabled in CWA
Calibre library mounted in the BookBridge container at /books
Calibre Library Path in BookBridge is set to /books

What works:

1. ⁠I download a book from CWA to my Kindle using KOReader’s OPDS catalog.
2. ⁠KOReader connects to BookBridge through the BridgeSync plugin.
3. ⁠KOSync communication works.
4. ⁠If I manually add the same book to BookBridge through the CWA integration, BookBridge can download it, create a mapping and adopt the existing KOReader document hash.
5. ⁠After that, reading progress syncs successfully between KOReader, BookBridge and CWA.

What does not work:
If I only download a book from CWA via OPDS and do not manually add it to BookBridge, BookBridge does not recognize it.

The logs show messages like:

KOSync: GET progress for doc
Document not found:
Starting filesystem search in /books for hash
Filesystem search in /books finished. Checked 572 files. No match found
Auto-discovery finished. No match found

I understood from the BookBridge documentation that when Calibre Library Path is configured, BookBridge should be able to look up unknown KOReader hashes in CWA’s book_format_checksums table. This is specifically intended to recognize books downloaded from CWA, even if CWA modifies the EPUB by embedding metadata and therefore changes its hash.

However, in my case, the book is not discovered automatically. The logs seem to show only a filesystem search, and I cannot tell whether the CWA checksum lookup is actually being performed.

My question:

Am I missing a configuration step, or is there a known issue with CWA 4.0.8 not storing the post-metadata-embedding checksums for OPDS downloads?

Ideally, I want this workflow:

• Download a book from CWA via OPDS to KOReader.
• BookBridge automatically recognizes and links the book.
• Reading progress syncs between KOReader, BookBridge and CWA.

I would really like to avoid having to manually add every book to BookBridge after downloading it from CWA.

Has anyone managed to get this working?
Thanks in advance!

[cporcellijr]

Thanks for the clear reproduction. I found a limitation in BookBridge's CWA
checksum fallback: it can recognize a downloaded copy of a book already added to
BookBridge, but it does not yet use that checksum entry to import a book that has
never been added. That explains why manually adding the CWA book makes sync work. I'll add the fix to the next release.

[Thomase004]

Thanks for your reply.

Do you need anything else?

AI helped me with this post, and without it, I would never have gotten this far or ended up here.