Liseursync

A small, light book server that does a lot.

One Go binary and a SQLite file, using about 50 MB of memory when idle. It still serves your EPUBs and audiobooks, reads them in the browser, keeps your position in step across devices and records how long you read.

Self-hosted and MIT licensed. It is the server behind Liseur, an Android reading app.

your-server/ui/library The LiseurSync library page: a grid of book covers with a Continue reading shelf above it.

What it does

Serves the library you already have

Point it at a folder of EPUBs or at a Calibre library. The books stay where they are. The server reads them and changes a folder only if you allow uploads there.

Keeps your place on every device

Pick up where you stopped on any device. A reader you haven't charged in weeks won't drag you back to last month's page when you turn it on.

Has a reader in the browser

Open any EPUB in the web reader. Install the site as an app to read offline, and your position, highlights and notes catch up when you reconnect.

Plays audiobooks beside the books

An .m4b next to its EPUB gets a player in the reader, and the page follows the narration. Audiobookshelf can be followed as well.

Counts your reading

Sessions from every device end up in one set of statistics, with daily totals and a calendar of the days you read.

Works for more than one person

Each account has its own positions and statistics, and you choose which folders each person can see.

Where you can read

Every device sends its position in its own way. The server keeps them together.

Liseur for Android The main app LiseurSync supports. It syncs positions, highlights, statistics and uploads, and connects with your username and password. See how it connects.
KOReader Progress sync for your position and OPDS for the library, both built into KOReader, plus the KoInsight plugin for reading time. One download from the server sets up all three. See the setup guide.
CrossPoint on an Xteink Keeps your place in step with your other devices and can send your reading time. Read the guide.
Your browser The built-in reader, with offline reading once it is installed as an app. Install it on an iPad.
Any OPDS app Browse and download your books from apps such as Readest, Moon+ Reader, KyBook or Thorium.
ChatGPT and other assistants Ask about your books, your progress and your highlights with the read-only access you choose. See what you can ask.

Easy KOReader setup

Download one setup from your server, copy its plugin folder into KOReader's plugins folder and start KOReader. Your library, your reading position and your reading time are connected, and you never type a password on the e-reader.

The guide has a screenshot for every step.

Open the setup guide
KOReader's OPDS catalog list with Liseur Sync in it.
The server's books listed in KOReader.

A closer look

your-server/ui/books/…/readThe web reader showing a page of a book.
The web reader
your-server/ui/insightsThe Insights page with reading time totals and a chart.
Reading statistics
your-server/ui/books/…A book's details page with its cover, description and reading history.
A book's page

Install

The installer works with Docker or rootless Podman. It sets up the database, starts the server and creates the first account.

After that, point the server at your books. Folders are read-only unless you turn on uploads for them.

# install and start the server
curl -fsSL https://raw.githubusercontent.com/chmouel/liseur-sync/main/scripts/install.sh | bash

# give alice a folder of books
LiseurSync admin add-folder -assign alice Shelf /srv/books
Chmouel Boudjnah

Made by Chmouel

I build LiseurSync and the Liseur app, and keep both free and open source. If they are useful to you, you can follow the work on GitHub or sponsor it.