Skip to main content
ClaudeWave
Skill2.7k repo starsupdated 7d ago

spotify-player

The spotify-player skill enables terminal-based Spotify playback and search using spogo as the primary tool or spotify_player as a fallback. Use this skill to control music playback, search tracks, manage devices, and check player status from the command line on systems with a Spotify Premium account and either tool installed.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/moltis-org/moltis /tmp/spotify-player && cp -r /tmp/spotify-player/crates/skills/src/assets/media/spotify-player ~/.claude/skills/spotify-player
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

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