macOS

danger

This platform is in beta and not ready for production use.

Zaparoo Core on macOS supports shell script launching. Full launcher support is coming in a future release.

File Paths

Item	Path
Config file	~/Library/Preferences/zaparoo/config.toml
Data directory	~/Library/Application Support/zaparoo
Log file	~/Library/Logs/zaparoo/core.log
Mappings directory	~/Library/Application Support/zaparoo/mappings

Where ~ is the home directory of the current user.

Install

Download Zaparoo Core for macOS from the Downloads page, unzip it and copy the zaparoo file to /usr/local/bin.

cd /usr/local/bin
./zaparoo -install
launchctl load ~/Library/LaunchAgents/org.zaparoo.core.plist

To uninstall:

./zaparoo -uninstall

Readers

NFC/RFID

PN532 USBSupported

Auto-detected

PN532 ModuleSupported

Depends on wiringUART can auto-detect. I2C is supported.

ACR122UNot supported

Not included in the current macOS Core reader set.

RC522Limited

Via Simple SerialRequires a microcontroller; not a direct USB reader.

Barcode and QR

App/Camera ScannerSupported

Via Zaparoo App

RS232 ScannerSupported

Manual config

Optical and Media

Optical DriveNot supported

Linux only

External DriveSupported

Manual enable

Custom and Virtual

MQTT ReaderSupported

Manual config

Simple SerialSupported

Manual config

File ReaderSupported

Manual config

Displays and Integrations

TTY2OLEDSupported

Manual enable

Supported Launchers

Launcher	Notes
Shell Scripts	Custom .sh file execution

Create shell scripts to launch games, applications, or media. Add scripts to the allow_file list in config.toml and restart Zaparoo.