spotify_player

Start player

$ spotify_player

$ spotify_player -C [~/.config/spotify-player]

$ spotify_player -d

$ spotify_player -v

spotify_player [-C dir] [-d] [options]

spotify_player is a terminal-based Spotify client that provides a full-featured TUI (Text User Interface) for browsing, searching, and playing music from a Spotify Premium account. It uses vim-style keybindings and a modal interface for efficient keyboard-driven navigation.
The player supports Spotify Connect, allowing it to control playback on other devices or act as a playback target. Features include library browsing, playlist management, search, lyrics display, and artist/album exploration. A daemon mode enables headless operation for use as a Spotify Connect receiver.
Built on the librespot library for Spotify protocol support, it stores configuration and cache data in ~/.config/spotify-player/. Custom themes and keybindings can be configured through TOML configuration files.

-C DIR

Config directory.

Daemon mode.

Verbose output.

Color theme.

Show help.

~/.config/spotify-player/app.toml

Main configuration file controlling playback settings, keybindings, theme, default device, and UI layout.

Custom color theme definitions for the TUI interface.

Cache directory for audio data and Spotify session tokens.

Spotify Premium required. Authentication needed. librespot backend.

spotify_player is a terminal-based Spotify client built on librespot, providing a TUI for Spotify Premium users.

spotifyd(1), ncspot(1), cmus(1)