macOS

Experimental

macOS builds are experimental and not listed as a supported platform yet. Expect missing features.

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

Uninstall

./zaparoo -uninstall

Readers

NFC/RFID

PN532 USB✓Supported

Auto-detected

PN532 Module✓Supported

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

ACR122U×Not supported

Not included in the current macOS Core reader set.

RC522!Limited

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

Barcode and QR

Zaparoo App camera✓Supported

Via Zaparoo App

RS-232 scanner✓Supported

Manual config

Optical and Media

Optical Drive×Not supported

Linux only

External Drive✓Supported

Manual enable

Custom and Virtual

MQTT Reader✓Supported

Manual config

Simple Serial✓Supported

Manual config

File Reader✓Supported

Manual config

Displays and Integrations

TTY2OLED✓Supported

Manual enable

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.