Skip to main content
This is unreleased documentation for the next Zaparoo Core release.
For up-to-date documentation, see the latest version (Stable).
Version: Next

Lakka

Experimental

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

Zaparoo Core on Lakka loads games into the running RetroArch. Release builds are available for x86-64, 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 /storage/zaparoo/zaparoo and installs a systemd service, so it starts on boot.

Core controls RetroArch through its network commands, so the install turns them on in /storage/.config/retroarch/retroarch.cfg. If they were off before, it also adds a firewall rule so only the Lakka device itself can send those commands.

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. If the install turned on RetroArch network commands, uninstalling turns them off again and removes the firewall rule. 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​

Lakka 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 RetroArch launchers for supported systems and indexes games from ES-DE-style system folders under /storage/roms, such as nes, snes, and megadrive. It also adds a launcher for each RetroArch playlist in /storage/playlists, which launches each entry with the core the playlist names.

The RomM launcher downloads games from a RomM server. See Media Servers.

Stopping a game closes it and leaves the RetroArch menu open. The other RetroArch launcher controls are available, such as save states, pause, and disc swapping.

Input commands are accepted but nothing is typed.