NickelMenu
The easiest way to launch custom scripts, change hidden settings, and run actions on Kobo eReaders.
___
![]()
![]()
![]()
NickelMenu adds custom actions the main and/or reader menus. It works on firmware 4.6+, and persists between firmware upgrades.
Installation:
Features:
Troubleshooting/FAQ:
Credits:
Download | Documentation | Source Code | Release Notes
The easiest way to launch custom scripts, change hidden settings, and run actions on Kobo eReaders.
___
NickelMenu adds custom actions the main and/or reader menus. It works on firmware 4.6+, and persists between firmware upgrades.
Installation:
- Connect your Kobo eReader to your computer over USB.
- Download KoboRoot.tgz (release notes) into KOBOeReader/.kobo. You may need to show hidden files to see the folder.
- Safely eject your eReader and wait for it to reboot.
- Ensure there is a new menu item in the top-left main menu entitled NickelMenu
- Connect you Kobo eReader to your computer again and create a new file (of any type) named KOBOeReader/.adds/nm/config, and follow the instructions in KOBOeReader/.adds/nm/doc to configure NickelMenu.
Features:
- A built-in failsafe will automatically remove NickelMenu if any fatal error occurs, and will never result in an unbootable Kobo. Non-fatal errors will appear as a menu item with more details.
- Multi-version compatiblity (even for future versions).
- Many built-in actions:
- Debug messages (dbg_syslog, dbg_error, dbg_msg, dbg_toast).
- Nickel settings (nickel_setting:{invert,lockscreen,screenshots,for ce_wifi}).
- Nickel extras (nickel_extras:{web_browser,unblock_it,sketch_pad, solitaire,sudoku,word_scramble}).
- Other Nickel stuff (nickel_misc:{force_usb_connection,rescan_books,re scan_books_full}).
- Launch system commands and optionally display the output (cmd_spawn,cmd_output).
- KFMon (kfmon, kfmon_id).
- Action chaining.
- Simple configuration format with support for multiple configuration files.
- Comprehensive logging to syslog (view over telnet or SSH with logread, or enable developer options and see the syslog files in KOBOeReader/.kobo).
- No system files are ever touched directly, and no patching is required.
- Automatically generate items for actions like kfmon.
- Reload configuration files without a reboot.
- More actions and settings.
- Log viewer.
- More menu locations.
- Custom browser URL and injected stylesheet.
Troubleshooting/FAQ:
- I don't see any menu items in the main menu
Try re-installing NickelMenu. If it still doesn't appear, please reboot and post the contents of the syslog. - I rebooted, and NickelMenu suddenly disappeared
You probably triggered the failsafe (if you rebooted within 20 seconds after first turning it on). - I want to uninstall NickelMenu
Create a new file named KOBOeReader/.adds/nm/uninstall, then reboot your Kobo. - I want to update NickelMenu
Follow the installation process again. Your configuration files will be preserved. - When I press one of the actions, I get an error message about dlsym
Something has probably changed in your firmware version. Try updating NickelMenu, and if it still doesn't work, please post your current version and the action you are trying to use. - When I try to open a file in KOBOeReader/.adds/nm, I get asked what I want to open it with
Open it with a text editor, for example, Notepad, Notepad++, or Visual Studio Code. - When I open a configuration file, everything is jumbled in one long line
Open it with a different text editor which supports unix line breaks. If you are trying to view the documentation, it is also available online. - I need help writing a configuration file
There is an example configuration file in the documentation. If you still need help, feel free to post in this thread. - I found a bug in NickelMenu
Try re-installing NickelMenu. If that still doesn't work, please post your syslog, your configuration file, and a description of the issue in this thread or on GitHub. - I would like to request a new feature
Please post it in this thread or open an issue on GitHub. - I receive an error message when trying to launch a KFMon action
Make sure the launcher name you specified is correct. It should look like action.png or something similar. Also, make sure you have installed the latest version of KFMon and try re-installing NickelMenu. - How do I configure NickelMenu
Read the instructions above again, and see the documentation.
Credits:
- geek1011 (@geek1011): Original idea, reverse engineering, implemented core functionality, implemented most actions.
- sherman (@shermp): Implemented action chaining, tested everything, provided feedback and ideas.
- NiLuJe (@NiLuJe): Implemented kfmon action, tested everything, provided feedback and ideas.
- jackie_w (@jackiew1): Did some testing, provided feedback and ideas.
Download | Documentation | Source Code | Release Notes