Skip to main content

ChimeraOS

danger

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

warning

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

ItemPath
Data directory~/.local/share/zaparoo
Mappings directory~/.local/share/zaparoo/mappings
Config file~/.config/zaparoo/config.toml
Log file/tmp/<session_id>-zaparoo/core.log
Where ~ is the home directory of the current user.

Install

Download Zaparoo Core for Linux from the Downloads page, unzip it and copy the zaparoo file somewhere like the home directory or /usr/local/bin. This guide assumes you copied it to the home directory, replace paths in the examples if that's not the case.

tip

ChimeraOS is a console-focused Linux distribution, so you'll need to use the terminal for installation. You can access the terminal by pressing Ctrl+Alt+F2 and logging in with the default credentials (username: gamer, password: gamer).

Open terminal and go to the directory where you copied the zaparoo file:

cd $HOME

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.