PluginBench
Skill
Review
Audit score 70

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
Prerequisites
  • 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
Claude Code
Cursor
Windsurf
Cline

How to use spotify-player

  1. 1.Install spogo (preferred) or spotify_player via brew
  2. 2.For spogo: run `spogo auth import --browser chrome` to authenticate
  3. 3.Use `spogo search track "query"` to find songs
  4. 4.Use `spogo play|pause|next|prev` to control playback
  5. 5.Use `spogo device list` and `spogo device set` to switch devices
  6. 6.For spotify_player fallback: use `spotify_player search` and `spotify_player playback` commands
  7. 7.Access TUI help by pressing `?` in the app

Use cases

Good for
  • 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
Who it's for
  • Terminal-first developers
  • Spotify Premium users
  • Automation enthusiasts
  • CLI power users

spotify-player FAQ

Which tool should I use, spogo or spotify_player?

spogo is preferred. Use spotify_player only as a fallback if spogo is unavailable.

Do I need Spotify Premium?

Yes, a Spotify Premium account is required for both tools.

How do I authenticate with spogo?

Run `spogo auth import --browser chrome` to import your browser cookies.

Can I control multiple devices?

Yes, use `spogo device list` to see available devices and `spogo device set` to switch between them.

Where is the configuration stored?

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 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.