spotify-player

steipete's avatarfrom steipete

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

⭐430stars🔀44forks📁View on GitHub🕐Updated Dec 21, 2025
[Developer Tools]

When & Why to Use This Skill

This Claude skill enables seamless Spotify playback and search functionality directly within the terminal environment. By supporting both spogo and spotify_player, it provides a lightweight TUI (Terminal User Interface) and CLI command set for managing music, searching tracks, and controlling Spotify Connect devices without leaving the command line, making it an ideal productivity tool for developers and power users.

Use Cases

  • 1. Command-Line Playback Control: Quickly play, pause, or skip tracks using simple CLI commands like 'spogo play' or 'next' while staying focused on your terminal-based workflow.
  • 2. Efficient Music Discovery: Search for specific tracks, artists, or albums directly from the console, bypassing the need for the resource-heavy Spotify desktop application.
  • 3. Multi-Device Management: Use the 'device list' and 'device set' commands to switch audio output between different Spotify Connect devices across your local network.
  • 4. Distraction-Free TUI: Launch a full-screen terminal interface for browsing your library and managing playlists, providing a minimalist and keyboard-centric music experience.
namespotify-player
descriptionTerminal Spotify playback/search via spogo (preferred) or spotify_player.
homepagehttps://www.spotify.com
metadata{"clawdbot":{"emoji":"🎵","requires":{"anyBins":["spogo","spotify_player"]},"install":[{"id":"brew","kind":"brew","formula":"spogo","tap":"steipete/tap","bins":["spogo"],"label":"Install spogo (brew)"},{"id":"brew","kind":"brew","formula":"spotify_player","bins":["spotify_player"],"label":"Install spotify_player (brew)"}]}}

spogo / spotify_player

Use spogo (preferred) for Spotify playback/search. Fall back to spotify_player if needed.

Requirements

  • Spotify Premium account.
  • Either spogo or spotify_player installed.

spogo setup

  • Import cookies: spogo auth import --browser chrome

Common CLI commands

  • Search: spogo search track "query"
  • Playback: spogo play|pause|next|prev
  • Devices: spogo device list, spogo device set "<name|id>"
  • Status: spogo status

spotify_player commands (fallback)

  • Search: spotify_player search "query"
  • Playback: spotify_player playback play|pause|next|previous
  • Connect device: spotify_player connect
  • Like track: spotify_player like

Notes

  • Config folder: ~/.config/spotify-player (e.g., app.toml).
  • For Spotify Connect integration, set a user client_id in config.
  • TUI shortcuts are available via ? in the app.