LibreELEC

danger

This platform isn't released yet! It's not ready for production use.

warning

LibreELEC support is still in beta. The Zaparoo App and most hardware is supported, but launching media is done via shell scripts until proper launcher support is added.

Item	Path
Data directory	/storage/.local/share/zaparoo
Mappings directory	/storage/.local/share/zaparoo/mappings
Config file	/storage/.config/zaparoo/config.toml
Log file	/tmp/<session_id>-zaparoo/core.log

Install

Download Zaparoo Core for Linux from the Downloads page, unzip it and copy the zaparoo file to /storage/.local/bin. This guide assumes you copied it to this location.

tip

LibreELEC is a minimal Linux distribution, so you'll need to use SSH for installation. You can enable SSH in the LibreELEC settings menu under Services > SSH Server. The default credentials are (username: root, password: libreelec).

SSH into your device and go to the directory where you copied the zaparoo file:

cd /storage/.local/bin

Run the install command in Zaparoo:

./zaparoo -install

info

This command does the following:

• Creates a udev rule allowing users to read NFC reader serial devices.
• Creates a modprobe blacklist entry to fix a bug stopping ACR122U readers from working.
• Creates a user systemd service to run Zaparoo in the background.

Start the Zaparoo service by either using the systemd service:

systemctl --user enable zaparoo.service
systemctl --user start zaparoo.service

Or just by adding the zaparoo file to your startup applications.

From this point, Zaparoo should be running and the App should connect to your device. You can now connect a reader and set up cards using the Zaparoo App.

If you want to undo the changes performed by the install command, you can run the uninstall command:

./zaparoo -uninstall

Launchers

Currently, you must use shell scripts to launch media on Linux. See the Linux page for more information on how to set up launchers this way.