A simple, light weight audio receiver with Bluetooth (A2DP), AirPlay 1, Spotify Connect and Snapcast client. Original repository can be found here.
Devices like phones, tablets and computers can play audio via this receiver.
- RaspberryPi Zero W with internal Bluetooth or a USB Bluetooth dongle. Using the internal Bluetooth is possible but might lead to audio distortions if using other network heavy services
- Raspberry Pi OS Buster Lite (legacy)
- Please note: This version does not work with Raspberry Pi OS Bullseye or newer versions, as the zero 1 w chip cannot handle Bluetooth audio with Pulseaudio
- Internal audio, HDMI, USB or I2S Audio adapter (tested with Adafruit USB Audio Adapter, pHAT DAC, and HifiBerry DAC+)
The installation script asks whether to install each component.
wget -q https://github.com/Arcadia197/rpi-audio-receiver/archive/rpi-zero-w.zip
unzip rpi-zero-w.zip
rm rpi-zero-w.zip
cd rpi-audio-receiver-rpi-zero-w
sudo ./install.sh
All effects should come into play after restarting the device (mainly the device hostname).
Lets you choose the hostname and the visible device name ("pretty hostname") which is displayed as Bluetooth name, in AirPlay clients and in Spotify.
Sets up Bluetooth, adds a simple agent that accepts every connection, and enables audio playback through Alsa (via BlueAlsa). A udev script is installed that disables discoverability while connected.
Installs Shairport Sync AirPlay Audio Receiver.
Installs a working version of Raspotify, an open source Spotify client for Raspberry Pi. The version 0.31.4 was the last version working without troubles with the RPi zero w. More information can be found in this issue, especially this comment
Installs Snapclient, the client component of the Snapcast Synchronous multi-room audio player.
There are some further examples, tweaks and how-tos in the GitHub Wiki or the wiki of the original repo.
These scripts are tested and work on a current Raspberry Pi OS Legacy setup on Raspberry Pi Zero W 1. Depending on your setup (board, configuration, sound module, Bluetooth adapter) and your preferences, you might need to adjust the scripts. They are held as simple as possible and can be used as a starting point for additional adjustments.
This project does not really support upgrading to newer versions of this script. It is meant to be adjusted to your needs and run on a clean Raspberry Pi OS install. When something goes wrong, the easiest way is to just wipe the SD card and start over. Since apart from Bluetooth pairing information all parts are stateless, this should be ok.
Updating the system using apt-get upgrade
should work however.
This project does not support uninstall at all. As stated above, it is meant to run on a dedicated device on a clean Raspberry Pi OS. If you choose to use this script along with other services on the same device, or install it on an already configured device, this can lead to unpredictable behaviour and can damage the existing installation permanently. However, the important modules can be purged with the following commands. This does however not remove residual files and is experimental:
sudo apt-get purge raspotify shairport-sync snapclient
sudo systemctl disable bthelper@hci0.service bt-agent@hci0.service
sudo systemctl stop bthelper@hci0.service bt-agent@hci0.service
This site gives information on residual files of shairplay which could be checked for removal.
Package and configuration choices are quite opinionated but as close to the Debian defaults as possible. Customizations can be made by modifying the scripts, but the installer should stay as simple as possible, with as few choices as possible. That said, pull requests and suggestions are of course always welcome. However I might decide not to merge changes that add too much complexity.