Skip to content
dmatthanPublic

About

AirPlay 2 receiver config for Arch Linux, with auto firewall setup, tray controls and a TUI.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

Repository files navigation

raopctl

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 playing a song

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

Install

git clone https://github.com/dmatthan/raopctl
cd raopctl/dist
makepkg -si
raopctl setup

raopctl remove undoes everything setup did; run it before uninstalling the package. After an upgrade, run systemctl --user try-restart raopctl-agent.service && raopctl restart.

Usage

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.

Notes

  • 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, start raopctl agent from 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.

Themes

The view uses your terminal's colours, or the current shell theme if supported.

raopctl in four themes

Retro 82 (top), Rosé Pine, Kanagawa, Everforest and Jade Horse, each with its own wallpaper.

License

BSD 3-Clause. See LICENSE.

About

AirPlay 2 receiver config for Arch Linux, with auto firewall setup, tray controls and a TUI.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages