Raspotify
A Spotify Connect client for Raspberry Pi's that Just Works™ (Premium account required)
More precisely Raspotify is a Debian package and associated repository for Raspberry Pi OS lite (Bullseye) which thinly wraps the awesome librespot library by Paul Lietar and others up as a systemd daemon that can be easily installed on Raspberry Pi's.
Raspotify is primarily intended to be used in a headless enviroment (Raspberry Pi OS lite Bullseye) and has been verified to work on:
- Raspberry Pi (v1) model B
- Raspberry Pi Zero
- Raspberry Pi 2 model B
- Raspberry Pi 3 model B and B+
- Raspberry Pi 4
- Orange Pi Zero LTS with Expansion board (for the 3.5mm jack)
For desktop versions of Raspberry Pi OS (and/or systems with PulseAudio installed) spotifyd offers similar functionality, much better PulseAudio compatibility and is a better choice.
If you're looking for a turnkey audio solution for Raspberry Pi's with Spotify Connect support we recommend moOde™ audio player.
Migration from version <= 0.31.3 to 0.31.4+
Please see the wiki for details.
The short version is that you'll need to sudo apt purge raspotify and sudo apt install raspotfy to make sure Raspotify is not left in a broken state if you're upgrading to 0.31.4.
If you've installed Raspotify after that version there's nothing to see here move along.
Aarch64
64bit packages are not provided and installing on 64bit systems is not officially supported but is possible.
Pull Requests are welcome to add Aarch64 and x86-64 builds.
Installation
The easy way
curl -sL https://dtcooper.github.io/raspotify/install.sh | shThat's it! Plug a speaker into your Pi on your local network, select the device in Spotify et voilà!
The hard way
Essentially, here's what the easy installer does,
# Install curl and https apt transport
sudo apt-get -y install curl apt-transport-https
# Add the raspotify key to the keyring
curl -sSL https://dtcooper.github.io/raspotify/key.asc | sudo tee /usr/share/keyrings/raspotify_key.asc > /dev/null
sudo chmod 644 /usr/share/keyrings/raspotify_key.asc
# Create the apt repo
echo 'deb [signed-by=/usr/share/keyrings/raspotify_key.asc] https://dtcooper.github.io/raspotify raspotify main' | sudo tee /etc/apt/sources.list.d/raspotify.list
# Install package
sudo apt-get update
sudo apt-get -y install raspotifyOr you can just download the latest .deb package and install it manually from
here (raspotify-latest.deb),
Don't forget to checkout the wiki for tips, tricks and configuration info!!!
Bug Reports and Feature Requests
As stated above Raspotify is just a package. The actual program that's run by the service is librespot. Unless it's a packaging issue or a basic confguration question this is the wrong place to file your bug reports and/or feature requests.
Only the most current version of Raspberry Pi OS lite is supported (currently Bullseye). Raspotify may work on other OS's and/or other Raspberry Pi OS version but bugs to do with compatibility issues in unsupported systems will be closed.
Disclaimer
Per librespot's disclaimer, using librespot — the underlying library behind raspotify — to connect to Spotify's API "is probably forbidden by them." We've not received word about that, however use at your own risk.
License
This project is licensed under the MIT License - see the LICENSE
file for details.
Acknowledgments
Special thanks to Paul Lietar, librespot org and its many contributors for librespot, which Raspotify packages. Without librespot, Raspotify would simply not exist.
📻 "And Now, For Something Completely Different!" 🎙️
Raspotify's author David Cooper has abandoned being a software engineer to pursue a career as a radio personality. If you find Raspotify useful, you can support him by checking out his radio work here or give him a follow on Twitter.
On a related note, @JasonLG1979 has become the de-facto maintainer of the project. So an additional thank you to him as well.
If you'd like to buy Jason a Red Bull you can
Final Note
...and remember kids, have fun!