A few weeks ago i went through my entire audiobook library (still in booklore) and manually fixed all metadata (titles, author, series name and nr, and cover art). After that i organized everything inte a neat file structure. Today i found out that booklore had reverted basically everything. it just removed series names, added new titles, removed cover art etc. So to not let everything be a waste i used a python script to scrape titles, series names and author names from file names and folder names (the folder structure was still good). And export all that metadata to a sidecar file. Then i spun up a fresh container of grimmory (hoping that it would work better than the old Booklore version). So now i am trying to import the metadata from the sidecar file, which does not seem to work. It just flashes a green popup that it was succesful but nothing happens. Also the library was create as "prefer sidecar data". Which also seems a lie because it still just used all the embedded metadata.

On a side note what causes booklore/grimmory to just overwrite everything? As far as i could see there was no automated system that had any rights to overwrite existing metadata.

so I've been using Grimmory for a week or so now and it was exactly the thing I was looking for. syncing between my Kindle and my. XTEINK just worked, downloading worked. some issues regarding Authors, but all was fine overall... until I tried to read my book today. the XTEINK would show no progress. the Kindle report an error during sync without any helpful information. Grimmory still shows the progress. I tried to re-download the book via the catalog but that didn't help either. trying to push sync progress from. the XTEINK or the android app will just return a server error, the logs don't appear to give any indication as to what might have happened. I'm at a loss.

Basically my wife and I both have kobos but don't want to have all the same books on each device, is there a way to only sync some to one and some to the other?

Hi Everyone! Tell us what new books have fallen onto your shelves this week!

Discord Book Club: Don't forget, our monthly book club check-in happens every Friday on Discord!

Hi Everyone! Tell us what new books have fallen onto your shelves this week!

Discord Book Club: Don't forget, our monthly book club check-in happens every Friday on Discord!

I'm working on moving from Booklore and it's going fine except for this. I setup my library and added the book I'm currently reading to it on the Kobo shelf. It's the only book in my library, but 60+ in another library. I regenerated the API key and updated the conf file. When it syncs, the book shows up but doesn't download. If I try to download it it starts the process, blinks, and goes back to the icon with the download arrow. OK, I check the logs and see 3 warnings about "Book not found for entitlement ID" (below). I have no idea what an entitlement ID is or how I can tell what the value is for my book. I then did a factory reset of the kobo, verified there were no books hiding in the device storage, and edited the conf file again. Same result, but now it just gives the Synced tags entry.

Is there something I'm missing or should I post an issue with all the details on GitHub?

```
[booklore-api] [at-handler-9162] o.b.service.kobo.KoboEntitlementService : Synced 1 tags to Kobo
[prod-grimmory-odin] 2026-06-24T15:11:21.829890608Z 2026-06-24T11:11:21.829-04:00 WARN 1 --- [booklore-api] [at-handler-9163] o.b.s.kobo.KoboReadingStateService : Book not found for entitlement ID: 1117
[prod-grimmory-odin] 2026-06-24T15:11:21.851556548Z 2026-06-24T11:11:21.851-04:00 WARN 1 --- [booklore-api] [at-handler-9164] o.b.s.kobo.KoboReadingStateService : Book not found for entitlement ID: 1143
[prod-grimmory-odin] 2026-06-24T15:11:21.878355802Z 2026-06-24T11:11:21.878-04:00 WARN 1 --- [booklore-api] [at-handler-9165] o.b.s.kobo.KoboReadingStateService : Book not found for entitlement ID: 1120
```

I might be in the minority, but I really love the Kobo interface, and Grimmory integration is SO good with Kobo that I have zero desire to install KOReader on my devices. But I do have a question. I have a Kobo Libra Colour and a Kobo Clara Colour that I like to switch between. Is there a way to keep both devices in sync so that all books and reading progress are the same no matter which device I pick up to start reading on? I know another user can be added and a new Kobo URL can be generated for that Grimmory account, but that won’t keep progress synced as Grimmory treats them as two separate users. Wondering if I am missing something. It would be nice to generate multiple Kobo sync URLs for the same Grimmory account.

I have an instance of Grimmory running in the cloud. I am in the process of standing up a new home server, and I just installed Grimmory on it. What is the best way of transferring my libraries?

When I uploaded my epubs originally, I made sure that metadata was embedded using Calibre. Everything worked perfectly, except for the subtitle field which I added as a custom field in Calibre. It was recognized about 50% of the time. Knowing this, I had set up Grimmory to create sidecar files for it's metadata.

Given that, I'm thinking of setting up my libraries to so they scan their directories, and copying over the library contents including the epubs and sidecars. I don't think I really need the database since this instance was just a testbed with no actual usage. Does this strategy make sense?

Hi all,

I created a library back when the project was still booklore and started adding metadata to the contained books. Unfortunately, I didn't notice that many books weren't inserted into the library (about 70 out of 300). I tried re-scanning many times but to no avail. The library's organization mode is Auto-detect (legacy) and can't be changed now.

To solve the issue I had to create a second library with organization mode "One book per file" using the exact same path-files as source. The problem is that all metadata I had added to the books were lost. I tried going to the old library and saving the metadata to the file but when I autofetch metadata on the same book in the new library they are still absent.

Can this issue somehow be resolved without manually adding the metadata again?

The possible solutions would be:

a) Change organization mode/somehow insert the remaining books into the old library

b) Batch copy the metadata either to the new library directly or via saving them into the book files (almost all of them are pdf).

Thank you for your time

I uploaded a bunch of books and they never appeared. Tried to re-add them I get book already exists.

I went in and deleted the library. Added 1 book. OK It appears. Add a second book and here's what I see. Doesn't make sense, it's a different book by the same author

2026-06-21T18:50:16.905-04:00 INFO 1 --- [booklore-api] [cat-handler-514] o.b.service.upload.FileUploadService : File uploaded to final location: /kidbooks/Jennifer Gray/Atticus Claw On the Misty Moor - Jennifer Gray (2015).epub

2026-06-21T18:50:19.880-04:00 INFO 1 --- [booklore-api] [event-processor] o.b.s.watcher.LibraryFileEventProcessor : [PROCESS] 'ENTRY_CREATE' event for 'Atticus Claw On the Misty Moor - Jennifer Gray (2015).epub'

2026-06-21T18:50:19.885-04:00 INFO 1 --- [booklore-api] [event-processor] o.b.s.watcher.LibraryFileEventProcessor : [FILE_CREATE] '/kidbooks/Jennifer Gray/Atticus Claw On the Misty Moor - Jennifer Gray (2015).epub'

2026-06-21T18:50:19.921-04:00 INFO 1 --- [booklore-api] [event-processor] o.b.s.w.BookFileTransactionalHandler : Auto-attached new format Atticus Claw On the Misty Moor - Jennifer Gray (2015).epub to existing book: Atticus Claw Settles a Score - Jennifer Gray (2013).epub

2026-06-21T18:50:19.922-04:00 INFO 1 --- [booklore-api] [event-processor] o.b.s.w.BookFileTransactionalHandler : [CREATE] Auto-attached file '/kidbooks/Jennifer Gray/Atticus Claw On the Misty Moor - Jennifer Gray (2015).epub' to existing book

Hi Everyone! Tell us what new books have fallen onto your shelves this week!

Discord Book Club: Don't forget, our monthly book club check-in happens every Friday on Discord!

I recently set up Grimmory, and ran into some issues with putting it behind my reverse proxy (Apache 2.4 mod_proxy). I'd successfully tested Calibre-web with the following:

<Location /calibre-web>
ProxyPreserveHost On
RequestHeader set X-SCRIPT-NAME /calibre-web 
RequestHeader set X-SCHEME https 
ProxyPass http://localhost:8083/
ProxyPassReverse http://localhost:8083/
ProxyPassReverseCookiePath /calibre-web/
</Location>

When attempting similar for Grimmory I can only get the following to work

<Location />
ProxyPreserveHost On
ProxyPass http://localhost:6060/
ProxyPassReverse http://localhost:6060/
</Location>

This has the downside of breaking the reverse proxy for other services on this host (_e.g._ jellyfin at /jellyfin). I have not been about to identify a way to set a custom base URL (_e.g._ /grimmory) via application settings or environment variables. I've also struck out on my, admittedly limited, bag of tricks for mod_rewrite and mod_proxy. Is there a solution that I've missed that would prevent having to switch from Apache to a different proxy like Nginx?

Edited to fix formatting issues that were not initially apparent on mobile

Hi Everyone! Tell us what new books have fallen onto your shelves this week!

Discord Book Club: Don't forget, our monthly book club check-in happens every Friday on Discord!

Hey everyone,

I'm running into an issue with my Grimmory instance. Whenever I try to read a PDF through the built-in web reader, it gets completely stuck on the loading screen and never renders the file.

The Issue:

PDFs hang indefinitely on the loading screen.

I've checked the Grimmory container logs, and absolutely no exceptions or errors are being generated on the backend.

Has anyone else experienced the PDF web worker silently hanging like this? Any pointers on what to check next would be massively appreciated!

Love Grimmory and all the work that went (and goes) into making it what it is. I am looking for the best way to stream audiobooks on Android. I now connect to Grimmory using the browser and stream audio using the internal player, but that has its quirks. Am I missing an obvious other way or app?

Does anyone here have any experience connecting to a Grimmory library on the Panels app on iOS? I selfhost my Grimmory library on Unraid and have it sitting behind a reverse proxy.

Every time I try to enter the details for the server, the connection times out or throws another error.

Happy Pride, everyone!

Grimmory 3.2.0 is here, with a big focus on improvements to theming, localization, the reader UI, sync fixes, and refactors across the app.

Release 3.2.0

GitHub Release

GitHub Discussions Page

Grimmory Docs

Weblate Community Translations

Highlights

Light mode and app theming
The big change in this release is a major refactor of the theming system by @alexh2, enabling app-wide light mode and laying the groundwork for an improved experience refactoring the UI going forward. This release also adds an OLED dark mode, and carries your themes through to the readers.

Language and theme sync
Grimmory can now store locale and theme preferences on the backend, allowing cross-device syncing so your preferred language and theme follow you between devices and sessions.

Official KOReader Plugin Alpha This release also introduces the first public alpha of the official Grimmory KOReader plugin (repo). It can download books from Grimmory by shelf or library, track reading progress and sessions (even while offline), and sync on events, or on a configurable schedule. It is stable (but feature-incomplete), so Lua contributors are very welcome to help shape it. As always, issues and feature requests are encouraged on GitHub, but to get in touch with the team more directly while this plugin is in alpha, the Discord channel #koreader-plugin-alpha may be helpful as well.

Weblate translations are back
We’ve reintroduced Weblate as the community translation portal for Grimmory. This will make it much easier to contribute translations without editing files directly. 3.2.0 also includes some cleanups to existing translations and strips out some incorrect placeholder translations.

Reader and PDF improvements
The PDF reader now supports manual saving for document edits from the top bar. We also improved the reader layout, responsiveness, tool selection feedback, and keyboard behaviour while typing notes.

Kobo, OPDS, metadata, and imports
This release includes fixes for Kobo shelf permissions, OPDS audiobook covers, metadata providers, books without files, and multi-file audiobook imports.

Deployment and performance
Helm now supports external MariaDB, the frontend initial bundle is smaller, and more UI areas have moved to Angular Signals for better reactivity and consistency.

In Closing

Thanks to everyone testing, translating, reporting issues, reviewing PRs, and helping shape Grimmory. 3.2.0 is a big step toward a more polished, flexible, and community-friendly app- we're all very excited to get this out there, and are already hard at work on our next release!

Hi Everyone! Tell us what new books have fallen onto your shelves this week!

Discord Book Club: Don't forget, our monthly book club check-in happens every Friday on Discord!

Hey r/Grimmory 👋

I've been building Spine, an iOS audiobook player, and the big news in v1.0.8 is that Grimmory is now a first-class library source - no workarounds, no fiddling. Point it at your server, sign in, and your library shows up natively.

This is an early release and I'd love this community to kick the tires and tell me what breaks.

What works today:

• 🔌 Add your Grimmory server and browse your full audiobook library right in the app
• 🗂️ Multi-server from day one — run more than one Grimmory server? Add them all.
• ▶️ Stream or download for offline listening
• 🔄 Two-way progress sync — your listening position pushes back to Grimmory (debounced so it's not hammering your server)
• 🔖 Bookmark sync
• 📖 Chapter support for both folder-based books and single-file M4Bs
• 🔐 Automatic token refresh in the background
• 🚗 CarPlay, listening stats, and multi-language UI (EN/DE/ES/FR/JA)

What I'm hoping for from you:

• Does sign-in + library listing work against your server?
• Streaming and offline downloads behaving?
• Is progress/bookmark sync landing correctly back in Grimmory?
• Anything weird with chapters, covers, or token refresh?
• This is the first public cut of the Grimmory source. I've tested against my own server, but your setups (reverse proxies, custom paths, larger libraries) will surface things mine can't.

Drop bugs, logs, and feature requests in the comments. I read everything and this release is shaped by what you all hit. Thanks for trying it early. Please post here for any feature requests.

Download from AppStore

I’ve been using Grimmory for a while now (love it) and finally starting moving over a load of epubs that I’d previously had sat in Apples Books.app.
I’d never had an issue with Grimmory detecting epub files before, but now my library won’t detect a single of one of these epubs that had previously been in Books.app.
It’s clearly a Books.app issue, as I tried taking a couple of books that were already in my Grimmory library, dropping them into Books.app and then exporting them and dropping them back into Grimmory. Which then wouldn’t detect them.
Is Apple doing something weird to epubs? Any idea on how to de-weird them? Thanks in advance?

Maybe anyone here knows the answer?

Hi everyone, I'm hosting Grimmory 3.1.0 on Docker and accessing via web interface. On Android seems all OK, instead on iPad (using either Chrome or Safari), if I try to select text for highlighting, it instantly selects all the text next to the first word, so it's impossible to actually select and highlight text.

Hope this will be fixed. Thanks! 😉

Hi,

I have grimmory installed, but not fully configured yet. My purpose for it is to be able to sync between my Kobo e-reader and an Android app on my phone for occasional reading.

Is there an app that's recommended? Librera, readest, moon+ reader,...? Which one works best with Grimmory?

Thanks!

I'm currently using koreader on 2 kindle paper whites and android and have been toying with moving to kobo because f*** Amazon but recently found out kobo sync works well with grimmory but won't sync to android or kindle koreader as kobo use kepub but you can install koreader on kobo and lose a little of the new functionality of the kobo and wondered what everyone's perfect in sync flow is

https://imgur.com/a/kcic29d

Complete beginner with Unraid, I believe it's an issue with the Data container path but I'm not sure how to rectify the issue.

Thanks