playbooks

home / skills / openclaw / openclaw / spotify-player

spotify-player skill

/skills/spotify-player

This skill lets you control Spotify playback and search from the terminal using spogo or spotify_player, boosting your music workflow.

This is most likely a fork of the spotify-player skill from openclaw
npx playbooks add skill openclaw/openclaw --skill spotify-player

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
1.6 KB
---
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.

Overview

This skill provides terminal control of Spotify using the spogo tool (preferred) with a fallback to spotify_player. It enables searching, playback control, device management, and status inspection from the command line. Designed for users with Spotify Premium who prefer terminal workflows or want programmatic control from an assistant.

How this skill works

The skill runs spogo commands to search tracks, control playback, list and set devices, and query status. If spogo is not available, it falls back to spotify_player and translates the same intents to that tool's commands. Authentication requires importing browser cookies for spogo or configuring spotify_player with a client_id and app settings in the config folder.

When to use it

  • You want to control Spotify from a terminal or script.
  • You need quick search and playback controls without opening a GUI client.
  • You manage multiple Spotify Connect devices and want to switch them from the CLI.
  • You automate music playback from an assistant or local workflows.

Best practices

  • Install and prefer spogo for the most complete command set and simpler auth flow.
  • Import cookies into spogo via the browser (e.g., spogo auth import --browser chrome) for seamless access.
  • Keep spotify_player config in ~/.config/spotify-player (app.toml) and set client_id for Connect features.
  • Test basic commands (search, play, status) after setup to verify authentication and device visibility.
  • Use the TUI help (press ? in the app) to discover shortcuts and additional interactions.

Example use cases

  • Search for a track quickly: spogo search track "song name" and then spogo play to start playback.
  • Switch output to a different device: spogo device list to find the device, then spogo device set "name".
  • Pause, resume, or skip songs from scripts or keybindings: spogo play|pause|next|prev.
  • Fallback control when spogo is unavailable: use spotify_player search "query" and spotify_player playback play.
  • Like a track when using the fallback tool: spotify_player like after identifying the current track.

FAQ

Do I need Spotify Premium?

Yes. Spotify Connect features and remote playback control require a Spotify Premium account.

How do I authenticate spogo?

Import your browser cookies, for example: spogo auth import --browser chrome.

Where is spotify_player configuration stored?

Configuration lives in ~/.config/spotify-player; edit app.toml to set client_id or other options.