spotify-player

Search and control Spotify playback from the terminal using spogo.

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/Polealpha/XINNIAN_PI --skill spotify-player-polealpha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spotify-player
Source: https://github.com/Polealpha/XINNIAN_PI/tree/main/app%20windows/vendor/openclaw-runtime/skills/spotify-player
Command: npx skills add https://github.com/Polealpha/XINNIAN_PI --skill spotify-player-polealpha

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the friction of controlling Spotify playback by letting you search for tracks and manage playback directly from your terminal.

Core Features & Use Cases

  • Terminal Spotify playback/search: Use spogo for searching and controlling playback from the command line.
  • Reliable fallback mode: Fall back to spotify_player when spogo is unavailable or fails.
  • Device and status control: Switch playback devices and check current playback state from the terminal (useful when you’re multitasking away from the desktop app).

Quick Start

Provide your Spotify Premium browser cookies by running spogo auth import and then use spogo search to find a track by name.

Frequently Asked Questions about spotify-player

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I control Spotify playback from the terminal?

Spotify Premium provides the required backend access for terminal playback control using `spogo`, which manages interactive listening sessions and device switching from the command line.

Can I search for tracks in Spotify using the command line?

The `spogo auth import` command sets up terminal Spotify access by importing your Spotify Premium browser cookies, enabling the CLI to authenticate playback and search requests without manual UI login.

Do I need Spotify Premium to use terminal music control?

If `spogo` fails or is unavailable, the system falls back to the `spotify_player` CLI binary to maintain terminal-based Spotify playback, search, and device management capabilities.

What is the best way to switch Spotify playback devices without the desktop app?

The system installs the needed CLI binaries via brew, setting up the `spogo` and `spotify_player` terminal engines to enable command-line Spotify search and playback control on your machine.

Why use a CLI for Spotify playback instead of the desktop UI?

You can check your current Spotify playback state from the terminal using `spogo`, which provides immediate playback status feedback and device control useful when multitasking away from the desktop app.

How do I set up terminal Spotify search and playback?

Terminal Spotify playback falls back to `spotify_player` when the preferred `spogo` engine is unavailable or fails, ensuring continuous command-line track discovery and playback control.