Raspotify

A Spotify Connect client that mostly Just Works™ (Now featuring arm64 & amd64 builds!!!)

Raspotify is a Debian package and associated repository for Debian Stable and other Debian Stable based/compatible OS's which thinly wraps the awesome librespot library by Paul Lietar and others up as a systemd daemon.

Raspotify is primarily intended to be used in a headless enviroment.

For desktop OS's spotifyd offers similar functionality and is probably 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.

Support for ARMv6 (Pi v1 and Pi Zero v1.x) has been dropped.

0.31.8.1 was the last version to be built with ARMv6 support.

You can install and run that version on an ARMv6 device, but you will never get updates and doing so is completely unsupported.

Dependencies

Raspotify will not install without these packages and minimum versions:

Installation

The easy way

sudo apt-get -y install curl && curl -sL https://dtcooper.github.io/raspotify/install.sh | sh

The hard way

Essentially, here's what the easy installer does minus the compatibility checks:

# Install curl
sudo apt-get -y install curl

# 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 raspotify

Or you can just download the latest .deb package and install it manually from here:

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.

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 ❤️ Sponsor Him.

Final Note

...and remember kids, have fun!

hushdauihdhi/raspotify