spotify-player

Search Spotify tracks and control playback from a terminal.

87|20|Updated Mar 9, 2026

Search Tags:#spotify #cli-tools #playback-control #music-search #spotify-connect #terminal-audio

Ready to run

npx skills add https://github.com/openaeon/OpenAEON --skill spotify-player-openaeon

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: spotify-player
Source: https://github.com/openaeon/OpenAEON/tree/main/skills/spotify-player
Command: npx skills add https://github.com/openaeon/OpenAEON --skill spotify-player-openaeon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of controlling Spotify manually by letting you search for tracks and start playback directly from the terminal.

Core Features & Use Cases

Search and find tracks fast: Look up songs by query without switching apps.
Control playback and devices: Start, pause, skip, and select a target device from the CLI.
Fallback-compatible: Uses spogo (preferred) or spotify_player when spogo is unavailable, including common Spotify Connect needs.

Example use case: You need background music while working and want to search for a track like “lofi focus beats” and immediately play it on the kitchen speaker.

Quick Start

Tell your AI to set up and use the spotify-player Skill with spogo to search for a track and start playing it on your preferred device.

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?▼

Terminal-based Spotify playback is handled through the spogo CLI tool, with spotify_player as a fallback, enabling track search, play, pause, skip, and device selection without leaving your command line.

Can I search for Spotify tracks without opening the desktop app?▼

Yes, searching for Spotify tracks without the desktop app is done by running a search query command in your terminal, which rapidly looks up songs by name and returns results in the CLI.

Do I need Spotify Premium to use a CLI player for music search and playback control?▼

Yes, Spotify Premium access is required for terminal-based music search and playback control because the underlying API commands for streaming and device selection need premium account privileges.

What's the best way to play music on a specific speaker using terminal commands?▼

The best way to play music on a specific speaker using terminal commands is by invoking Spotify Connect device selection features, which let you target a preferred output device for playback.

What happens if spogo is not installed for terminal audio control?▼

If spogo is not installed for terminal audio control, the Skill automatically falls back to spotify_player to handle common music control workflows, search, and device selection.

Are there limitations to managing Spotify playback in a CLI environment?▼

Limitations of managing Spotify playback in a CLI environment include the strict requirement for a Spotify Premium account and the need to have either spogo or spotify_player installed.