raspotify

[<img src="https://raw.githubusercontent.com/dtcooper/raspotify/master/raspotify.svg?sanitize=true">](https://github.com/dtcooper/raspotify)

Raspotify is a [Debian package and associated repository](https://en.wikipedia.org/wiki/Deb_(file_format))
for [Debian Stable](https://www.debian.org/releases/stable/) (**Currently Debian 13 "Trixie"**)
and other Debian Stable based/compatible OS's (**your mileage may vary**) which thinly wraps the awesome
[librespot](https://github.com/librespot-org/librespot) library by [Paul Lietar](https://github.com/plietar) and others as a
[systemd](https://en.wikipedia.org/wiki/Systemd) [daemon](https://en.wikipedia.org/wiki/Daemon_(computing)).

Raspotify is intended to be used in a *[headless environment](https://en.wikipedia.org/wiki/Headless_computer)*. For desktop OS's [spotifyd](https://github.com/Spotifyd/spotifyd) offers similar functionality 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](https://moodeaudio.org/).

**Librespot, and therefore Raspotify, requires a premium account.**

## Installation

There are various *"guides"* floating around online. Most if not all of them are outdated and/or present incorrect information. **Don't follow them.**

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

Or you can just download the latest .deb package and install it manually from here:
* [`raspotify-latest_armhf.deb`](https://dtcooper.github.io/raspotify/raspotify-latest_armhf.deb)
* [`raspotify-latest_arm64.deb`](https://dtcooper.github.io/raspotify/raspotify-latest_arm64.deb)
* [`raspotify-latest_amd64.deb`](https://dtcooper.github.io/raspotify/raspotify-latest_amd64.deb)
* [`raspotify-latest_riscv64.deb`](https://dtcooper.github.io/raspotify/raspotify-latest_riscv64.deb)

### [Raspotify does NOT support ARMv6 Pi's (Pi v1 and Pi Zero v1.x)](https://github.com/dtcooper/raspotify/wiki/Raspotify-on-Pi-v1's-and-Pi-Zero-v1.x)

### Regarding "Audio Key Error" and similar messages

Spotify has made some breaking changes to their API which introduces problems for Librespot users across many open source projects, including Raspotify.
The API change has already been reversed engineered and a fix implemented. This fix was subsequently shut down by Spotify on basis of copyright infringement laws.

The issue is tracked upstream as [#1649](https://github.com/librespot-org/librespot/issues/1649), and also as
[#757](https://github.com/dtcooper/raspotify/issues/757) on the Raspotify issue tracker.
Please read through the issues and check if you're having the same problem before reporting a new issue.

If Raspotify won't work for you, the most popular response from the community is to try [Spotify Soloist](https://developer.spotify.com/documentation/soloist),
which seems to be what Spotify wants anyway.

## Building

Raspotify `.deb` packages are built inside Docker, whi