Find a file
Chmouel Boudjnah 985cc79212
Some checks are pending
Build / policy (push) Waiting to run
Build / unit-tests (push) Blocked by required conditions
Build / lint (push) Blocked by required conditions
Build / assemble (push) Blocked by required conditions
Build / build (push) Blocked by required conditions
fix: Skip script text when restoring a position
2026-11-21 11:58:59 +01:00
.claude/skills docs: Add Claude adaptive layout skills and reference files 2026-10-10 16:49:54 +02:00
.github ci: Cache Robolectric jars and split the build 2026-11-20 08:21:59 +01:00
app fix: Skip script text when restoring a position 2026-11-21 11:58:59 +01:00
docs feat: Sync Vocabulary Builder words and review progress 2026-11-21 03:55:06 +01:00
fastlane chore: release v0.32.0 2026-11-20 14:18:40 +01:00
gradle feat: Modernize the reading experience 2026-11-19 10:29:48 +01:00
hack fix: Update release script confirmation prompt to default to yes 2026-11-20 15:12:50 +01:00
promo feat: Add Czech, Brazilian Portuguese locales 2026-11-11 09:37:03 +01:00
tests fix: Restore BookOrbit reading positions 2026-11-21 11:58:59 +01:00
tmp chore: remove temporary illustration drafts 2026-09-17 03:51:04 +02:00
.agents docs: Add Claude adaptive layout skills and reference files 2026-10-10 16:49:54 +02:00
.gitignore chore: Ignore local personal Copilot CLI instructions 2026-09-01 20:32:19 +02:00
.pre-commit-config.yaml chore: Run only the play flavor before pushing 2026-11-18 09:00:39 +01:00
AGENTS.md docs: Keep crash dashboard links out of public GitHub text 2026-11-19 01:56:52 +01:00
build.gradle.kts feat: add EPUB reading with Readium navigator 2026-07-28 21:38:21 +02:00
DEVELOPER.md fix: Restore BookOrbit reading positions 2026-11-21 11:58:59 +01:00
gradle.properties perf: Accelerate unit test execution across multiple cores 2026-08-17 21:29:25 +02:00
gradlew chore(deps): bump the gradle group with 12 updates 2026-09-01 19:51:36 +02:00
gradlew.bat chore(deps): bump the gradle group with 18 updates 2026-10-01 22:22:47 +02:00
LICENSE feat: scaffold Android project with Compose app shell 2026-07-28 21:21:07 +02:00
Makefile feat: Capture the companion screenshots and list stale ones 2026-11-16 08:19:39 +01:00
README.md feat: Save vocabulary lookups by default 2026-11-19 19:58:27 +01:00
settings.gradle.kts feat: scaffold Android project with Compose app shell 2026-07-28 21:21:07 +02:00

Liseur

Latest Release Total Downloads License

A woman reading on a couch under a lamp

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.

Get it on Google Play Get it on F-Droid Get it on GitHub

  • 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: the book you are reading, your shelves and a quote from your reading Library: books in the default cover grid Reading, light theme
Home: pick up where you left off. Library: your books, in the default grid. Distraction-free page, in light or dark.
Read aloud Reading companion character profile with source passages Companion map of character relationships across chapters
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.

  • 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":

image

Video

Liseur: free and open source, no ads, no account. Watch the video on YouTube
Watch the 30-second tour on YouTube

Author

Sponsor

Chmouel Boudjnah

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.