playbooks

home / skills / openclaw / skills / ahmed

ahmed skill

/skills/engahmedsalah358-lgtm/ahmed

This skill helps you manage and control Spotify playback and search from the terminal using spogo or spotify_player.

npx playbooks add skill openclaw/skills --skill ahmed

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

Files (2)
SKILL.md
1.3 KB
---
name: spotify-player
description: Terminal Spotify playback/search via spogo (preferred) or spotify_player.
homepage: https://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.

Overview

This skill provides terminal-based Spotify playback and search using spogo (preferred) with a fallback to spotify_player. It exposes CLI commands for searching tracks, controlling playback, listing and selecting devices, and viewing playback status. The skill is designed for users with Spotify Premium who prefer keyboard-driven or scriptable control of Spotify from a terminal. Setup requires installing one of the clients and authenticating with your Spotify account.

How this skill works

The skill delegates Spotify actions to spogo when available, otherwise to spotify_player. It issues CLI commands to search tracks, control playback (play, pause, next, previous), manage devices, and report status. Authentication is handled by importing browser cookies for spogo or configuring a client_id and app.toml for spotify_player. TUI shortcuts and interactive device selection are available in the client apps.

When to use it

  • You want to control Spotify from a terminal or script without a GUI.
  • You need quick keyboard-driven playback control while coding or working remotely.
  • You want to integrate Spotify commands into shell scripts, cron jobs, or hotkeys.
  • You prefer spogo but need a fallback when it’s not installed or available.
  • You need to manage Spotify Connect devices from the command line.

Best practices

  • Use spogo as the primary client for a smoother experience and modern features.
  • Import browser cookies for spogo with: spogo auth import --browser chrome.
  • Keep a Spotify Premium account active; Connect features require Premium.
  • Store configuration in ~/.config/spotify-player and set client_id for Connect.
  • Test device selection with spogo device list before assigning a device.
  • Use the clients’ TUI help (press ?) to learn shortcuts for faster control.

Example use cases

  • Start playback from a terminal: spogo search track "song name" then spogo play.
  • Pause or resume music from a global hotkey bound to spogo play|pause.
  • Switch playback to a specific speaker with spogo device set "Living Room".
  • Scripted playlists: combine spogo search results into a custom playback workflow.
  • Fallback usage: if spogo is missing, run spotify_player search "query" and spotify_player playback play.

FAQ

Do I need Spotify Premium?

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

How do I authenticate spogo?

Import your browser cookies using: spogo auth import --browser chrome to authenticate quickly.