spotify-player
steipete/clawdis
Terminal Spotify playback and search via spogo or spotify_player.
What is spotify-player?
Control Spotify playback and search tracks directly from the terminal using spogo (preferred) or spotify_player as a fallback. Requires a Spotify Premium account and either CLI tool installed.
- Search for tracks by query
- Control playback (play, pause, next, previous)
- List and switch between Spotify devices
- View current playback status
- Like/unlike tracks
- Access TUI with keyboard shortcuts
How to install spotify-player
npx skills add https://github.com/steipete/clawdis --skill spotify-player- Spotify Premium account
- Either spogo or spotify_player installed (brew install available)
- For spogo: browser cookies imported via `spogo auth import --browser chrome`
- For spotify_player: optional Spotify API client_id for Connect integration
How to use spotify-player
- 1.Install spogo (preferred) or spotify_player via brew
- 2.For spogo: run `spogo auth import --browser chrome` to authenticate
- 3.Use `spogo search track "query"` to find songs
- 4.Use `spogo play|pause|next|prev` to control playback
- 5.Use `spogo device list` and `spogo device set` to switch devices
- 6.For spotify_player fallback: use `spotify_player search` and `spotify_player playback` commands
- 7.Access TUI help by pressing `?` in the app
Use cases
- Search and play music without leaving the terminal
- Switch playback between devices programmatically
- Automate Spotify control in scripts or workflows
- Check current playback status in terminal sessions
- Manage music playback during coding sessions
- Terminal-first developers
- Spotify Premium users
- Automation enthusiasts
- CLI power users
spotify-player FAQ
spogo is preferred. Use spotify_player only as a fallback if spogo is unavailable.
Yes, a Spotify Premium account is required for both tools.
Run `spogo auth import --browser chrome` to import your browser cookies.
Yes, use `spogo device list` to see available devices and `spogo device set` to switch between them.
Configuration is stored in `~/.config/spotify-player/` (e.g., `app.toml`). For Spotify Connect, add your client_id there.
Full instructions (SKILL.md)
Source of truth, from steipete/clawdis.
name: spotify-player description: "Terminal Spotify playback/search via spogo (preferred) or spotify_player." homepage: https://www.spotify.com metadata: { "openclaw": { "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
spogoorspotify_playerinstalled.
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_idin config. - TUI shortcuts are available via
?in the app.
Related skills
More from steipete/clawdis and the wider catalog.

summarize
Fast CLI to summarize or transcribe URLs, videos, podcasts, articles, PDFs, and local files.

things-mac
Read and write Things 3 todos, projects, and tags from the command line on macOS.

tmux
Control tmux sessions and panes to interact with running CLIs: list, capture output, send keys, and monitor prompts.

trello
Manage Trello boards, lists, and cards via REST API.

video-frames
Extract frames or short clips from videos using ffmpeg.

voice-call
Start and manage voice calls via Twilio, Telnyx, Plivo, or mock provider.