Skip to main content
Version: Stable

Knulli

Experimental

Knulli support is experimental and not listed as a supported platform yet. Expect missing features and rough edges.

Zaparoo Core on Knulli launches games through Knulli's EmulationStation. Release builds are available for ARM and ARM64 devices.

Install​

Open a terminal on the device or connect to it over SSH, then run:

curl -fsSL https://zaparoo.org/install.sh | sh

The installer copies Core to /userdata/system/zaparoo and registers it as a Knulli service, so it starts on boot.

Once Core is running, write your first token from the Zaparoo App or the built-in web UI at http://<device-ip>:7497/app/.

Uninstall​

/userdata/system/zaparoo -uninstall

This stops and removes the service. Delete /userdata/system/zaparoo, and the config and data directories if you also want to remove your settings.

File paths​

ItemPath
Config file/userdata/system/.config/zaparoo/config.toml
Data directory/userdata/system/.local/share/zaparoo
Log file/userdata/system/.local/share/zaparoo/logs/core.log
Mappings directory/userdata/system/.local/share/zaparoo/mappings

Client security​

Knulli requires remote clients to pair. Pair the Zaparoo App, a browser, or another client with the six-digit PIN Core shows when you run /userdata/system/zaparoo -pair. The PIN expires after five minutes. See encryption for how paired clients and their permissions work.

Readers​

Each reader's page has setup steps and troubleshooting. See readers to compare them.

Launchers​

Core adds a launcher for each system EmulationStation has, and indexes games from /userdata/roms and any other ROM folders EmulationStation is set up with. Games launch through EmulationStation. When Kodi is installed, Kodi launchers are added for local video and music files.

Plex and Jellyfin launchers play on a TV or other player, and the RomM launcher downloads games from a RomM server. See Media Servers.

Stopping a game is the only launcher control available.

Input commands type on a virtual keyboard. The virtual gamepad is off by default; turn it on with gamepad_enabled.

Shell scripts can also be launched. Add them to the allow_file list in config.toml.