Where Does spotifyd Store Its Config?
spotifyd reads INI config from /etc/spotifyd.conf or ~/.config/spotifyd/spotifyd.conf, overridable with --config-path.
Last updated
spotifyd looks for spotifyd.conf in the user config dir first, then the system locations (/etc or /etc/xdg/spotifyd). One INI [global] section carries credentials, backend, bitrate and device name.
Flags beat files for one-off runs, and --config-path points anywhere for testing. The daemon exposes itself over Spotify Connect either way, so the config only decides identity and audio plumbing, never discovery.
Where spotifyd stores this, by platform
~/.config/spotifyd/spotifyd.conf
INI [global] with credentials, backend, bitrate, device. Same layout on macOS. Systemd user unit goes in ~/.config/systemd/user/.
~/.config/spotifyd/spotifyd.conf
Same user file. System-wide fallback at /etc/spotifyd.conf suits service installs; --config-path overrides everything per run.
Frequently asked questions
How do I configure spotifyd for one user?
Create ~/.config/spotifyd/spotifyd.conf with a [global] section (username, backend, device name). User file beats /etc/spotifyd.conf, and --config-path beats both for testing.
How do I run spotifyd as a service?
Copy contrib/spotifyd.service to the user or system systemd dir. User units keep credentials in your own config; system units read /etc/spotifyd.conf instead.
Notice an outdated path? Let us know.