aome510/spotify-player
Spotify Player
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.
Features
- Media Playback Controllers - Controls playback actions and manages the queue from the command line.
- Spotify Controllers - Navigates and searches a user's saved playlists, albums, and tracks from within the terminal.
- Media Player Daemons - Runs as a background daemon with a Unix socket for CLI commands to control playback without the UI.
- Terminal UI Frameworks - Uses the ratatui library to render a composable, keyboard-navigable terminal interface.
- Encrypted Stream Decoders - Decrypts and decodes Spotify's encrypted audio streams using librespot for direct playback without the official client.
- Terminal Music Controllers - Streams Spotify songs directly from the terminal using an integrated client.
- Keyboard Navigation - Controls the entire application interface and all its actions using only keyboard shortcuts.
- Keyboard Navigation Shortcuts - Controls the terminal interface entirely through keyboard shortcuts for navigation, playback, and actions.
- Playback Controls - Manages playback actions such as play, pause, skip, and volume adjustment through keyboard commands.
- Spotify Client Libraries - Authenticates with Spotify's OAuth flow and uses the Web API for library browsing and Connect protocol for remote playback control.
- Terminal Application Themes - Ships YAML theme files and color scheme conversion for customizing the terminal application's appearance.
- In-Page Search Filters - Ships an in-page search filter that narrows displayed content by typing a query.
- Library Browsers - Navigates to pages for user playlists, saved albums, followed artists, liked tracks, and recently played tracks.
- Command Line Configuration - Overrides any configuration option at launch using a command-line flag without editing the config file.
- Item Action Triggers - Triggers context-specific actions like adding to library, following artists, or copying links on any Spotify item.
- Event-Triggered Shell Commands - Registers user-defined shell commands as event handlers that receive structured playback state data as arguments.
- Keyboard Shortcuts - Binds any key sequence to a built-in command or removes an existing binding.
- CLI - Creates, deletes, imports, and forks Spotify playlists using command-line commands.
- Command-Line Playlist Editors - Creates, deletes, imports, and forks playlists using command-line commands.
- Custom Key Action Bindings - Assigns a user-defined action to a key combination, optionally targeting the playing track or selected item.
- Frequency Band Visualizers - Displays a real-time frequency-band bar chart of the currently playing audio.
- Player Event Hooks - Runs a user-defined command whenever playback state changes, passing event details as arguments.
- Synchronized Lyric Displays - Displays time-synced lyrics for the currently playing track.
- Playback Controllers - Connects to Spotify Connect devices so users can control playback from another device or switch output.
- Spotify Connect Implementations - Implements Spotify Connect protocol to manage playback on remote devices and respond to system media keys.
- Background Daemons - Operates as a background daemon process, allowing CLI commands to control playback without the UI.
- Color Themes - Loads a named theme file that defines the palette and component styles for the terminal interface.
- Interface Layout Customization - Adjusts the layout, dimensions, and position of the playback and library windows.
- Music and Audio - Terminal-based Spotify player with full feature parity.
- Music and Media - Feature-complete Spotify client for the terminal.
- Music Players - Terminal Spotify player with full feature parity.
- Streaming Frontends - Terminal-based spotify client with full feature parity.
