Spotify Player is a terminal-based client for streaming and controlling Spotify music directly from the command line. It combines a text-based user interface with a background daemon mode, allowing users to browse their Spotify library, manage playlists, and control playback entirely through keyboard shortcuts. The application integrates with Spotify's Web API and Connect protocol, enabling remote playback control across devices while streaming audio locally without the official client.
The player distinguishes itself through its plugin-based command system, which lets users define custom shell commands that trigger on playback state changes, and its support for terminal color scheme conversion from iTerm2 and Alacritty formats. It can run as a background daemon with IPC channels, allowing CLI commands to control playback independently of the user interface. The application also includes a real-time audio visualizer, synced lyrics display, and the ability to render album art in the terminal using block characters or sixel graphics.
Beyond core playback, the player offers extensive customization through YAML theme files, configurable key bindings, and adjustable UI layouts. It supports searching Spotify from the command line, editing playlists, and performing actions on tracks and artists. The application securely handles Spotify client credentials by reading them from a shell command rather than storing them in plain text.