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
NiLuJe 8d3aacbac3 ReaderFooter: Fix the madness related to its hold footer
Namely, instead of making it lower priority than readerhighlight and
hoping for the best, make it higher priority, as it should (ReaderFooter
itself is *above* Reader, after all), with a sane set of fallthroughs:

* No footer
* No hold-to-skim
* Held outside the footer (but inside the footer tap zone)

This made the crap workaround from #7466 unnecessary, and actually fixes
the behavior in PDFs (because readerhighlight will match the *physical*
page, which may include off-screen content) and ePubs w/r eclaim bar
height (in which case, there's actual content behind the footer that
readerhighlight could have matched on).

Fix #7697
3 years ago
.ci CI: Update to Busted 2.0.0 3 years ago
.circleci [chore] (#6764) 4 years ago
.github Cache: Fix a whole lot of things. 3 years ago
base@2c264e54f4 Bump base (#7675) 3 years ago
doc Add Lua 5.1 to sample Debubuntu apt-get command (#7421) 3 years ago
frontend ReaderFooter: Fix the madness related to its hold footer 3 years ago
l10n@5eed1a41d2 Update translations for 2021.05 release (#7707) 3 years ago
metadata@98fd6c8fe0 add metadata, to be used by fdroid 4 years ago
platform android: avoid downloading the APK again if there's one download in progress + fix signature error (#7657) 3 years ago
plugins TextEditor: Disable on non-Touch devices 3 years ago
resources SortWidget: More tweaks 3 years ago
spec/unit Geom: nil guard a few rect methods (#7664) 3 years ago
test@86eeb0b43d various test/coverage optimization 8 years ago
tools Remove PNG icons, add koreader.svg 3 years 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 add metadata, to be used by fdroid 4 years ago
.luacheckrc Update UI layout code to use new SVG icons 3 years ago
.luacov [CI] Also run coverage on plugins (#3447) 7 years ago
.shellcheckrc [CI] Add curly braces check (#5809) 4 years ago
.travis.yml quickstart fix (#2804) 7 years ago
COPYING switch license to AGPLv3 10 years ago
Makefile android: keep bundled version in a dedicated text file (#7649) 3 years ago
README.md Remove sourceror.io (#6986) 3 years ago
datastorage.lua [CI] Mac OS app (#6955) 4 years ago
defaults.lua Cache: Fix a whole lot of things. 3 years ago
kodev reader.lua: rework file/directory argument handling. (#7053) 3 years ago
reader.lua FileManager/ReaderUI: Clarify the current instance accessor (#7658) 3 years ago
setupkoenv.lua The great Input/GestureDetector/TimeVal spring cleanup (a.k.a., a saner main loop) (#7415) 3 years 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

DownloadWikiDeveloper 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, CHM, TXT). Scanned PDF/DjVu documents can also be reflowed with the built-in K2pdfopt library.

  • 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), Evernote (export hightlights), 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

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

Please check 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, but you can also create a bounty to motivate others to work on a specific bug or feature request.

Contributors

Last commit Commit activity