mrkeyoor.com_
Wed 02 Sept 10:23 UTC
Self-Hostedevaluationupdated 02 Sept 2026

koreader review

KOReader is a document reader built mainly for e-ink devices, with support for ebooks, PDFs, comics, and scanned documents. It replaces limited factory reading software with finer control over typography, page layout, dictionaries, catalogs, and reading services. It also runs on Android and Linux, although its strongest case is breathing new life into dedicated readers.

trackingstars / 7d
Verdict

At commit 2e28a3c, our 3-CPU, 8-GB sandbox produced no install, build, or test result because it lacked a supported Lua ecosystem and the repo had no Dockerfile. Even without a lab result, the documented format range and e-ink-specific controls make KOReader an unusually capable choice for readers willing to tinker. Use it when the stock reader is holding your hardware back, but confirm the installation path for your exact device before committing.

We ran it

Answers from our run

Did you run koreader yourself?

No. Its code is Lua, and it carries no manifest our lab installs from, and no Dockerfile, so there was nothing standard to install, build or test. This review is written from the repository's own documentation.

Who should not use koreader?

Anyone wanting a one-click, officially supported app-store installation on every device

What are the alternatives to koreader?

Foliate, calibre, Plato. At commit 2e28a3c, our 3-CPU, 8-GB sandbox produced no install, build, or test result because it lacked a supported Lua ecosystem and the repo had no Dockerfile.

Setup2/5Device-specific setup, with no Docker path for our sandbox
Docs4/5User guide, wiki, developer docs, and per-device install pages
Community5/529,422 stars and a push one day before this review
Maturity5/5Developed since 2013 with broad device and format support

Who it’s for

Owners of Kindle, Kobo, PocketBook, reMarkable, or Cervantes devices who want more reading controls
PDF and DjVu readers who need zoom, reflow, contrast, and page-fitting tools
People with Calibre, OPDS, Wallabag, or StarDict-based reading workflows
Tinkerers comfortable following device-specific installation instructions

Who it’s NOT for

Anyone wanting a one-click, officially supported app-store installation on every device
Readers satisfied with their device's stock software and unwilling to maintain another reader
Teams requiring a permissive license, because KOReader uses AGPL-3.0
Buyers who need our own verified install, build, or test results before adoption, because our sandbox could not run it

Setup reality

We did not run KOReader at commit 2e28a3c: our fresh Debian sandbox had 3 CPUs and 8 GB of RAM, but the review harness has no supported Lua ecosystem and the repository provides no Dockerfile, so install, build, and tests were all not run. The README does not really promise a universal one-command setup; it directs users to separate instructions for Android, Cervantes, Kindle, Kobo, Linux, PocketBook, and reMarkable. Expect device-specific work, and check the relevant guide before assuming your model or firmware is a straightforward target.

KOReader replaces the limits of factory reading software

KOReader is for people who like dedicated reading hardware but have outgrown the software that shipped with it. The project dates to 2013, has 29,422 GitHub stars, and targets Kindle, Kobo, PocketBook, reMarkable, Cervantes, Android, and Linux. It supplies a common, adjustable environment across these devices, useful when manufacturer controls feel restrictive.

Its central advantage is not one flashy feature. It is the combination of format coverage and reader control in v2026.07.1. Fixed-page material includes PDF, DjVu, CBT, and CBZ, while reflowable support includes EPUB, FB2, Mobi, DOC, RTF, HTML, CHM, and TXT. The bundled K2pdfopt library can reflow scanned PDF and DjVu documents, an especially useful capability on a small e-ink screen where a full page is otherwise unreadable. ZIP support is available for some formats too.

What happened when we ran it

We did not run KOReader at commit 2e28a3c. Our sandbox was a fresh Debian container with 3 CPUs and 8 GB of RAM, but our review harness has no supported ecosystem for Lua projects, and this repository has no Dockerfile that would provide another reproducible route. As a result, we did not install it, compile it, or execute its tests. There are no honest timing, build, or test-pass figures for us to report.

That limitation is about our run, not proof that KOReader itself is broken. It does mean we cannot tell you how much work a clean build takes, whether all tests pass on Debian, or how the interface behaves on real e-ink hardware. The README offers 7 platform installation paths, so check the page for your exact model and firmware before changing a reader you depend on.

Its strongest tools solve real e-ink problems

KOReader's feature list is unusually well matched to the constraints of e-ink. Its interface avoids animation, uses paginated menus, and lets readers adjust text contrast, zoom to content, or fit a whole page. Those choices matter more on a slow-refresh display than visual polish designed for a phone. For reflowable books, users can set arbitrary margins, override line spacing, add external fonts and styles, and use bundled multilingual hyphenation dictionaries. That is a meaningful upgrade when stock software offers only 3 or 4 coarse layout presets.

The integrations connect reading to an existing library rather than trapping books inside one device. KOReader can search Calibre metadata, receive books wirelessly, and browse OPDS catalogs. It also documents connections to Wallabag, Wikipedia, Google Translate, online OPDS catalogs, and RSS feeds. StarDict lookup supports offline reference work, while plugins provide an expansion route. Advanced extras include updates and 2 network services, FTP and SSH, which deserve more care than changing a font.

The rough edges are part of the bargain

The largest drawback is installation uncertainty. A project spanning at least 7 named platforms cannot offer the same experience on every model, and the README correctly sends users to model-specific instructions. That makes KOReader a poor impulse install for someone who expects official vendor support or an app-store rollback. We also could not validate setup ourselves, so this review cannot settle device-specific questions.

The interface's depth may become clutter for readers who only open EPUB files and turn pages. PDF reflow, custom styles, OPDS, FTP, SSH, dictionaries, and plugins are valuable, but each adds options. The README cites a historical result of less than 1/2 the stock software's page-turn delay on some older devices, but gives too little detail here to generalize it to current hardware. We would not buy a device based on that claim alone.

AGPL-3.0 is another deliberate tradeoff. It protects the project's open-source character, but organizations embedding or modifying KOReader should review their distribution and network-use obligations instead of treating it like a permissively licensed component. Individual readers may never feel this constraint. Product teams could. Meanwhile, 1,322 open issues signal both a large surface area and a substantial support queue, not a simple verdict on quality.

The project looks active, despite the issue backlog

Health is best judged from several signals together. The latest listed release, v2026.07.1, arrived on August 1, 2026, and the repository was pushed on September 1, one day before this review. Combined with 29,422 stars and development dating back to 2013, that looks like an established project receiving current work. The 1,322 open issues remain worth inspecting for your particular device, especially before altering older or unusual hardware.

Support is community-led: volunteers maintain code, translations, documentation, a wiki, and a MobileRead forum presence. The README also links a user guide, developer documentation, build instructions, porting guidance, Weblate, coverage status, and continuous integration status. That is a better documentation shape than a README alone, though the existence of links does not prove every device page is current. Donations go through 1 named service, Liberapay.

It belongs on the reading device, with Calibre beside it

In a practical setup, KOReader is the reading layer, not necessarily the entire library system. Calibre can remain the desktop catalog and conversion hub, while KOReader handles wireless receipt, OPDS browsing, and the actual reading experience. Wallabag can feed saved articles, StarDict can provide local dictionaries, and online services can fill specific lookup needs. Its 2 optional network tools, FTP and SSH, need not replace general file management.

Choose KOReader when a stock interface prevents comfortable reading of PDFs, scanned documents, multilingual text, or carefully typeset ebooks. Choose Foliate for a simpler Linux desktop reader, Calibre when library management is the main job, or Plato when a compatible Kobo and a narrower design are the priority. KOReader earns its place through control and device reach, but first follow 1 of its platform guides and plan a reversible installation for your exact model.

Alternatives

ProjectWhat it isPick it when
FoliateA polished desktop ebook reader designed for Linux.pick this instead when you read mainly on a Linux desktop and do not need e-ink device support
calibre gh↗A desktop ebook library manager, converter, reader, and device-sync suite.pick this instead when organizing, converting, and transferring a large library matters more than the on-device reading interface
PlatoA minimalist document reader aimed at Kobo devices.pick this instead when you own a compatible Kobo and prefer a narrower, more minimal reader

What people are saying

  1. [velocity-scout] koreader/koreader

Sources

  1. KOReader GitHub repository
  2. KOReader homepage
  3. KOReader user guide
  4. KOReader releases

More self-hosted reviews

openwrt · linera-protocol · headscale · v2 · OpenShell · wigolo · the whole board →