|
|
||
|---|---|---|
| .claude/skills | ||
| .github | ||
| app | ||
| docs | ||
| fastlane | ||
| gradle | ||
| hack | ||
| promo | ||
| tests | ||
| tmp | ||
| .agents | ||
| .gitignore | ||
| .pre-commit-config.yaml | ||
| AGENTS.md | ||
| build.gradle.kts | ||
| DEVELOPER.md | ||
| gradle.properties | ||
| gradlew | ||
| gradlew.bat | ||
| LICENSE | ||
| Makefile | ||
| README.md | ||
| settings.gradle.kts | ||
Liseur
An open-source ebook reader for Android, and a client for calibre-web, Komga, BookOrbit, liseur-sync and any OPDS catalog: EPUBs on your phone or in sync with book server.
- Local shelves and a library that follows you: calibre-web, Komga, BookOrbit, liseur-sync or any OPDS catalog, with reading position synced to the sentence.
- A reading companion that indexes characters, places and groups on your phone, with no server needed.
- Highlights, notes, bookmarks, dictionary, translation and read aloud with device voices or your own speech server.
- A vocabulary builder: keep words from the dictionary with the passage they came from, review them with spaced repetition, and export them to Anki.
- Light, Sepia, Dark, OLED Black and low-light themes, open typefaces and per-book layout.
- Free software: no ads, no account, no trackers in the F-Droid and GitHub builds.
![]() |
![]() |
![]() |
| Home: pick up where you left off. | Library: your books, in the default grid. | Distraction-free page, in light or dark. |
![]() |
![]() |
![]() |
| Read aloud with device voices or your own server. | Character profiles grounded in earlier passages. | Which characters appear together, chapter by chapter. |
More screenshots here
About Liseur
Liseur renders EPUBs with the Readium engine, in open typefaces (Literata, Vollkorn, Atkinson Hyperlegible, Inter) or whatever the publisher shipped. Reading themes: Light, Sepia, Dark, OLED Black, and warm "Low light" pages in Amber, Night red and Charcoal. Margins, line spacing, brightness, and page-turn vs. continuous-scroll are adjustable per book or library-wide. Auto-scroll runs at a set pace and continues across chapter boundaries, with on-page controls to pause it, change the speed or stop.
A footer shows the page you are on, how much of the chapter is left, and time remaining. Highlights, margin notes, bookmarks, and dictionary lookups are inline; book-level notes live in the notebook. Marking a passage offers one colour, and you tick which of the six you want along with the colour new marks use. Footnotes open as a card over the page rather than sending you to the back of the book. A selected passage can be translated by Android's own translator on the phone, or by a server you add, and from there the page itself can be translated sentence by sentence as you read.
Tap Save to vocabulary in the dictionary to keep the word, its definition, and the passage where you found it. Open Vocabulary Builder from the library menu to review words offline, or from a book’s Notes to see its words and return to their passages. Switch between Review, Words and Stats to study, manage saved words and track reviews, recall rate and your day streak. Review cards include notes and the original passage, with See in book to return to it and a speaker for device pronunciation when available. Reveal the answer, then choose Again, Hard, Good or Easy from the bottom tiles, or swipe left for Again and right for Good. The progress ring tracks this session; Undo restores the last rating. Home's Words to review card also supports swiping. Hold a review or Home vocabulary card to copy, share, edit or remove the word, or return to its book. Edit card opens a full-screen editor for the meaning and an optional personal note, with a confirmation before discarding changes. Hold revealed text to select and copy it. The vocabulary menu on Words can export a JSON backup or an Anki-compatible CSV. Lookups are saved automatically by default; turn this off in Vocabulary settings, which also offer daily limits and reminders. Home shows the next word due, so you can check its meaning and start a review from there.
The reading companion answers questions about characters and events using the passages before the selected text. Character profiles show their source passages, and optional background recaps summarize finished chapters. Even without a server, the companion builds a searchable index of people, places and groups on your device, and shows which names appear together in earlier chapters. With a server chosen, its Story tab shows the earlier chapters' recaps, recaps the ones missing, and writes a summary of the story so far, and character pages show what those recaps already say. Answers come from a server you configure; the index runs on your phone.
The library is one shelf whatever the source: local folders, calibre-web, Komga, BookOrbit, liseur-sync, or any OPDS catalog. Series are grouped into stacks tracking reading order, progress, and missing volumes. "Download all books" fills the shelf from a connected server in one go. An empty library also offers free books from public catalogs: Project Gutenberg, textos.info, ManyBooks and Gallica. Pick one, browse it by language, shelf or section, and download the books you want before there is anything to connect to. No account is needed for any of them.
Reading position syncs across devices through calibre-web, Komga,
BookOrbit or liseur-sync,
down to the exact sentence on the last three. BookOrbit positions travel as EPUB CFIs.
A Custom connection can be an OPDS address, a kosync address, or both, so a plain catalog and a sync server that know nothing about each other still add up to a library that follows you. What each server can and cannot do is in docs/SERVER_CAPABILITIES.md.
With liseur-sync you get extras, like a per-device settings backup, and better insights of your reading progress across devices.
Two home-screen widgets show the current book cover or a paged shelf of your library covers. Tap a cover to read. Neither needs configuration.
Liseur has no ads or account. The F-Droid and GitHub builds have no trackers or analytics. The Google Play build reports which features are used and why the app crashed, under a random installation identifier and with no book content or account details. You can turn this off in Settings > Advanced. Liseur connects to services you choose for book sync, speech, translation and the reading companion. Browsing the free catalogs (Project Gutenberg, textos.info, ManyBooks, Gallica) and using an online dictionary also makes network requests. See the privacy policy for details.
Related Projects
- liseur-sync: Lightweight self-hosted library and sync server. Watched folders, browse, download, positions and reading stats. This will give you the best "kindle/just work" experience compared to the other sync servers.
liseur-desktop: Desktop version of Liseur (abandoned).
Development
See DEVELOPER.md for build instructions and architecture notes,
and docs/SERVER_CAPABILITIES.md for what each
server exposes, what Liseur implements against it, and why the gaps remain.
What's in a name?
Liseur ([li.zœʁ], lee-ZUR) is the French word for an avid reader or book lover. It sounds dignified, like the English word leisure.
Another inspiration was a painting by Pierre-Auguste Renoir portraying Claude Monet as "Le Liseur":
Video
Watch the 30-second tour on YouTube
Author
Chmouel Boudjnah
- Fediverse - <@chmouel@chmouel.com>
- Twitter - <@chmouel>
- Blog - <https://blog.chmouel.com>
Licence
MIT. Bundled fonts are under the SIL Open Font License. The Shelves wallpapers are William Morris designs from public-domain scans in The Metropolitan Museum of Art's Open Access collection.





