Find a file
2023-12-15 16:36:06 -05:00
.github Updated GitHub token for releases 2020-11-17 01:57:18 -05:00
NickelHook@0ae9d9f9f7 Updated NickelHook 2020-08-05 01:36:57 -04:00
res Implement nickel_bluetooth action (#152) 2023-12-15 16:36:06 -05:00
src Implement nickel_bluetooth action (#152) 2023-12-15 16:36:06 -05:00
test/syms Add 4.36.21095 to symbol tests 2023-04-20 20:07:50 -04:00
.drone.yml Switched to GitHub Container Registry for NickelTC image 2020-11-15 14:14:23 -05:00
.gitignore Refactored common hook code into new NickelHook library (#64) 2020-07-27 11:11:58 -04:00
.gitmodules Refactored common hook code into new NickelHook library (#64) 2020-07-27 11:11:58 -04:00
LICENSE Update year 2023-04-20 20:08:08 -04:00
Makefile Added NM_CONFIG_DIR option to the Makefile (closes #68) 2020-08-03 15:59:28 -04:00
README.md Update README 2022-05-21 21:45:42 -04:00

NickelMenu

The easiest way to launch custom scripts, change hidden settings, and run actions on Kobo eReaders.

See the website and thread on MobileRead for screenshots and more details.

Installation

You can download pre-built packages of the latest stable release from the releases page, or you can find bleeding-edge builds of each commit from here.

After you download the package, copy KoboRoot.tgz into the .kobo folder of your eReader, then eject it.

After it installs, you will find a new menu item named NickelMenu with further instructions which you can also read here.

To uninstall NickelMenu, just create a new file named uninstall in .adds/nm/, or trigger the failsafe mechanism by immediately powering off the Kobo after it starts booting.

Most errors, if any, will be displayed as a menu item in the main menu. If no new menu entries appear here after a reboot, try reinstalling NickelMenu. If that still doesn't work, connect over telnet or SSH and check the output of logread.

Compiling

NickelMenu is designed to be compiled with NickelTC. To compile it with Docker/Podman, use docker run --volume="$PWD:$PWD" --user="$(id --user):$(id --group)" --workdir="$PWD" --env=HOME --entrypoint=make --rm -it ghcr.io/pgaskin/nickeltc:1.0 all koboroot. To compile it on the host, use make CROSS_COMPILE=/path/to/nickeltc/bin/arm-nickel-linux-gnueabihf-.