booklore-app/booklore v2.2.0

Release v2.2.0

on GitHub

🌟 What's New in v2.2.0

This release introduces (or brings back) two new library organization modes: Book per File and Book per Folder, giving you explicit control over how Booklore groups files into books during scanning.

When Booklore first started, the philosophy was simple: don't worry about how files are organized on disk, just scan everything and figure it out. This worked well when libraries only contained single-file formats like EPUB and PDF. But as support grew for multi-format books and multi-file audiobooks, that approach started to break down. The existing Auto-detect mode uses fuzzy filename matching and heuristics to guess how files should be grouped, and while it works in many cases, it has some real problems: files can get missed during scans, multi-file audiobooks sometimes show up as separate books (one per file), and the grouping behavior is unpredictable since it depends on how your files happen to be named.

Rather than continuing to patch Auto-detect, I'm introducing two new modes that are simple, predictable, and thoroughly-tested:

• Book per File: Every file becomes its own book. One file, one book, no guessing. This is now the default for new libraries.

• Book per Folder: Files in the same folder are grouped into a single book. Great for organized libraries with an Author/Title/ structure, and it handles multi-format books and folder-based audiobooks naturally. If you have a folder with an EPUB, a MOBI, and an audiobook/ subfolder, they all become one book.

Auto-detect is not going away. Existing libraries using it will continue to work as before. But it's now marked as legacy, and I strongly recommend switching to one of the new modes. They're simpler, more reliable, and will be the focus of ongoing development and support going forward.

You can set the organization mode when creating a new library, but cannot change it on an existing library. For a detailed breakdown of each mode with examples, check out the documentation.

🚀 New Features

• Scanner organization modes and monitoring rework (#3279) by @acx10

✨ Enhancements

• Add configurable magnifier zoom and lens size for CBX reader (#3260) (#3268) by @acx10

🐛 Bug Fixes

• Make OIDC scopes configurable (#3261) (#3265) by @acx10

🛠️ Refactoring & Maintenance

• Lock organization mode dropdown for AUTO_DETECT libraries (#3284) by @acx10
• Lock organization mode for AUTO_DETECT libraries (#3283) by @acx10
• Translations update from Hosted Weblate (#3248) by @acx10

🐳 Docker Images

• Docker Hub: booklore/booklore:v2.2.0
• GitHub Container Registry: ghcr.io/booklore-app/booklore:v2.2.0

Full Changelog: v2.1.0...v2.2.0