Installation
Getting spotifyd
on your system should be as easy as downloading a binary in most cases.
If you'd like to learn how to compile spotifyd
yourself, head over to building from source.
Linux
Some linux distributions include spotifyd
in their official repositories. Have a look at Repology
for a list of the distributions that currently ship an up-to-date version of spotifyd
.
If your distribution is not supported or the provided version is too old, skip to this section in order to install one of our pre-built binaries.
macOS
If you're a homebrew user, installing spotifyd
is as easy as running
brew install spotifyd
FreeBSD
On FreeBSD, a package is available and can be installed with pkg install spotifyd
.
OpenBSD
On OpenBSD, a package is available and can be installed with pkg_add spotifyd
.
Installing from releases
If none of the above methods work for you, you can also use our provided binaries.
First, you need to find a suitable binary for your platform. The provided binaries differ in the available features and the platform architecture that they were built for. You can find the latest binaries here.
Feature Sets:
full
: all audio backends and MPRIS supportdefault
: some audio backends (depending on your platform: PulseAudio, PortAudio, ALSA) and MPRIS supportslim
: one audio backend (depending on your platform) and no MPRIS support (good for headless systems)
If you're unsure which version to choose, just go for default
on desktop systems and slim
on headless systems.
Architecture:
If you're on Linux, check your platform architecture with uname -m
:
x86_64
: Download one of thespotifyd-linux-x86_64-{full,default,slim}.tar.gz
packages.armhf
,armv7
: Download one of thespotifyd-linux-armv7-{full,default,slim}.tar.gz
packages.aarch64
: Download one of thespotifyd-linux-aarch64-{full,default,slim}.tar.gz
armv6
: Unfortunately, we no longer support this architecture. If you still need this to work, please open an issue or join the community matrix channel and we'll try to find a solution.
If you're on macOS, download one of the spotifyd-macos-{full,default,slim}.tar.gz
packages.
You should now extract the downloaded archive, make the spotifyd
file executable and copy it to a sensible location. This can be done using the following commands:
$ tar xzf spotifyd-*.tar.gz # extract
$ cd spotifyd-*/
$ chmod +x spotifyd # make binary executable
$ # move to correct location, e.g. on Linux:
$ # for a user-wide installation (make sure that your $PATH includes ~/.local/bin)
$ mv spotifyd ~/.local/bin/spotifyd
$ # for a system-wide installation
$ sudo chown root:root spotifyd
$ sudo mv spotifyd /usr/local/bin/spotifyd
Running
Now that you have installed spotifyd
, you can check if everything was successful by running spotifyd --version
.
You should be ready to go now and after running spotifyd --no-daemon
, it should appear in an official Spotify client which is on the same network.
If this does not work, you can head over to the troubleshooting section or look at different methods of authentication.