spopy — Spotify CLI

Get started

# Install and authenticate

spopy auth login

# Play music

spopy play "bohemian rhapsody"

spopy status

spopy next

# Search and queue

spopy search "pink floyd" --type artist

spopy queue add "comfortably numb"

Zero config Built-in Spotify app with PKCE auth. Just run auth login.

Single file One Python script with inline deps. No virtualenv, no package manager.

Full control Play, pause, seek, volume, shuffle, repeat, queue, playlists, library.

Search everything Tracks, albums, artists, playlists. URI, URL, ID, or text query.

JSON output Machine-readable by default when piped. Rich tables for humans.

Server-ready Headless auth, token export/import, Dokku-friendly. No secrets leaked.

# Playback

spopy play | pause | resume | next | previous

spopy seek 1:30 | volume 50 | shuffle toggle | repeat track

# Browse

spopy search "query" --type track,album,artist,playlist

spopy track | album | artist | playlist show "query"

# Queue & playlists

spopy queue list | add "song"

spopy playlist list | create | add | remove | clear

# Library & discovery

spopy library tracks | albums | save | unsave

spopy recent | top tracks | top artists | discover

# Status & diagnostics

spopy status | devices list | doctor

spopy includes a skill file for AI coding agents. Compatible with Claude Code, OpenClaw, and similar agent frameworks that use SKILL.md files.

# Copy the skill to your project

cp -r skills/spopy/ .claude/skills/

The agent gets JSON output and auto-confirmed destructive actions automatically when calling spopy non-interactively.