KOReader’s interface can feel cluttered or overwhelming, especially for new users. This plugin lets you customize the menu system by hiding any menu items you don’t need, helping you streamline your reading experience and focus on what matters most.
- Download the plugin ZIP file from the Releases page
- Extract the ZIP to get the
menu_disabler.koplugin
folder - Transfer this folder to your KOReader plugins directory:
- Android:
/sdcard/koreader/plugins/
- Linux:
~/.config/koreader/plugins/
- Kobo:
/mnt/onboard/.adds/koreader/plugins/
- Kindle:
/mnt/us/koreader/plugins/
- Android:
- Restart KOReader
- Open KOReader's main menu
- Navigate to: More tools → Menu Disabler
- File Manager Menus: (When in file browser)
- Select "Customize File Manager Menus"
- Tap any menu item to enable/disable it
- Scroll to the last page and press Save
- Reader Menus: (When reading a document)
- Select "Customize Reader Menus"
- Tap any menu item to enable/disable it
- Scroll to the last page and press Save
- Reset to Default:
- Tap "Reset everything to Default" to restore all menus (File Manager and Reader) to their original state.
- This will remove any customizations you've made and reload the default KOReader menu structure.
- A confirmation dialog will appear before changes are applied.
- Copy File-Manager to Reader:
- Tap "Copy File-Manager settings to Reader" to apply your current File Manager menu configuration to the Reader menus.
- This is useful if you want a consistent menu layout across both modes. And it's fast if you are lazy.
- You can still further customize the Reader menu after copying.
Some critical items cannot be disabled on some devices:
- More Tools menu
- Plugin Management
- Patch Management
- After making changes, tap 💾 Save Changes
- Restart KOReader for changes to take effect
- Changes are automatically saved to:
settings/filemanager_menu_order.lua
settings/reader_menu_order.lua
- To reset a single menu type:
- Tap ↺ Reset All (Enable All) at the bottom of the customization screen
- To reset both menus:
- Use Reset everything to default in the main plugin menu
-
Access settings directory using a file manager (By using a usb connection or by using ssh):
- Android:
/sdcard/koreader/settings/
- Linux:
~/.config/koreader/settings/
- Kobo:
/mnt/onboard/.adds/koreader/settings/
- Kindle:
/mnt/us/koreader/settings/
- Android:
-
Delete configuration files:
filemanager_menu_order.lua
reader_menu_order.lua
-
If crashes persist:
- Remove the plugin:
- Delete
menu_disabler.koplugin
from your plugins directory Still persists?
- Delete
- Reset KOReader settings:
- Delete the entire
settings
directory (backup first if possible)
- Delete the entire
- Remove the plugin:
- Changes not appearing? After disabling a menu Scroll to the last page and press Save and Remember to restart KOReader after saving
- Menu items reappearing? Some core menus are protected and cannot be disabled
- Plugin not showing? Ensure the plugin folder is named exactly
menu_disabler.koplugin
For additional help:
- Open an issue on this repo
- Visit the KOReader forums
- Check the
DEBUG.md
file for advanced troubleshooting
Note: Always back up your KOReader settings before making major changes.