Koreader, with all the submodules
Find a file
2025-07-21 22:25:31 +00:00
.ci [CI] git fetch first in after_success_docs_translation.sh (#13468) 2025-03-27 14:41:15 +01:00
.circleci ci/circle: fix ccache cache (#12802) 2024-11-26 16:39:47 +01:00
.forgejo/workflows Inject custom workflow 2025-07-21 22:25:31 +00:00
.github ci/macos: tweak ccache handling (#13141) 2025-01-25 23:05:14 +01:00
base@006b5fba2e Bump base (#13396) 2025-03-10 19:09:55 +01:00
doc Update some links in Porting.md (#13504) 2025-04-02 15:05:41 +02:00
frontend Quote directory in util.diskUsage (#13448) 2025-04-09 13:01:47 +02:00
l10n@f00869ff7f Update translations for v2025.04 (#13537) 2025-04-09 15:38:54 +02:00
make tests: drop nocov tags 2024-11-25 22:55:57 +01:00
metadata update metadata translations for fdroid/flathub (#12581) 2024-10-06 17:37:58 +02:00
platform avoid debian fonts (#13512) 2025-04-05 21:57:21 +02:00
plugins OPDSBrowser: analyze acquisition mimetype (#13535) 2025-04-09 13:01:04 +02:00
resources Fix KOReader spelling in the code (#12670) 2024-10-24 10:46:46 +02:00
spec/unit Highlights: quicker Style and Note marker dialogs (#13223) 2025-02-12 09:14:03 +02:00
test@c3b5d06e1a tests: speedup testsuite 2024-12-25 17:29:40 +01:00
tools tests: use new runner 2024-11-25 22:55:57 +01:00
.codecov.yml [CI] Add .codecov.yml (#4695) 2019-03-01 17:29:04 +01:00
.editorconfig experimental port to Mac OSX 2016-04-22 20:13:44 +08:00
.gitignore Add macOS target 2020-07-11 01:29:49 +02:00
.gitmodules l10n: mark git submodule for shallow updates 2024-04-16 18:58:45 +02:00
.luacheckrc tests: factorize UI related helpers 2024-12-25 17:29:40 +01:00
.luacov tests: use new runner 2024-11-25 22:55:57 +01:00
.luarc.json Add a config file for the Lua LSP (#10611) 2023-06-25 16:14:01 +02:00
.shellcheckrc [CI] Add curly braces check (#5809) 2020-02-02 20:35:21 +01:00
COPYING switch license to AGPLv3 2014-03-23 16:53:05 +08:00
datastorage.lua datastorage: add support for isolating data 2024-11-25 22:55:57 +01:00
defaults.lua Defaults: Deprecate DKOPTREADER_CONFIG_DOC_LANGS_TEXT 2024-09-11 13:20:39 +02:00
kodev kodev: tweak test command (#12864) 2024-12-07 13:27:02 +01:00
Makefile always compile with debug information (#13151) 2025-01-27 12:43:48 +01:00
reader.lua Kobo: Refactor various aspects of the Kaleido/MTK support (#12221) 2024-07-28 01:19:40 +02:00
README.md Remove bountysource from README (#11385) 2024-03-03 14:02:52 +01:00
setupkoenv.lua add provider module (#12641) 2024-12-18 19:40:22 +01:00

KOReader

KOReader is a document viewer primarily aimed at e-ink readers.

AGPL Licence Latest release Gitter Mobileread Build Status Coverage Status Weblate Status

DownloadUser guideWikiDeveloper docs

Main features

  • portable: runs on embedded devices (Cervantes, Kindle, Kobo, PocketBook, reMarkable), Android and Linux computers. Developers can run a KOReader emulator in Linux and MacOS.

  • multi-format documents: supports fixed page formats (PDF, DjVu, CBT, CBZ) and reflowable e-book formats (EPUB, FB2, Mobi, DOC, RTF, HTML, CHM, TXT). Scanned PDF/DjVu documents can also be reflowed with the built-in K2pdfopt library. ZIP files are also supported for some formats.

  • full-featured reading: multi-lingual user interface with a highly customizable reader view and many typesetting options. You can set arbitrary page margins, override line spacing and choose external fonts and styles. It has multi-lingual hyphenation dictionaries bundled into the application.

  • integrated with calibre (search metadata, receive ebooks wirelessly, browse library via OPDS), Wallabag, Wikipedia, Google Translate and other content providers.

  • optimized for e-ink devices: custom UI without animation, with paginated menus, adjustable text contrast, and easy zoom to fit content or page in paged media.

  • extensible: via plugins

  • fast: on some older devices, it has been measured to have less than half the page-turn delay as the built in reading software.

  • and much more: look up words with StarDict dictionaries / Wikipedia, add your own online OPDS catalogs and RSS feeds, over-the-air software updates, an FTP client, an SSH server, …

Please check the user guide and the wiki to discover more features and to help us document them.

Screenshots

Installation

Please follow the model specific steps for your device:

AndroidCervantesKindleKoboLinuxPocketbookreMarkable

Development

Setting up a build environmentCollaborating with GitBuilding targetsPortingDeveloper docs

Support

KOReader is developed and supported by volunteers all around the world. There are many ways you can help:

Right now we only support liberapay donations.

Contributors

Last commit Commit activity