workflowstacks
local-ai

koreader: Multi-format eBook Reader

Get a versatile eBook reader for various devices. For founders needing eBook solutions, backed by 28k+ GitHub stars.
29,040 stars1,869 forksLuaHealth Score 8/10Updated 8/15/2026100% free · open source
What it does

Koreader is an ebook reader application that supports various formats such as PDF, DjVu, EPUB, and FB2, allowing users to read ebooks on devices like Cervantes, Kindle, Kobo, PocketBook, and Android devices

Install / run
To install Koreader, clone the repository from GitHub using the command `git clone https://github.com/koreader/koreader.git`
When to use it
  • When you need to read ebooks in multiple formats on a single device
  • When you want to customize your ebook reading experience with features like font sizes, margins, and lighting
  • When you need to read ebooks on a device with limited storage capacity, as Koreader is a lightweight application
Quick start
  1. 1Clone the Koreader repository and navigate to the directory using `cd koreader`
  2. 2Build the application using the command `luarocks make manifest.lua`
  3. 3Create a new folder for your ebooks and add your ebooks to it, then configure Koreader to read from this folder by editing the `koreader.lua` file
  4. 4Launch Koreader using the command `luarocks run koreader`
  5. 5Customize your reading experience by editing the `koreader.lua` file to change settings like font size, margin, and lighting
Ready-to-paste prompt
To open an ebook in Koreader, use the command `luarocks run koreader /path/to/your/ebook.epub`
Heads up: Koreader requires LuaRocks to be installed on your system, and you need to have the `luarocks` command available in your system's PATH to build and run Koreader
Saves to your device

Topics

cbz
djvu
djvu-reflow
ebook
ebook-reader
eink
epub
ereader
fb2
kindle
kobo
luajit
opds
pdf
pdf-reflow
pocketbook
reader
reflow
remarkable-tablet
ubuntu-touch
How koreader: Multi-format eBook Reader works
Codeflow
Free to inspect

Koreader: Multi-format eBook Reader is a very large Lua project (~202k lines across 518 code files, plus 84 test files). It is a full software project: use it through its install path rather than reading it end to end. Last commit this month, AGPL-3.0 license, has a test suite.

Size
Very large codebase
~202k lines · 518 code files · days to read — use, don't read
Setup
Developer setup
A real software project. Use it via its install path; don't expect to read it all.
Runs on
Lua
No API keys detected
Lua 97%Shell 2%
Where to start reading
  1. 1
    README.md
    Start here — what it does and how to install it
What's in each folder
frontend/Frontend / UI348 files
plugins/Sub-packages / plugins123 files
doc/Documentation11 files
resources/Folder160 files
metadata/Folder67 files
platform/Folder62 files
make/Folder20 files
tools/Helper scripts16 files
READMEHas testsDocumentedCI checksAGPL-3.0 licenseUpdated this month
Quick Actions
Details
Creator
koreader
Language
Lua
Category
local-ai
Published
3/24/2013

Are you the creator of this tool? Claim your listing → and earn 85% of every sale.