📚 KOReader AppStore

Searching...

What is KOReader AppStore?

KOReader AppStore (appstore.koplugin) is a plugin for KOReader that discovers, installs and updates community-created KOReader plugins and user patches without leaving your e-reader. It searches GitHub for the koreader-plugin and koreader-user-patch topics, plus repositories named like KOReader.patches or [name].plugins, then handles the download, the _meta.lua check and the copy into the right folder for you.

This page is the web view of that same catalogue: the list at the top is fetched live from GitHub, so you can search, filter by owner or stars, sort, read a README and share a result list from a desktop browser before touching your device.

What it does

  • Unified browser for both plugins and user patches, with persistent filters and paging.
  • Search and filter by name, owner, description, topics, minimum stars and fork status.
  • README viewer that pulls README.md straight from GitHub.
  • Install and update pipeline for .koplugin archives and numbered patch files, with SHA comparison.
  • Offline-friendly cache under data/cache/AppStore, so fetched entries stay readable without a connection.
  • Ignore release to hide a specific update until a newer one appears.
  • Optional GitHub token to raise the API rate limit.

Installing the plugin

  1. Download the latest release.
  2. Copy the appstore.koplugin folder into KOReader’s plugin directory — koreader/plugins/ on Kobo and Kindle, /sdcard/koreader/plugins/ on Android, ~/.config/koreader/plugins/ on Linux.
  3. Restart KOReader.
  4. Open Tools → App Store.

Needs KOReader nightly or 2024.12+ and a network connection for downloads.

Frequently asked questions

What is the difference between a plugin and a user patch?

A plugin is a self-contained .koplugin folder that KOReader loads as an add-on. A user patch is a single numbered Lua file (for example 2-my-patch.lua) in koreader/patches that changes KOReader’s own behaviour at startup. AppStore browses and installs both.

Do I need a GitHub token?

No. Anonymous browsing works, but GitHub’s search API allows only about 10 requests per minute. Adding a classic personal access token (no scopes required) raises that to roughly 30 requests per minute. Fine-grained tokens are not supported by GitHub’s search API. On this page the token is stored in your browser only; in the plugin it goes into appstore_configuration.lua.

Which devices are supported?

Anything that runs KOReader nightly or 2024.12 and newer: Kobo, Kindle, PocketBook, reMarkable, Android, and the Linux, macOS and Windows desktop builds.

Does it work offline?

Browsing does. Results and READMEs are cached, so entries fetched earlier stay readable without a connection. Installing and updating still need network access, and a static nightly-built index is used as a fallback when GitHub’s API cannot be reached.

Is it safe to install community plugins?

Plugins and patches are plain Lua that runs with the same rights as KOReader itself. AppStore only fetches what upstream repositories publish; read the README and the source of anything you install, exactly as you would for any other third-party add-on.