Skip to content

bookorbit/bookorbit](https:

v1.9.0 Breaking

This release includes breaking changes for platform teams planning a safe upgrade.

Published 1mo Productivity & Wikis
✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

audiobook-player digital-library docker ebook-reader library-management metadata-management
+5 more
nestjs oidc-single-sign-on opds self-hosted vue

Summary

AI summary

Broad release touches Highlights in v1.9.0, Bug Fixes, https://github.com/bookorbit/bookorbit/issues/145, and https://github.com/bookorbit/bookorbit/issues/178.

Changes in this release

Feature Medium

Adds precise two-way page level progress sync between Kobo, KOReader, and web interface.

Adds precise two-way page level progress sync between Kobo, KOReader, and web interface.

Source: llm_adapter@2026-06-07

Confidence: high

Feature Medium

Adds support for embedding cover images and metadata directly into audiobook files.

Adds support for embedding cover images and metadata directly into audiobook files.

Source: llm_adapter@2026-06-07

Confidence: high

Feature Medium

Adds a dedicated Kobo metadata provider to fetch localized metadata, ISBNs, and high‑resolution covers.

Adds a dedicated Kobo metadata provider to fetch localized metadata, ISBNs, and high‑resolution covers.

Source: llm_adapter@2026-06-07

Confidence: high

Feature Medium

Exposes every available file format for multi‑format books in the OPDS catalog feed.

Exposes every available file format for multi‑format books in the OPDS catalog feed.

Source: llm_adapter@2026-06-07

Confidence: high

Feature Medium

Adds blocklist feature to ignore unwanted genre tags during metadata fetching.

Adds blocklist feature to ignore unwanted genre tags during metadata fetching.

Source: llm_adapter@2026-06-07

Confidence: high

Feature Medium

Adds "peeking" mode in the web reader to open books without updating progress or marking them as read.

Adds "peeking" mode in the web reader to open books without updating progress or marking them as read.

Source: llm_adapter@2026-06-07

Confidence: high

Bugfix Medium

Fixes duplicate detection for books lacking ISBN in book‑dock.

Fixes duplicate detection for books lacking ISBN in book‑dock.

Source: llm_adapter@2026-06-07

Confidence: high

Bugfix Medium

Fixes chip input placeholder logic and styling in the client UI.

Fixes chip input placeholder logic and styling in the client UI.

Source: llm_adapter@2026-06-07

Confidence: high

Bugfix Medium

Fixes loading of the correct chapter in the web reader.

Fixes loading of the correct chapter in the web reader.

Source: llm_adapter@2026-06-07

Confidence: high

Bugfix Medium

Fixes handling of stream errors when patching zip archives on the server.

Fixes handling of stream errors when patching zip archives on the server.

Source: llm_adapter@2026-06-07

Confidence: high

Full changelog

Highlights in v1.9.0

1. Precise Two-Way Page Level Progress Sync for Kobo and KOReader

Added precise page level bi-directional reading progress synchronization. Reading progress now automatically syncs back and forth between Kobo devices, KOReader, and the web interface.

2. Write Metadata and Embed Cover Images to Audiobook Files

Added support for embedding cover images and book metadata directly into audiobook files. This ensures exported audiobooks remain fully portable and display correctly in external players.

3. Kobo Metadata Provider

Added a dedicated Kobo metadata provider to directly fetch localized metadata, accurate ISBNs, and high-resolution cover images.

4. Expose All Book Formats for Multi-Format Books via OPDS

Updated the OPDS catalog feed to expose every available file format for a single book simultaneously. This improves compatibility with third-party reading apps that require specific file formats for downloads.

5. Sync Native Reading Sessions from Kobo

Added support for capturing offline reading sessions directly from Kobo device usage data. The system now automatically calculates active reading durations and precise progress updates to populate the reading log.

6. Genre Blocklist to Exclude Unwanted Tags

Added a blocklist feature to explicitly ignore specific, unwanted genre tags during metadata fetching. This helps prevent cluttered categorization and maintains cleaner library organization.

7. Support "Peeking" Mode in Book Readers

Added a "peeking" mode to the web reader that allows books to be opened and skimmed without triggering progress updates or marking them as "Currently Reading."


Features

  • add continue listening and want to read dashboard scrollers (368f01e) by @neonsolstice
  • audio: embed cover image in audiobook files (#197) (935fce9) by @chrismansell26, closes #145
  • book-dock: support custom container directory via BOOK_DOCK_PATH (e05141f) by @neonsolstice, closes #178
  • books: link authors on book details to author page (ed5b77e) by @neonsolstice, closes #252
  • books: remember show paths setting on files page (031dd12) by @neonsolstice, closes #212
  • books: write metadata directly to audiobook files (#219) (8b9a87f) by @chrismansell26
  • kobo/koreader: two way page level sync between kobo/koreader and bookorbit (#250) (11b6d98) by @neonsolstice, closes #249
  • kobo: sync native reading sessions from analytics events (#245) (9a557d6) by @Logan-Selley
  • metadata: add fetch pipeline diagnostics (cd1b062) by @neonsolstice
  • metadata: add genre blocklist to exclude unwanted tags (57cfd13) by @neonsolstice, closes #235
  • metadata: add Kobo metadata provider (3bab324) by @neonsolstice, closes #247
  • opds: expose all content files for multi-format books (f63e07a) by @neonsolstice, closes #224
  • reader: auto scroll table of contents to current chapter (95c0f01) by @neonsolstice, closes #193
  • reader: support peeking books without tracking progress (28ff196) by @neonsolstice, closes #161
  • series: add option to group books by media type (0063cb4) by @neonsolstice, closes #154
  • series: add stack display mode for series thumbnails (05ac347) by @neonsolstice, closes #223
  • series: implement 3d perspective fan and hero cover sorting for series stack (11cf21a) by @neonsolstice
  • settings: add option to change default thumbnail click behavior (283999e) by @neonsolstice, closes #240

Bug Fixes

  • book-dock: refine duplicate detection for books without isbn (06a9b9f) by @neonsolstice, closes #175
  • client: deduplicate file format badges in list view (2b20c1b) by @neonsolstice
  • client: fix chip input placeholder logic and styling (7d01f11) by @neonsolstice, closes #251
  • kobo: capture paired analytics progress (20cbdfa) by @neonsolstice
  • kobo: re-deliver books removed on device while still eligible (#194) (41c579b) by @Logan-Selley
  • koreader: trigger hardcover auto-sync on progress update (4a7d1e2) by @neonsolstice, closes #258
  • metadata: extract metadata from sidecar opf files (b731595) by @neonsolstice, closes #200
  • metadata: improve goodreads search relevance and ranking (35658ec) by @neonsolstice
  • metadata: restore RanobeDB file metadata and links #207 #210 (9d842bf) by @neonsolstice
  • opds: strip xml 1.0 illegal control characters from metadata (e350568) by @neonsolstice, closes #260
  • reader: load correct chapter in web reader (a737dff) by @neonsolstice, closes #203
  • scanner: prevent nested folders from being marked missing (ba91817) by @neonsolstice, closes #170
  • series: prevent 404 for long series titles (#201) (e90bc35) by @danielcgilibert
  • series: prevent stretched background shadow on audiobooks (e8d5e1a) by @neonsolstice, closes #221
  • series: use numeric ID for routing to support long titles (b349ab3) by @neonsolstice, closes #198
  • server: handle stream errors when patching zip archives (ec54756) by @neonsolstice, closes #226

Docker

docker pull ghcr.io/bookorbit/bookorbit:1.9.0

Multi-arch: linux/amd64 and linux/arm64.

Full diff

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Track bookorbit/bookorbit](https:

Get notified when new releases ship.

Sign up free

About bookorbit/bookorbit](https:

All releases →

Related context

Beta — feedback welcome: [email protected]