Find a file
Chmouel Boudjnah bf635ece0e
Some checks are pending
Build / build (push) Waiting to run
chore: release v0.11.0
2026-08-25 21:47:18 +02:00
.github feat: Add validation checks for F-Droid release tag filters 2026-08-25 07:08:47 +02:00
app chore: release v0.11.0 2026-08-25 21:47:18 +02:00
docs fix(reader): save where a scrolled book has got to (#79) 2026-08-25 18:01:47 +02:00
fastlane chore: release v0.11.0 2026-08-25 21:47:18 +02:00
gradle feat(reader): show footnotes on the page instead of at the back of the book 2026-08-19 14:38:21 +02:00
hack feat: Add validation checks for F-Droid release tag filters 2026-08-25 07:08:47 +02:00
tests test: Add device checks for how long a book takes to open 2026-08-20 21:27:42 +02:00
tmp feat: Combine filter chips and sort controls into a single row 2026-07-31 15:07:03 +02:00
.gitignore feat(release): publish to the Google Play internal track (#36) 2026-08-19 16:37:07 +02:00
.pre-commit-config.yaml chore: Configure pre-commit to run hooks automatically on push 2026-08-18 10:55:52 +02:00
AGENTS.md feat(sync): sync highlights, notes and bookmarks (#78) 2026-08-25 14:39:03 +02:00
build.gradle.kts feat: add EPUB reading with Readium navigator 2026-07-28 21:38:21 +02:00
CLAUDE.md feat: scaffold Android project with Compose app shell 2026-07-28 21:21:07 +02:00
DEVELOPER.md feat: Add validation checks for F-Droid release tag filters 2026-08-25 07:08:47 +02:00
gradle.properties perf: Accelerate unit test execution across multiple cores 2026-08-17 21:29:25 +02:00
gradlew feat: scaffold Android project with Compose app shell 2026-07-28 21:21:07 +02:00
gradlew.bat feat: scaffold Android project with Compose app shell 2026-07-28 21:21:07 +02:00
LICENSE feat: scaffold Android project with Compose app shell 2026-07-28 21:21:07 +02:00
Makefile feat: Add validation checks for F-Droid release tag filters 2026-08-25 07:08:47 +02:00
README.md feat(reader): scroll the page for me (#75) 2026-08-24 23:26:45 +02:00
settings.gradle.kts feat: scaffold Android project with Compose app shell 2026-07-28 21:21:07 +02:00

Liseur

A woman reading on a couch under a lamp

An open-source ebook reader for Android and a calibre-web / Komga / liseur-sync client: EPUBs on your phone, in sync with your own book server, for people whose idea of a great evening is a warm blanket and a 900-page book.

Library Reading Reading controls Typography
The shelf, sorted by what you are currently reading. Distraction-free page with notes and bookmarks. Reading progress, chapter scrubber, and time remaining. Themes, open typefaces, spacing, and brightness.
Contents Highlights Search Definition card
Full-screen table of contents for easy navigation. A personal notebook of highlights, exportable to Markdown. In-book search with context snippets. Instant word definitions without losing your place.
Series One series Server setup An empty library
Series grouped into compact shelf stacks. Reading order, progress, and missing volumes at a glance. Connect to calibre-web, Komga or liseur-sync in moments. Three ways to fill a new shelf.

Screenshots use Standard Ebooks editions (public domain).

About Liseur

Liseur is designed to get out of the way and let you read. Pages open cleanly from edge to edge with the Readium engine, set in open typefaces like Literata, Vollkorn, Atkinson Hyperlegible, and Inter, or whatever quirky typography the publisher insisted on. Four dedicated reading themes (Light, Sepia, Dark, and true OLED Black) let you settle into a story at 2 a.m. without being blinded by your phone. Margins, line spacing, brightness, and page turns stay quietly out of your way. Prefer one long scroll to turning pages? Switch it on for the whole library, or for the one book that wants it, and keep scrolling past the end of a chapter to fall into the next one. Set it scrolling by itself, at a pace you pick, and it carries on across chapters until you touch the page — handy over lunch, or with one hand on a strap.

A discreet footer shows the time remaining in the chapter (just enough to convince yourself that one more chapter won't hurt), while highlights, margin notes, bookmarks, and instant dictionary lookups remain right under your fingers when you stumble upon a word you pretend to know. Footnotes open as a small card over the page rather than throwing you to the back of the book, so an author's aside costs you nothing more than a tap — and when a note is long enough to deserve the full page, "Go to note" takes you there and leaves a way back.

Your library gathers onto a single shelf, whether your books live in messy folders on your phone or on a self-hosted calibre-web, Komga or liseur-sync server. Books that belong to a series politely group into compact stacks that track your reading order, your progress, and the missing volumes you still need to hunt down. When you reach the final page of a novel, the next volume is already sitting there, gently enabling your binge-reading habits.

When you switch between devices, you have the choice to have your place travel with you across your devices. Two-way synchronization with calibre-web, Komga and liseur-sync keeps your progress aligned — down to the exact sentence on Komga and liseur-sync, so you never have to play the guessing game of where you were. liseur-sync goes one further: standalone EPUB files that never came from a catalog sync their position too, matched by the file itself. Its books come from folders it watches on the server, so anything you drop there shows up on the shelf.

About to lose your connection? Download all books on the server account screen fetches everything in the catalog that isn't already on your device, in one go. Books you already have are left alone, archived ones are skipped, and it tells you how much room it will need before it starts.

Everything runs privately and without distraction. There are no trackers, no analytics, no ads, and no attempts to sell you a monthly subscription for books you already own. Liseur only talks to the book servers and dictionary sources you choose to add. The privacy policy spells out exactly what that means.

Install

  • liseur-desktop: Desktop version of Liseur
  • liseur-sync: Lightweight self-hosted library and sync server — watched folders, browse, download, positions and reading stats

Development

See DEVELOPER.md for build instructions and architecture notes. What each supported server exposes, what is implemented against it, and why the remaining gaps are or are not fixable is in docs/SERVER_CAPABILITIES.md.

What's in a name?

Liseur ([li.zœʁ], lee-ZUR) is the French word for an avid reader or book lover. It sounds dignified just like the English word leisure, which is exactly what you should be doing when you curl up with a good book.

Here is a painting of Pierre-August Renoir portraying C.Monet as "Le liseur"

image

Author

Sponsor

Chmouel Boudjnah

Licence

MIT. Bundled fonts are under the SIL Open Font License.