ArkOS
ArkOS support is experimental and not listed as a supported platform yet. Expect missing features and rough edges.
Zaparoo Core on ArkOS and dArkOS launches games with the same commands EmulationStation uses. 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 /home/ark/.config/zaparoo/zaparoo and installs a systemd service, so it starts on boot. It asks for your password through sudo when you are not root.
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
sudo /home/ark/.config/zaparoo/zaparoo -uninstall
This stops and removes the service. Delete /home/ark/.config/zaparoo if you also want to remove your settings and data.
File paths
| Item | Path |
|---|---|
| Config file | /home/ark/.config/zaparoo/config.toml |
| Data directory | /home/ark/.config/zaparoo |
| Log file | /home/ark/.config/zaparoo/logs/core.log |
| Mappings directory | /home/ark/.config/zaparoo/mappings |
Client security
ArkOS requires remote clients to pair. Pair the Zaparoo App, a browser, or another client with the six-digit PIN Core shows when you run /home/ark/.config/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 in EmulationStation's es_systems.cfg, and indexes games from /roms, plus /roms2 when a second SD card is in use. To launch a game, Core closes EmulationStation, runs the game the way EmulationStation would, including per-game emulator and core choices, and brings EmulationStation back when the game exits. Games started from EmulationStation also show as playing in Zaparoo.
The RomM launcher downloads games from a RomM server. See Media Servers.
RetroArch launcher controls, such as save states, need RetroArch's network commands. Core does not change your RetroArch config, so turn them on yourself by setting this line in /home/ark/.config/retroarch/retroarch.cfg, and in /home/ark/.config/retroarch32/retroarch.cfg for 32-bit cores:
network_cmd_enable = "true"
Input commands are accepted but nothing is typed.
Shell scripts can also be launched. Add them to the allow_file list in config.toml.