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 for AI coding agents. Copy the skills/spopy/ folder into your agent's skills directory. Compatible with Claude Code, OpenClaw, and similar frameworks.

When called non-interactively, spopy automatically outputs JSON and skips confirmations.