Back to Skills

spotify-player

Terminal Spotify client (TUI + CLI commands) for playback and search.

207,212stars37,967forksUpdated 2/18/2026

Security Assessment

Safe(100/100)
Security Score100/100

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

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill