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 support
  • default: some audio backends (depending on your platform: PulseAudio, PortAudio, ALSA) and MPRIS support
  • slim: 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 the spotifyd-linux-x86_64-{full,default,slim}.tar.gz packages.
  • armhf, armv7: Download one of the spotifyd-linux-armv7-{full,default,slim}.tar.gz packages.
  • aarch64: Download one of the spotifyd-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.