App Store Plugin For KOReader

[omerfaruq]

- Sort and filter plugins according to your needs.
- Install plugins and patches directly on your device
- Check for updates and do the updates
- Match plugins/patches that are not installed via App Store to check updates, also for them
- You need a GitHub account and a (free) token to utilize this plugin.
- This plugin includes all the plugins that have [name].koplugin , [koreader.patches] as their name, or topics [koreader-plugin], [koreader-user-patch].

You can download the plugin from this repo: https://github.com/omer-faruq/appstore.koplugin

[oleasteo]

I haven't tried it yet, but it looks very promising. Thanks!

Does it support having the main.lua / _meta.lua not in the root directory? I like to keep mine in a sub-folder (no need to bundle all assets, etc. onto the devices); see screenlockpin for example. It could probably check for some .koplugin directory inside the repository.

[omerfaruq]

Originally Posted by oleasteo

Does it support having the main.lua / _meta.lua not in the root directory? I like to keep mine in a sub-folder (no need to bundle all assets, etc. onto the devices); see screenlockpin for example.

Yes, it does. It searches for _meta.lua to determine the related subfolder. I tried to install screenlockpin, and it installed without a problem.

[pmd]

Installed this on my Kobo with Koreader but on checking for updates it doesn't find any updates. For example I have "screenlockpin.koplugin--2025.10-2" installed but no update is listed for it? Do I need to remove my manual install and then re-install via the appstore?

[omerfaruq]

Originally Posted by pmd

Do I need to remove my manual install and then re-install via the appstore?

To check updates, the "Repo" line should be filled with the correct repository information.

You have two options :

• use match button to match the plugin with a repo (I prefer this one)
• reinstall it via App Store plugin

Either should work.

[pmd]

Thanks - I reinstalled it from the app store which worked (though it did reset config settings I'd made to keep the pin lock screen full screen but my PIN was kept)....

Really handy plugin as keeping track of updates is a real pain without this!

[Tawar]

Unfortunately, I can't get the AppStore to work.
I downloaded the package. I created a Github key, customized the file, and copied the folder to my Pocketbook Inpad Color 3.

The folder was called appstore.koplugin-main, and I renamed it to appstore.koplugin before uploading it.

The AppStore is also displayed in KOReader. As soon as I try to open it, KOReader restarts. I can't see the AppStore.

Where am I going wrong? What step have I overlooked?

[omerfaruq]

Originally Posted by Tawar

Unfortunately, I can't get the AppStore to work.
I downloaded the package. I created a Github key, customized the file, and copied the folder to my Pocketbook Inpad Color 3.

The folder was called appstore.koplugin-main, and I renamed it to appstore.koplugin before uploading it.

The AppStore is also displayed in KOReader. As soon as I try to open it, KOReader restarts. I can't see the AppStore.

Where am I going wrong? What step have I overlooked?

Your steps seem fine to me. Could you share the related part of the crash.log? It should be under the koreader folder.

[Tawar]

12/14/25-11:27:40 INFO [Filebrowser] Filebrowser started. Find Filebrowser logs at /mnt/ext1/applications/koreader/plugins/filebrowser.koplugin/filebrowser/filebrowser.log
2025/12/14 11:28:07 Using database: /mnt/ext1/applications/koreader/plugins/filebrowser.koplugin/filebrowser-new.db
2025/12/14 11:28:07 No config file used
[3591:14/12/25 11:27:48] netagent called with parameters < ping >
[3599:14/12/25 11:28:18] netagent called with parameters < ping >
12/14/25-11:28:37 WARN appstore cache directory creation failed File exists (creating `./cache/appstore/` for `./cache/appstore`)
./luajit: common/lua-ljsqlite3/init.lua:60: ljsqlite3[cantopen] unable to open database file
stack traceback:
common/lua-ljsqlite3/init.lua:60: in function 'err'
common/lua-ljsqlite3/init.lua:347: in function 'open'
plugins/appstore.koplugin/appstore_cache.lua:57: in function 'openConnection'
plugins/appstore.koplugin/appstore_cache.lua:191: in function 'init'
plugins/appstore.koplugin/appstore_cache.lua:65: in function 'fetchRows'
plugins/appstore.koplugin/appstore_cache.lua:295: in function 'listRepos'
plugins/appstore.koplugin/main.lua:3992: in function 'getRepoDescriptors'
plugins/appstore.koplugin/main.lua:3226: in function 'getFilteredDescriptors'
plugins/appstore.koplugin/main.lua:3638: in function 'buildBrowserEntries'
plugins/appstore.koplugin/main.lua:3760: in function 'showBrowser'
plugins/appstore.koplugin/main.lua:4632: in function 'callback'
...
frontend/ui/widget/container/widgetcontainer.lua:101: in function 'handleEvent'
frontend/ui/widget/container/widgetcontainer.lua:83: in function 'propagateEvent'
frontend/ui/widget/container/widgetcontainer.lua:101: in function 'handleEvent'
frontend/ui/uimanager.lua:896: in function 'sendEvent'
frontend/ui/uimanager.lua:53: in function '__default__'
frontend/ui/uimanager.lua:1423: in function 'handleInputEvent'
frontend/ui/uimanager.lua:1523: in function 'handleInput'
frontend/ui/uimanager.lua:1567: in function 'run'
./reader.lua:265: in main chunk
[C]: at 0x00013ee1
stack traceback:
[C]: in function 'error'
common/lua-ljsqlite3/init.lua:60: in function 'err'
common/lua-ljsqlite3/init.lua:347: in function 'open'
plugins/appstore.koplugin/appstore_cache.lua:57: in function 'openConnection'
plugins/appstore.koplugin/appstore_cache.lua:191: in function 'init'
plugins/appstore.koplugin/appstore_cache.lua:65: in function 'fetchRows'
plugins/appstore.koplugin/appstore_cache.lua:295: in function 'listRepos'
plugins/appstore.koplugin/main.lua:3992: in function 'getRepoDescriptors'
plugins/appstore.koplugin/main.lua:3226: in function 'getFilteredDescriptors'
plugins/appstore.koplugin/main.lua:3638: in function 'buildBrowserEntries'
plugins/appstore.koplugin/main.lua:3760: in function 'showBrowser'
...
frontend/ui/widget/container/widgetcontainer.lua:101: in function 'handleEvent'
frontend/ui/widget/container/widgetcontainer.lua:83: in function 'propagateEvent'
frontend/ui/widget/container/widgetcontainer.lua:101: in function 'handleEvent'
frontend/ui/uimanager.lua:896: in function 'sendEvent'
frontend/ui/uimanager.lua:53: in function '__default__'
frontend/ui/uimanager.lua:1423: in function 'handleInputEvent'
frontend/ui/uimanager.lua:1523: in function 'handleInput'
frontend/ui/uimanager.lua:1567: in function 'run'
./reader.lua:265: in main chunk
[C]: at 0x00013ee1
Process has been terminated by signal {SIGSEGV::SEGV_MAPERR}
Segmentation fault
!!!!
Uh oh, something went awry... (Crash n°1: 12/14/25 @ 11:28:37)
Attempting to restart KOReader . . .
!!!!
---------------------------------------------
launching...
_ _____ ____ _
| |/ / _ \| _ \ ___ __ _ __| | ___ _ __
| ' / | | | |_) / _ \/ _` |/ _` |/ _ \ '__|
| . \ |_| | _ < __/ (_| | (_| | __/ |
|_|\_\___/|_| \_\___|\__,_|\__,_|\___|_|

[omerfaruq]

Originally Posted by Tawar

...
12/14/25-11:28:37 WARN appstore cache directory creation failed File exists (creating `./cache/appstore/` for `./cache/appstore`) ...

Please check if there is already a file named "appstore" in the "koreader/cache" folder. If there is, then you need to delete it or temporarily move it to be able to use this plugin.

[Tawar]

Originally Posted by omerfaruq

Please check if there is already a file named "appstore" in the "koreader/cache" folder. If there is, then you need to delete it or temporarily move it to be able to use this plugin.

yes... i delete the Appstore folder... now it works... thank you very much