Spotify: Difference between revisions

Latest revision as of 17:06, 27 April 2026

🟆︎

Tip: This package is unfree, and will require extra steps to install. You can read more about allowing unfree software in the Nixpkgs Manual.

Spotify is a commercial music streaming service.

Installation

To install the standard Spotify desktop application, add to system packages:

 environment.systemPackages = with pkgs; [
   spotify
 ];

Local discovery

To sync local tracks from your filesystem with mobile devices in the same network, you need to open port 57621 by adding the following line to your configuration.nix:

networking.firewall.allowedTCPPorts = [ 57621 ];

In order to enable discovery of Google Cast devices (and possibly other Spotify Connect devices) in the same network by the Spotify app, you need to open UDP port 5353 by adding the following line to your configuration.nix:

networking.firewall.allowedUDPPorts = [ 5353 ];

Spotifyd

The alternative client spotifyd is available as a package, nixos module, and home-manager module.

spotifyd can either act as a spotify-connect device and the local LAN without the need to authenticate.^[1] It can also run through a manual login using oauth^[2] If installing spotifyd as a package or as a systemd service via home-manager, give it oauth credentials using:

spotifyd auth

The authentication codes are stored in the cache directory for spotifyd.

spotifyd connects to spotify as a spotify-connect device. It offers no controls of its own, but can be controlled via playerctl or spotatui.

Troubleshooting

If you get: libcurl-gnutls.so.4: no version information, clear your Spotify cache: rm -rf ~/.cache/spotify

[1] ttps://docs.spotifyd.rs/configuration/auth.html#discovery-on-lan

[2] ttps://docs.spotifyd.rs/configuration/auth.html#discovery-on-lan

[1]

[2]

@@ Line 23: / Line 23: @@
 The alternative client [https://github.com/Spotifyd/spotifyd spotifyd] is available as a package, [https://github.com/NixOS/nixpkgs/blob/master/nixos/modules/services/audio/spotifyd.nix nixos module], and [https://github.com/nix-community/home-manager/blob/master/modules/services/spotifyd.nix home-manager module].
-spotifyd must have your credentials when it starts, otherwise it will not be able to authenticate with Spotify, and will not show up as a device. If installing spotifyd as a package, give it credentials when starting, e.g.:
+spotifyd can either act as a spotify-connect device and the local LAN without the need to authenticate.<ref>https://docs.spotifyd.rs/configuration/auth.html#discovery-on-lan</ref> It can also run through a manual login using oauth<ref>https://docs.spotifyd.rs/configuration/auth.html#discovery-on-lan</ref> If installing spotifyd as a package or as a systemd service via home-manager, give it oauth credentials using:
-  spotifyd --username <USER> --password <PASS>
+  spotifyd auth
-If installing spotifyd as a systemd service via home-manager, you can supply your credentials via options. Example home-manager config:
+The authentication codes are stored in the cache directory for spotifyd.
-  services.spotifyd = {
-    enable = true;
-    settings =
-      {
-        global = {
-          username = "Alex";
-          password = "foo";
-        };
-      }
-    ;
-  }
 spotifyd connects to spotify as a spotify-connect device. It offers no controls of its own, but can be controlled via [https://github.com/altdesktop/playerctl playerctl]  or [https://github.com/LargeModGames/spotatui spotatui].