Skip to content

Releases: bookorbit/bookorbit

v2.3.0

Choose a tag to compare

@github-actions github-actions released this 18 Jul 17:21

Highlights

  • Crowdin-powered translations - BookOrbit now supports English, German, Dutch, Brazilian Portuguese, and Slovenian. Help improve existing translations or contribute a new one on Crowdin; requests for additional languages are welcome.
1 4
  • Faster navigation in large libraries - An adaptive jump rail lets you quickly move through a library by title, author, series, date added, publication date, and more. Choose the display style that suits you in your library preferences.
2
  • Duplicate book resolution - Find potential duplicate books in your library, compare their metadata, and resolve them without leaving BookOrbit.
3
  • More metadata sources - Libro.fm is now available as a metadata source, improving metadata matches for audiobooks.
7
  • Improved readers and device sync - The PDF reader has received a visual polish and more reliable page rendering. KOReader synchronization no longer blocks its interface, Kobo sync avoids reading-state feedback loops, and reading sessions retain their full duration.
5 6
  • New reading insights - Explore privacy-aware statistics and keep a history of every reading attempt, including books you started but did not finish.

  • Personalize your experience - Use your system color-scheme preference automatically, or turn off achievements and gamification when you prefer a quieter reading experience.


Features

Bug Fixes

Internationalization

Security

Database


Docker

docker pull ghcr.io/bookorbit/bookorbit:2.3.0

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

Full diff

v2.2.0

Choose a tag to compare

@github-actions github-actions released this 10 Jul 00:58

Highlights

  • KOReader plugin upgrades - The plugin now serializes sync jobs to avoid conflicts and syncs your personal reviews and ratings with BookOrbit. Book detail pages surface related series, authors, and similar books, while download actions and tall-screen catalog layouts are easier to use on-device.
1 2 9 7 6
  • Readwise and StoryGraph sync - Send BookOrbit highlights to Readwise automatically. Sync reading status and progress to StoryGraph too, with per-book controls, automatic matching, and manual edition selection when a match needs attention.
4 3
  • Better Book Dock imports - Pause and resume a Book Dock import when you need to inspect files, storage, or metadata before continuing. During finalization, discard unwanted duplicate books directly instead of importing them and cleaning up afterward.
5
  • Personal reviews and richer metadata - Keep private reviews alongside your books and clear a rating when it no longer reflects your opinion. Full publication dates are now stored instead of year-only values, preserving more accurate edition metadata.
8 7 6
  • More reliable Kobo sync - Sync Smart Scopes to Kobo to keep device collections aligned with your BookOrbit library. Library snapshots and reading progress are now tracked separately for every device, improving visibility and reliability when you use more than one Kobo.

  • More flexible reading - Go fullscreen in every reader for a cleaner, distraction-free reading view. Books marked want to read can now receive progress updates too, so you do not need to change their status before you start.


Features

Bug Fixes

Read more

v2.1.0

Choose a tag to compare

@github-actions github-actions released this 03 Jul 17:06
0fd3e6a

Highlights

  • KOReader plugin improvements - Several quality-of-life additions to the KOReader plugin: bulk book selection and download in the catalog, skip automatic progress sync when offline, a system action shortcut to jump to your BookOrbit dashboard, device removal and unmatched book tracking surfaced in the settings panel, and manual book hash linking to resolve unmatched books without a full rescan.
1 2 3 4 5
  • Custom icons support - Libraries, shelves, and collections can now display custom icons, letting you personalise your library at a glance.
6
  • Rich text description formatting bar - The book description editor now has a formatting toolbar. Bold, italic, links, and lists are all available without leaving the metadata panel.
7
  • Kobo device sync history - A new sync history view in the Kobo settings panel shows the timestamp and outcome of every past sync session, making it easy to diagnose sync problems.
8
  • Import Booklore reading state - Users migrating from Booklore can now import their reading progress and history directly, so your reading journey carries over intact.

  • Custom metadata fields in table view - Custom fields defined for a library now appear as sortable columns in the book table view.

  • Book Dock work queue and adaptive heap - Book Dock processing now runs through a managed work queue to prevent pipeline overload. The Node.js heap is also auto-sized based on available memory, reducing OOM crashes on memory-constrained servers.

  • Public API documentation (Swagger) - A Swagger UI is now available at /api/docs for exploring and testing the public REST API.


Features

Bug Fixes

Read more

v2.0.1

Choose a tag to compare

@github-actions github-actions released this 27 Jun 17:34

Highlights

  • Full KOReader integration via BookOrbit Plugin - KOReader is now a first-class citizen. The Bookorbit plugin syncs your reading progress automatically as you read, uploads your entire read history in a single sweep, and keeps your highlights and notes in sync. A built-in catalog lets you browse and download books from your Bookorbit library without leaving your e-reader.
Screenshot 2026-06-27 at 10 09 53 AM Screenshot 2026-06-27 at 10 11 22 AM Screenshot 2026-06-27 at 10 10 26 AM Screenshot 2026-06-27 at 10 10 37 AM Screenshot 2026-06-27 at 10 11 00 AM Screenshot 2026-06-27 at 10 19 53 AM Screenshot 2026-06-27 at 10 20 30 AM
  • Annotations sync across all three platforms - Highlights and notes from Kobo, KOReader, and the built-in web reader now live in one place. Annotations survive file updates and format changes, and are never lost to duplicate detection or sync conflicts.
Screenshot 2026-06-27 at 10 14 39 AM
  • New Annotations Hub - A dedicated page showing all your highlights and notes across every book and library. Filter by book, annotation style, or source (Kobo / KOReader / web reader), select in bulk, and export.
Screenshot 2026-06-27 at 10 08 45 AM
  • Revamped Reading Log - The per-book reading log is completely rebuilt. See total reading time, session count, start and finish dates, and an achievement ring at a glance. A per-book activity heatmap shows your reading rhythm over time. A journey chart plots your progress across the life of the book. A source breakdown shows how much you read on each device. You can now log manual sessions directly from this tab too.
Screenshot 2026-06-27 at 10 07 15 AM
  • Custom book metadata fields - Define your own fields on top of the standard metadata set - text, URL, number, date, or boolean. Fields can be scoped to specific libraries, and their values are saved back into your EPUB, PDF, and CBZ files.
Screenshot 2026-06-27 at 9 58 36 AM Screenshot 2026-06-27 at 9 59 51 AM
  • Community ratings from all providers - Book details now show community scores and vote counts from every configured metadata provider (Goodreads, Hardcover, Amazon, Audible, Google Books, iTunes, OpenLibrary, RanobeDB), right alongside the rest of the metadata.
Screenshot 2026-06-27 at 10 16 22 AM
  • Per-book Hardcover sync controls - Choose between two sync modes: sync all eligible books by default, or only sync books you explicitly opt in. A per-book toggle on the book detail page gives you fine-grained control, and unread books are handled correctly - your choice is remembered and sync activates automatically when you start reading.
Screenshot 2026-06-27 at 10 17 25 AM Screenshot 2026-06-27 at 10 18 40 AM
  • Source distribution chart in statistics - A new chart on the statistics page breaks down your total reading time by source - Kobo, KOReader, and web reader - so you know exactly where you do most of your reading.

Action Required: Replace the KOReader Plugin

The old plugin is not compatible with v2.0.1. You must replace it manually - the in-KOReader update mechanism cannot perform this migration.

  • On your device, delete the bookorbit.koplugin folder from koreader/plugins/.
  • In the BookOrbit web UI, go to Settings > KOReader and click Download Plugin.
  • Extract the zip and copy the bookorbit.koplugin folder into koreader/plugins/.
  • Restart KOReader.

The downloaded plugin is already preconfigured with your server URL and credentials - no pairing step needed. Your reading progress and annotations on the server are untouched by this upgrade.


Video Walkthroughs (No Audio):


Features

Bug Fixes


Docker

docker pull ghcr.io/bookorbit/bookorbit:2.0.1

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

Full diff

v1.12.0

Choose a tag to compare

@neonsolstice neonsolstice released this 23 Jun 00:41
Immutable release. Only release title and notes can be modified.

Highlights

  • Import books directly from Hardcover - A new import workflow lets you pull books from your Hardcover account into your library without manual entry.
Screenshot 2026-06-22 at 6 18 42 PM Screenshot 2026-06-22 at 6 18 15 PM
  • Match books to multiple series at once - The series-matching workflow now supports picking more than one series in a single operation, making it faster to handle crossovers and shared universes.
Screenshot 2026-06-22 at 6 20 27 PM
  • Empty entity cleanup controls - A new settings control lets you find and remove authors, series, and other entities that no longer have any books attached.
Screenshot 2026-06-22 at 6 21 50 PM

Features

Bug Fixes


Docker

docker pull ghcr.io/bookorbit/bookorbit:1.12.0

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

Full diff

v1.11.0

Choose a tag to compare

@neonsolstice neonsolstice released this 20 Jun 23:42
Immutable release. Only release title and notes can be modified.

Highlights

  • What's New is now built in - BookOrbit can show release highlights inside the app, including the update popup, full /whats-new archive, images, videos, and parsed technical changelogs.
Screenshot 2026-06-20 at 5 13 21 PM
  • Books can belong to multiple series - Track crossovers, omnibus editions, and shared universes without choosing a single series. The new Up Next filter can also find the next unread book in an active series.
Screenshot 2026-06-20 at 5 17 44 PM
  • New achievements for ratings and devices - Achievement tracking now includes book ratings and multi-device reading, with reading sessions recording their source more accurately.
Screenshot 2026-06-20 at 5 26 29 PM Screenshot 2026-06-20 at 5 19 19 PM
  • Korean and Polish metadata providers - Aladin and LubimyCzytac are now available as metadata sources, with provider IDs saved through fetches, locks, file metadata, and the book detail UI.
Screenshot 2026-06-20 at 5 28 28 PM

Features

Bug Fixes

Read more

v1.10.0

Choose a tag to compare

@github-actions github-actions released this 12 Jun 15:45
Immutable release. Only release title and notes can be modified.

Highlights

  • Upload files right from a book - Add or replace a book's files without leaving the app. Open the Files tab, drop in an EPUB, PDF, MOBI, CBZ, M4B and more (up to 500 MB each), and optionally rename every file to match the book.
Screenshot 2026-06-15 at 2 48 31 PM Screenshot 2026-06-15 at 2 48 58 PM
  • Manage every book file in place - Each file now has its own actions: set the primary format, read or peek at it, download, rename, or delete, all from the Files tab.
Screenshot 2026-06-15 at 2 53 59 PM
  • Jump through your library by letter - A new A-Z jump rail lets you skip straight to any letter in large libraries, so finding a title is a single tap instead of endless scrolling.
Screenshot 2026-06-15 at 2 51 31 PM

Features

Bug Fixes

Visual Changes


Docker

docker pull ghcr.io/bookorbit/bookorbit:1.10.0

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

Full diff

v1.9.0

Choose a tag to compare

@github-actions github-actions released this 07 Jun 01:17
Immutable release. Only release title and notes can be modified.

Highlights

  • Two-way page-level progress sync - Your reading position now syncs precisely, page by page, across Kobo, KOReader, and the web. Pick up exactly where you left off on any device.

  • Metadata and covers written into audiobooks - Cover art and book details are now embedded directly into your audiobook files, so exported audiobooks stay portable and display correctly in any player.

Screenshot 2026-06-15 at 3 17 47 PM
  • Kobo metadata provider - A dedicated Kobo provider fetches localized metadata, accurate ISBNs, and high-resolution covers straight from Kobo's catalog.
Screenshot 2026-06-15 at 3 16 43 PM
  • Every format exposed over OPDS - The OPDS feed now lists all available formats for a book at once, so third-party reading apps can grab the exact file type they need.
Screenshot 2026-06-15 at 3 15 33 PM
  • Native Kobo reading sessions - Offline reading on your Kobo is now captured automatically, calculating active reading time and progress to fill in your reading log.

  • Genre blocklist - Block specific genre tags from ever being written during metadata fetches, keeping your library's categories clean and clutter-free.

Screenshot 2026-06-15 at 3 11 16 PM
  • Peek at books without tracking - A new peeking mode lets you open and skim any book without updating progress or marking it as Currently Reading.
Screenshot 2026-06-15 at 3 08 03 PM Screenshot 2026-06-15 at 3 10 15 PM

Features

Bug Fixes

Read more

v1.8.0

Choose a tag to compare

@github-actions github-actions released this 01 Jun 21:30
Immutable release. Only release title and notes can be modified.

Highlights

  • Up next in series on your dashboard - The Continue Reading area now surfaces the next book in a series you're working through, so you always know what to pick up next.
Screenshot 2026-06-15 at 3 39 47 PM
  • Edit metadata for many books at once - Select multiple books and change authors, genres, tags, series, and more in one dialog. Pick add, remove, replace, or clear per field, and only the fields you toggle are touched.
Screenshot 2026-06-15 at 3 43 04 PM Screenshot 2026-06-15 at 3 42 08 PM
  • RanobeDB metadata provider - Pull accurate Japanese light novel metadata from RanobeDB, with no setup or API key required.
Screenshot 2026-06-15 at 3 43 51 PM
  • Choose how collapsed series look - Pick the cover shown for a collapsed series in the grid: a fanned stack, a mosaic of covers, or the first, latest, or first-unread book.
Screenshot 2026-06-15 at 3 44 32 PM Screenshot 2026-06-15 at 3 45 58 PM Screenshot 2026-06-15 at 3 46 26 PM
  • Adaptive cover display modes - Control how real covers fit their slots when aspect ratios differ: a blurred fill behind the full cover, an edge-cropped fill, or the natural ratio anchored to the bottom.
Screenshot 2026-06-15 at 3 47 39 PM Screenshot 2026-06-15 at 3 48 28 PM Screenshot 2026-06-15 at 3 48 41 PM Screenshot 2026-06-15 at 3 48 48 PM
  • Appearance that follows you across devices - Save your theme and display preferences to your account so every device looks the same, or keep them per-device if you prefer.
Screenshot 2026-06-15 at 3 49 23 PM
  • Titles and authors on grid cards - Show the title and author under each grid card, reveal them on hover, or hide them entirely.
Screenshot 2026-06-15 at 3 50 37 PM Screenshot 2026-06-15 at 3 51 09 PM Screenshot 2026-06-15 at 3 51 24 PM

Features

Bug Fixes

Read more

v1.7.0

Choose a tag to compare

@github-actions github-actions released this 28 May 16:30
Immutable release. Only release title and notes can be modified.
acc8a19

Features

Bug Fixes


Docker

docker pull ghcr.io/bookorbit/bookorbit:1.7.0

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

Full diff