spotify-player
Terminal Spotify client (TUI + CLI commands) for playback and search.
Security Assessment
About spotify-player
The spotify-player skill enables terminal-based Spotify playback and search functionality using command-line tools. It integrates with either `spogo` (preferred) or `spotify_player` to allow users to control their Spotify listening experience directly from a terminal environment. This skill is designed for users who prefer working in the command line or need lightweight, keyboard-driven control over music playback without relying on the official graphical Spotify application. It addresses the need for efficient, scriptable, and terminal-native Spotify interaction.
The primary interface is `spogo`, which supports searching for tracks, controlling playback (play, pause, next, previous), managing devices, and checking playback status. Device management includes listing available devices and selecting a specific device by name or ID. Authentication for `spogo` is handled by importing browser cookies. If `spogo` is unavailable, the skill falls back to `spotify_player`, which supports searching, playback control, device connection, and liking tracks. Configuration for `spotify_player` is stored in the `~/.config/spotify-player` directory, and Spotify Connect integration requires setting a user `client_id` in the configuration. The terminal user interface provides built-in shortcuts accessible via `?` within the app.
This skill is well-suited for developers, system administrators, and terminal-focused users who already work extensively in shell environments. It is particularly useful in remote sessions, minimal desktop setups, or automated workflows where graphical applications are impractical. A Spotify Premium account is required, making it appropriate for users who already subscribe and want streamlined, command-line-based control over their listening experience.
FAQ
What do I need before using the spotify-player skill?
You need a Spotify Premium account and either `spogo` or `spotify_player` installed. `spogo` is the preferred tool, but the skill can fall back to `spotify_player` if necessary.
How do I authenticate with spogo?
Authentication is performed by importing browser cookies using the command `spogo auth import --browser chrome`.
How can I control playback from the terminal?
With `spogo`, you can use commands such as `spogo play`, `spogo pause`, `spogo next`, and `spogo prev`. With `spotify_player`, playback is controlled using `spotify_player playback play|pause|next|previous`.
How do I manage or select playback devices?
Using `spogo`, you can list devices with `spogo device list` and select one with `spogo device set "<name|id>"`. With `spotify_player`, you can connect to a device using `spotify_player connect`.
Where is the configuration stored for spotify_player?
The configuration directory is located at `~/.config/spotify-player`, for example in a file such as `app.toml`. Spotify Connect integration requires setting a user `client_id` in the configuration.
Install spotify-player
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
steipete/clawdis