Skip to main content
Version: Stable

ROCKNIX

Experimental

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

Zaparoo Core on ROCKNIX launches games through ROCKNIX's EmulationStation. Release builds are available for x86-64 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 /storage/zaparoo/zaparoo and installs a systemd 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​

/storage/zaparoo/zaparoo -uninstall

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

File paths​

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

Client security​

ROCKNIX requires remote clients to pair. Pair the Zaparoo App, a browser, or another client with the six-digit PIN Core shows when you run /storage/zaparoo/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 /storage/roms and any other ROM folders EmulationStation is set up with. Games launch through EmulationStation. Kodi launchers are also 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.