An AirPlay 2 receiver for Arch Linux. Select your computer from the AirPlay menu on an iPhone, iPad or Mac and the audio plays through its speakers. No need to run heavy music streaming apps, or keep switching between tabs: your phone is the remote and raopctl plays your audio in the background, with almost zero CPU util or system memory usage.
raopctl configures the packaged shairport-sync and nqptp and adds:
- a terminal view: the track, cover art, a spectrum meter and all settings
- a tray icon with the common controls, and optional track notifications
raopctl setup, which allows AirPlay through the firewall for local networks only, enables clock sync and discovery, and prints each sudo command before running it
git clone https://github.com/dmatthan/raopctl
cd raopctl/dist
makepkg -si
raopctl setupraopctl remove undoes everything setup did; run it before uninstalling
the package. After an upgrade, run
systemctl --user try-restart raopctl-agent.service && raopctl restart.
raopctl open the view in this terminal
raopctl open open it in its own window
raopctl on | off | toggle | restart
raopctl status [--json]
raopctl login on | off start the receiver at login
raopctl rename NAME change the name devices see
raopctl setup | remove both take --dry-run
raopctl --help lists the rest.
Settings are in ~/.config/raopctl/config.toml, and the view edits them too.
- Works with PipeWire or PulseAudio, ufw or firewalld, and sudo or run0. The meter needs PipeWire. With firewalld, setup prints the rules to add.
- The tray starts with
graphical-session.target. If your session doesn't reach it, startraopctl agentfrom your compositor's autostart. - Like any AirPlay speaker, anyone on your local network can play to it. Arch currently packages shairport-sync 5.0.4, and upstream has published advisories for that version that are fixed in 5.6.2. Until Arch updates it, use the receiver only on networks you trust.
The view uses your terminal's colours, or the current shell theme if supported.
Retro 82 (top), Rosé Pine, Kanagawa, Everforest and Jade Horse, each with its own wallpaper.
BSD 3-Clause. See LICENSE.

