Skip to content

BookHeaven.Server

File Storage & Sync

Official BookHeaven Server web app to manage your ebook library.

HTML Latest v0.17.0 · 2mo ago Security brief →

Features

  • Modern and responsive UI
  • Auto discovery for client configuration
  • Metadata handling with edit‑and‑persist support

Recent releases

View all 10 releases →
v0.17.0 Breaking risk
Breaking changes
  • OPDS endpoint moved from /opds to /opds/v1
Notable features
  • KOReader Sync server support
  • Cross-device reading progress sync
Full changelog

# Breaking Changes

  • The OPDS endpoint has been moved from /opds to /opds/v1.

Features

  • Added support for KOReader Sync.

Fixes

  • KOReader was unable to load the OPDS catalog due to a missing header in the response.

KOReader Sync

As you may be aware, BookHeaven Server has been designed to work in tandem with the dedicated reader app for Android, which will provide the best overall experience.

However, BookHeaven is all about convenience and adding support for KOReader Sync has been an effort to provide more of that.

So from now on you can use BookHeaven as a KOReader Sync server, to read your books and sync your reading progress across devices using KOReader.

On top of that, your progress will also show up in the web ui, minus the reading time, the sync API doesn't provide that info.

Sharing progress between the android app and KOReader is not possible though, since the way of handling ebooks and progress is different between the two platforms.

How to set up

To use KOReader with BookHeaven Server, add your Server as an OPDS catalog:

http://<your-server-ip>:<your-server-port>/opds/v1

-- or --

https://<your-server-domain>/opds/v1

Then, inside progress sync settings, add again your server url as a custom server (just the base url).

Log in using your BookHeaven profile name as username. The password is not required, but don't leave it blank otherwise it will throw an error.

And that's it!

Full Changelog: https://github.com/BookHeaven/BookHeaven.Server/compare/v0.16.0...v0.17.0

v0.16.0 New feature
Notable features
  • Real-time import progress notification in sidebar displaying detected, processed, and failed book counts
Full changelog

Features

  • If you use the import folder feature, you will now see a notification in the bottom of the sidebar whenever there are books being imported. This notification will show how many books haven been detected, how many have been processed and how many of them have failed, if any.

Full Changelog: https://github.com/BookHeaven/BookHeaven.Server/compare/v0.15.2...v0.16.0

v0.15.0 Mixed
Notable features
  • Page Gap property support in profile settings
  • Localized title on Authors page
Full changelog

Features

  • Added support for the new Page Gap property in the profile settings.

Fixes

  • Added localized title to Authors page.

Full Changelog: https://github.com/BookHeaven/BookHeaven.Server/compare/v0.14.4...v0.15.0

v0.14.4 Bugfix

# Fixes - Fixed a view-transitions error on firefox. **Full Changelog**: https://github.com/BookHeaven/BookHeaven.Server/compare/v0.14.3...v0.14.4

v0.14.2 Bugfix

# 🛠️ Fixes - The book status filter from the shelf won't be applied anymore when viewing a collection. **Full Changelog**: https://github.com/BookHeaven/BookHeaven.Server/compare/v0.14.1...v0.14.2

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.

About

Stars
183
Forks
3
Languages
HTML C# CSS

Install & Platforms

Install via
docker

Beta — feedback welcome: [email protected]