You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Go to file
poire-z 001e90db1e ReaderSearch: delay adding to location stack until we change page
Search may highlight matches on the current page, and if there
are no others in the book, we would stay there and resume reading;
but we would get a spurious previous location (ie. in Book map)
that we would not expect keeping, and we may accidently go back
to previous location, losing our reading position.
Avoid this by only adding current page to location stack when
actually leaving the current page.
Because of complications with other reading modes, this is
currently only enabled for CRE document when in page mode.
4 weeks ago
.ci ci: remove CircleCI unnecessary steps 2 months ago
.circleci ci: bump docker images 1 month ago
.github ci: small macOS cleanups 1 month ago
base@9a90ea8812 bump base (#11748) 4 weeks ago
doc doc: remove ragel from the build requirements (#11661) 2 months ago
frontend ReaderSearch: delay adding to location stack until we change page 4 weeks ago
l10n@76f8b999c8 Update translations for v2024.04 (#11726) 1 month ago
metadata update metadata & translations 2 years ago
platform bump luajit-launcher 1 month ago
plugins Statistics: handle correctly page change when reading paused 4 weeks ago
resources Bookmark flipping mode fix (#10196) 1 year ago
spec/unit Annotations, part 1 (#11563) 1 month ago
test@86eeb0b43d various test/coverage optimization 8 years ago
tools Chore: Review FrameContainer constructors for shared dimen objects 5 months ago
.busted Travis update 9 years ago
.codecov.yml [CI] Add .codecov.yml (#4695) 5 years ago
.editorconfig experimental port to Mac OSX 8 years ago
.gitignore Add macOS target 4 years ago
.gitmodules l10n: mark git submodule for shallow updates 2 months ago
.luacheckrc Cleanup various varargs shenanigans (#9624) 2 years ago
.luacov [CI] Also run coverage on plugins (#3447) 7 years ago
.luarc.json Add a config file for the Lua LSP (#10611) 11 months ago
.shellcheckrc [CI] Add curly braces check (#5809) 4 years ago
COPYING switch license to AGPLv3 10 years ago
Makefile make: speedup `fetchthirdparty` 2 months ago
README.md Remove bountysource from README (#11385) 3 months ago
datastorage.lua DocSettings: check legacy history location only once (#11439) 4 months ago
defaults.lua ImageViewer: menu to invert rotations and set auto rotation (#11206) 6 months ago
kodev Never export LD_LIBRARY_PATH 11 months ago
reader.lua Reader: use existing module instances on start (#11485) 3 months ago
setupkoenv.lua Env: Actually use the full ffi.load signature in our overload 11 months ago

README.md

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