A configuration repository for spotifyd, a lightweight Spotify client daemon. This repo contains a sample and customizable configuration file to enable spotifyd to run with specified user credentials and audio settings.
Features
- Provides a ready-to-use
spotifyd.confconfiguration file. - Supports multiple authentication methods including plaintext password, command-based retrieval, and system keyring.
- Configurable audio backend and device settings.
- Supports MPRIS interface for media control integration.
Tech Stack
- Configuration format: INI-style
.conffile - Audio backend: ALSA (Advanced Linux Sound Architecture) by default
- Integration with system services: D-Bus for MPRIS support
Getting Started
Prerequisites
- Install
spotifydon your system. Refer to spotifyd GitHub for installation instructions. - Ensure you have ALSA or your preferred audio backend installed and configured.
Installation
- Clone this repository:
git clone https://github.com/justin-napolitano/spotifyd-config.git
cd spotifyd-config
-
Edit
spotifyd.confto include your Spotify username and password or configure alternative authentication methods. -
Place the
spotifyd.conffile in a location wherespotifydcan access it, typically~/.config/spotifyd/spotifyd.conf.
Running spotifyd
Run spotifyd with the configuration file:
spotifyd --config-path ~/.config/spotifyd/spotifyd.conf
Adjust the path if you place the config file elsewhere.
Project Structure
spotifyd.conf: Main configuration file for spotifyd. Contains settings for authentication, audio backend, device selection, and D-Bus integration.
Future Work / Roadmap
- Add support for encrypted password storage or integration with more secure credential managers.
- Expand configuration options to support additional audio backends and platforms.
- Provide example configurations for different operating systems.
- Automate deployment or installation scripts for easier setup.
- Include documentation on troubleshooting common errors related to audio devices or authentication.