🌟 What's New in v1.10.0

This release bring dashboard customization, letting you configure scrollers using magic shelves, providing a more personalized and dynamic home experience.

🚀 New Features

• Add configurability to dashboard scrollers with support for magic shelves(#1453) by @adityachandelgit
• Show a generated cover for books which are missing a cover image (#1438) by @cjd

✨ Enhancements

• Add Book Type (epub, pdf, etc.) to sidebar filter (#1464) by @adityachandelgit
• Add filter by “Last Read Time” to Magic Shelf (#1462) by @adityachandelgit

🐛 Bug Fixes

• fix: tie book uploading topbar item to upload book permission (#1459) by @heyitsbench
• Fix: Cannot delete user after KOReader setup (#1454) by @adityachandelgit
• Fix Cleanup Temporary Metadata task (#1435) by @adityachandelgit
• Fix: Resolved “Book archive too large to cache” error (#1434) by @adityachandelgit

🛠️ Refactoring & Maintenance

• chore(ui): add placeholder to published date input field (#1463) by @adityachandelgit
• refactor(api): Use try-with-resources for I/O streams and ZipFiles (#1457) by @balazs-szucs
• feat: IPv6 compatibility (#1343) by @mhymny
• refactor(api): use pre-compiled Pattern variables instead of dynamic regular expressions (#1450) by @balazs-szucs
• Fix OIDC validation in WebSocket connections (#1436) by @adityachandelgit

🐳 Docker Images

• Docker Hub: booklore/booklore:v1.10.0
• GitHub Container Registry: ghcr.io/booklore-app/booklore:v1.10.0

Full Changelog: v1.9.0...v1.10.0

📸 Screenshots

🌟 What's New in v1.9.0

This release brings the task scheduling system, enabling users to schedule background tasks for metadata updates, library scans, and other automated operations.

Additionally, the Swagger API endpoints are fully accessible when running Booklore in a Docker container, e.g., https://booklore.mydomain.com/api/v1/swagger-ui/index.html.

This update also fixes the Bulk Metadata Editor and File Organizer/Mover features.

🚀 New Features

• Implement task scheduling system (#1427) by @adityachandelgit
• Add the /api prefix to the Swagger endpoints so it works correctly be… (#1418) by @adityachandelgit

✨ Enhancements

• Improve EPUB cover replacement for EPUB 2/3 and ensure covers display correctly on client devices (#1428) by @adityachandelgit
• fix: use local storage for oauth (#1421) by @twsouthwick
• Fix: support non-ASCII filenames in Content-Disposition (#1405) by @vhqkze
• Refactor file mover to ensure faster transfers and more reliable hand… (#1406) by @adityachandelgit

🐛 Bug Fixes

• Recompute fingerprint after cover update to ensure consistency (#1429) by @adityachandelgit
• Re-enable ForwardAuth and have ForwardAuth work using email address (#1426) by @cjd
• Fix: bulk metadata editor not working (#1415) by @adityachandelgit
• Secure /media endpoints behind authentication tokens (#1407) by @adityachandelgit

🛠️ Refactoring & Maintenance

• add: .gitattributes for building on windows (#1422) by @twsouthwick

📖 Documentation

• docs: added example for rootless podman quadlet deployment (#1389) by @GianniBYoung

🐳 Docker Images

• Docker Hub: booklore/booklore:v1.9.0
• GitHub Container Registry: ghcr.io/booklore-app/booklore:v1.9.0

Full Changelog: v1.8.1...v1.9.0

📸 Screenshots

🌟 What's New in v1.8.1

🐛 Bug Fixes

• Fix: xml error with opds in moon reader (#1396) by @adityachandelgit

🐳 Docker Images

• Docker Hub: booklore/booklore:v1.8.1
• GitHub Container Registry: ghcr.io/booklore-app/booklore:v1.8.1

Full Changelog: v1.8.0...v1.8.1

🌟 What's New in v1.8.0

• In this release, all OPDS endpoints have been consolidated into a single unified endpoint: /api/v1/opds.
  Please migrate as soon as possible, as the legacy endpoints /api/v2/opds and /api/v1/opds/catalog are now deprecated and no longer functional.

• The new /api/v1/opds endpoint also introduces navigational feeds, providing a smoother and more intuitive way to browse books.

🚀 New Features

• Consolidate OPDS endpoints and implement structured navigation feeds (#1375) by @adityachandelgit

🐛 Bug Fixes

• Fix: preserve genre list when adding multiple genres (#1386) by @adityachandelgit
• Replace hardcoded Amazon domains with configurable value from AppSett… (#1385) by @adityachandelgit
• Fix: update read status correctly when multiple items are selected in… (#1382) by @adityachandelgit
• Fix hardcoded OIDC mapping (#1371) by @zacxihu
• Fix shift+click selection range handling in grid view (#1381) by @adityachandelgit

📖 Documentation

• Add reference link to OIDC documentation (#1376) by @adityachandelgit

🐳 Docker Images

• Docker Hub: booklore/booklore:v1.8.0
• GitHub Container Registry: ghcr.io/booklore-app/booklore:v1.8.0

Full Changelog: v1.7.0...v1.8.0

📸 Screenshots:

🌟 What's New in v1.7.0

This release introduces Email V2, allowing users to set up their own email providers and recipients.
Admins can also optionally share email providers with other users, which is useful in multi-user environments where centralized configuration is preferred.

⚠️ Note: The old email system has been removed. Email features will not work until you migrate to Email V2.

Additionally, this update includes several UI improvements, including a refreshed login screen, an enhanced Library Creator with multi-folder selection, and visual refinements to the top bar for a smoother overall experience.

🚀 New Features

• Implement Email V2 with support for user-specific providers and recip… (#1352) by @adityachandelgit

✨ Enhancements

• Allow admins to optionally share email providers with users (#1359) by @adityachandelgit
• Optimize and refine how book similarity is calculated (#1356) by @adityachandelgit
• Automatically set KOReader ‘Finished On’ date when reading progress reaches 99.5%. (#1353) by @adityachandelgit
• Add Moods and Tags to Bulk Metadata Updater (#1339) by @adityachandelgit

🎨 UI Tweaks

• Improve login and initial user setup screen appearance (#1336) by @adityachandelgit
• Enhance Library Creator UI/UX with multi-folder selection via checkboxes (#1333) by @adityachandelgit

🐛 Bug Fixes

• Fix: make paginated arrows visible on dark backgrounds (#1364) by @adityachandelgit
• Restrict access to Bookdrop and Metadata Manager pages for unauthorized users (#1363) by @adityachandelgit

🛠️ Refactoring & Maintenance

• Remove obsolete Email v1 implementation (#1365) by @adityachandelgit
• Unify TasksV1 and TasksV2 implementations (#1358) by @adityachandelgit
• Fixes tab pluralization (#1334) by @mocha

📦 Dependencies

• Update Angular dependencies to latest versions (#1366) by @adityachandelgit

🐳 Docker Images

• Docker Hub: booklore/booklore:v1.7.0
• GitHub Container Registry: ghcr.io/booklore-app/booklore:v1.7.0

📸 Screenshots

Full Changelog: v1.6.0...v1.7.0

🌟 What's New in v1.6.0

• 🏷️ Metadata Manager: Take Complete Control of Your Library
  Master your library's organization with powerful bulk editing tools! Clean up inconsistencies, merge duplicates (like "Sci-Fi" and "Science Fiction"), and standardize metadata across Authors, Genres, Moods, Tags, Series, Publishers, and Languages. Full Documentation

• 🔧 System Task Manager: Automated Library Maintenance
  Keep your library running smoothly with automated maintenance! Monitor background tasks in real-time with live WebSocket updates, clear CBX and PDF caches to free up disk space, and refresh metadata from library files with flexible "Replace Missing Only" or "Replace All" options. Full Documentation

• 📱 CBX Reader Improvements:
  The CBX reader now includes a new Fit Mode feature, allowing you to fit pages by height, width, or original size. It also supports pagination and continuous virtual scrolling for a smoother reading experience.

🚀 New Features

• Add task management panel with live task status and controls (#1322) by @adityachandelgit
• Add Metadata Manager for organizing and standardizing metadata (#1312) by @adityachandelgit
• Add “Fit Mode” and “View Mode” options to CBX reader (#1327) by @adityachandelgit

✨ Enhancements

• Fix: move “Save” button below “Specific Overrides” section to clarify… (#1325) by @adityachandelgit
• Add support for Moods and Tags in Magic Shelves (#1324) by @adityachandelgit
• Support moods and tags in Bookdrop metadata picker (#1306) by @adityachandelgit

🐛 Bug Fixes

• Fix: Restrict book downloads in PDF viewer for users lacking download… (#1326) by @adityachandelgit
• Include moods and tags in bulk lock action (#1305) by @adityachandelgit
• Fix browser freezing when downloading large files (#1304) by @adityachandelgit
• Fix: Allow multiple users to add the same book to their shelves witho… (#1297) by @adityachandelgit

🛠️ Refactoring & Maintenance

• Improve Angular project structure and code organization (#1328) by @adityachandelgit

🐳 Docker Images

• Docker Hub: booklore/booklore:v1.6.0
• GitHub Container Registry: ghcr.io/booklore-app/booklore:v1.6.0

Full Changelog: v1.5.1...v1.6.0

📸 Screenshots

🌟 What's New in v1.5.1

🐛 Bug Fixes

• In the EPUB reader, remove swipe gestures and add auto-hiding navigat… (#1292) by @adityachandelgit
• Fix: ‘Copy missing fields’ button not functioning correctly for list-… (#1290) by @adityachandelgit
• Fix: Books publish date incorrect when moved (#1289) by @adityachandelgit
• Fix book opening issue when KOReader progress is sent (#1282) by @adityachandelgit

🛠️ Refactoring & Maintenance

• fix typo in epub-viewer component (#1283) by @SteinTokvam

📖 Documentation

• Add documentation for metadata fetch settings and correct broken link… (#1293) by @adityachandelgit

🐳 Docker Images

• Docker Hub: booklore/booklore:v1.5.1
• GitHub Container Registry: ghcr.io/booklore-app/booklore:v1.5.1

Full Changelog: v1.5.0...v1.5.1

🌟 What's New in v1.5.0

• 📚 Enhanced Metadata with Moods & Tags: Discover deeper insights with the new moods and tags metadata, now fetched directly from the Hardcover API for richer, more expressive book details. Hardcover Token Documentation

• ⚙️ Customizable Metadata Fetch Options: Take full control over your metadata imports! You can now enable or disable specific fields like ratings or subtitles to perfectly tailor what data gets pulled in.

• 🎯 Smarter Sidebar Filters: By popular demand, Genres and Authors filters are back, now joined by Moods and Tags filters for a more refined and personalized browsing experience.

• ☕ Platform Upgrade: Java 25: The project has been upgraded from Java 21 → Java 25, ensuring better performance, compatibility, and access to the latest language features.

🚀 New Features

• Add support for moods and tags in book metadata (#1262) by @adityachandelgit
• Enhance metadata options to allow skipping fields during fetch and support extended field options (#1263) by @adityachandelgit
• Sidebar filter: Restore Authors & Genres, add Moods & Tags (#1264) by @adityachandelgit
• Implement EPUB page spread feature for desktop (#1267) by @adityachandelgit

✨ Enhancements

• Feat: set reading status using Koreader Sync Plugin (#1275) by @WorldTeacher
• Improved EPUB navigation on mobile devices with swipe gestures (#1265) by @adityachandelgit

🐛 Bug Fixes

• Resolve CBX page sequence issue (#1270) by @adityachandelgit

📦 Dependencies

• Upgrade project environment to Java 25 and Gradle 9 (#1277) by @adityachandelgit

📖 Documentation

• Add OPDS setup and usage documentation (#1274) by @adityachandelgit
• Add step-by-step documentation for setting up email integration (#1273) by @adityachandelgit
• Add guide for obtaining a Hardcover API token (#1272) by @adityachandelgit

🐳 Docker Images

• Docker Hub: booklore/booklore:v1.5.0
• GitHub Container Registry: ghcr.io/booklore-app/booklore:v1.5.0

Full Changelog: v1.4.1...v1.5.0

📸 Screenshots

🌟 What's New in v1.4.1

This patch release fixes a Kobo sync bug that was causing synchronization to fail.

If you’re running Booklore behind a reverse proxy (e.g., Nginx Proxy Manager), you’ll need to update your configuration with additional buffer settings. Full details are in the Kobo Setup Documentation.

🔧 Required Proxy Settings

proxy_buffer_size 128k;
proxy_buffers 4 256k;
proxy_busy_buffers_size 256k;
large_client_header_buffers 8 32k;

🐛 Bug Fixes

• Resolve Kobo Library Synchronization Issue (#1254) by @adityachandelgit

🐳 Docker Images

• Docker Hub: booklore/booklore:v1.4.1
• GitHub Container Registry: ghcr.io/booklore-app/booklore:v1.4.1

Full Changelog: v1.4.0...v1.4.1

🌟 What's New in v1.4.0

• 📚 Cross-Library Book Movement: Move your books between different libraries with ease! The new book move UI finally supports transferring books across libraries, a highly requested feature that makes organizing your collection effortless.
• ⚙️ Library Metadata Configuration: Take control with per-library metadata settings! Configure fetching options for each library separately instead of using one global setting. Perfect for different content types or sources.
• 🔔 Enhanced Notification System: Stay informed with live progress tracking! The notification system now provides real-time updates showing exactly what's happening during metadata fetching operations.
• 🎨 Refreshed Visual Experience: Enjoy a more vibrant interface with our new collection of primary and surface colors. Your UI now has more personality and visual appeal.
• 📖 Amazon Integration Documentation: Get reliable Amazon metadata with new setup guide! Step-by-step instructions show you how to configure Amazon cookies for consistent data fetching. https://booklore-app.github.io/booklore-docs/docs/metadata/amazon-cookie

⚠️ Important Migration Notice

• Legacy OPDS Removal: Support for legacy OPDS has been removed to focus on the improved version. Please migrate as soon as possible.
• Update to the new OPDS system
• Create new user accounts (existing accounts will no longer function)
• Enjoy better performance and reliability

🚀 New Features

• Improve notifications to display live progress for ongoing batch meta… (#1242) by @adityachandelgit
• Introduce per-library settings for metadata fetching (#1239) by @adityachandelgit
• Add setting/toggle to automatically download reviews (#1221) by @adityachandelgit
• Add ability to move books across libraries (#1210) by @adityachandelgit

✨ Enhancements

• Automatic ISBN 13 Correction/Normalization (#1219) by @adityachandelgit
• Default to ISBN13 in metadata search (#1217) by @adityachandelgit
• Display library name in metadata viewer page (#1211) by @adityachandelgit

🎨 UI Tweaks

• Add more primary and surface colors (#1223) by @adityachandelgit

🐛 Bug Fixes

• Resolve data inconsistencies in advanced metadata fetch UI (#1243) by @adityachandelgit
• Fix: Enter key in bulk metadata edit triggers form submit instead of … (#1234) by @adityachandelgit
• Ensure temporary files are properly cleaned up after metadata updates (#1226) by @adityachandelgit

🛠️ Refactoring & Maintenance

• Drop legacy OPDS and keep only the new implementation (#1236) by @adityachandelgit

📖 Documentation

• Add documentation for setting up Amazon cookies (#1235) by @adityachandelgit

🐳 Docker Images

• Docker Hub: booklore/booklore:v1.4.0
• GitHub Container Registry: ghcr.io/booklore-app/booklore:v1.4.0

Full Changelog: v1.3.4...v1.4.0

📸 Screenshots