Skip to main content
Version: Stable

AmberELEC

Experimental

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

Zaparoo Core on AmberELEC launches games through AmberELEC's EmulationStation. Release builds are available for 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.

On AmberELEC releases too old for the installer's download checks, the installer stops and asks you to update to the AmberELEC prerelease. To install by hand instead, download the AmberELEC build from the Downloads page, extract it to /storage/zaparoo, and run:

/storage/zaparoo/zaparoo -install

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​

AmberELEC 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.