Official Verified media Safety 4/5

spotify-linux

Spotify CLI for headless Linux servers. Control Spotify playback via terminal using cookie auth (no OAuth callback needed). Perfect for remote servers without localhost access.

Why use this skill?

Use the Spotify Linux CLI skill to manage music playback on headless remote servers using cookie authentication. Simple, fast, and no OAuth required.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/shaharsha/spotify-linux

Download Source Code (.zip)

What This Skill Does

The spotify-linux skill enables full control of Spotify playback on headless Linux environments where traditional OAuth callbacks are impossible. Instead of relying on a local web browser to complete an authentication handshake, this tool utilizes direct cookie injection. By manually providing the 'sp_dc' and 'sp_t' cookies, the agent establishes an authorized session with Spotify servers. This allows users to search for music, play tracks, control playback state (pause/resume/skip), and manage output devices entirely via the terminal. It is an essential utility for developers or server administrators managing media streams or background audio on remote VPS instances.

Installation

Install Go 1.21+ on your Linux distribution.
Execute go install github.com/steipete/spogo/cmd/spogo@latest to pull the binary.
Verify the installation by running spogo --version.
Configure the environment by creating a config.toml file in ~/.config/spogo/.
Populate the cookies/default.json file with your extracted Spotify session tokens. Ensure the structure matches the JSON format provided in the technical requirements. Once configured, verify with spogo auth status to ensure the session is active.

Use Cases

Managing a music server on a remote Linux box.
Controlling audio playback during development sessions over SSH.
Integrating Spotify playback into shell scripts or automated server tasks.
Running audio streams in low-resource terminal-based environments without a heavy GUI desktop.

Example Prompts

"Play the latest album by Radiohead on Spotify."
"Can you pause my music and switch the playback device to my office speakers?"
"Search for lo-fi beats and play the first track in the results."

Tips & Limitations

The skill requires a Spotify Premium account for full playback control.
Cookies can expire; if you receive auth errors, re-fetch the 'sp_dc' and 'sp_t' tokens from your browser developer tools.
If a 'missing device id' error occurs, trigger a playback event via a web browser once to register your active session with the Spotify backend.
Always keep your cookie files secure and never share them publicly, as they contain sensitive session tokens capable of accessing your account.

Read Full Documentation on GitHub

Metadata

Author@shaharsha

Stars1054

Updated2026-02-16

View Author Profile

AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill

Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-shaharsha-spotify-linux": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Tags(AI)

#spotify#linux#terminal#music#cli

Safety Score: 4/5

Flags: file-read, file-write, network-access, code-execution

Related Skills

gif-whatsapp

Search and send GIFs on WhatsApp. Handles the Tenor→MP4 conversion required for WhatsApp.

shaharsha 1054

hebrew-nikud

Hebrew nikud (vowel points) reference for AI agents. Correct nikud rules for verb conjugations (binyanim), dagesh, gender suffixes, homographs, and common mistakes. Use before adding nikud to Hebrew text (especially for TTS).

shaharsha 1054

google-maps

Google Maps integration for OpenClaw with Routes API. Use for: (1) Distance/travel time calculations with traffic prediction, (2) Turn-by-turn directions, (3) Distance matrix between multiple points, (4) Geocoding addresses to coordinates and reverse, (5) Places search and details, (6) Transit planning with arrival times. Supports future departure times, traffic models (pessimistic/optimistic), avoid options (tolls/highways), and multiple travel modes (driving/walking/bicycling/transit).

shaharsha 1054

tavily-search-pro

Tavily AI search platform with 5 modes: Search (web/news/finance), Extract (URL content), Crawl (website crawling), Map (sitemap discovery), and Research (deep research with citations). Use for: web search with LLM answers, content extraction, site crawling, deep research.

shaharsha 1054

google-search

Google web search via Gemini Search Grounding (primary) and Custom Search JSON API (fallback). Use for: (1) Synthesized answers with citations (grounded search), (2) Raw link results with snippets, (3) Image search. Excellent Hebrew support. Preferred over built-in web_search (Perplexity).

shaharsha 1054