032a6ebed8
Replace the static one-page index.html with a Node-based docs site generator. Sidebar nav, per-page TOC, dark mode toggle (system-pref default, persisted), and a Spotify-green theme with animated equalizer brand mark and ambient hero gradient. Adds 11 hand-written doc pages (index, install, quickstart, auth, playback, library, queue, devices, engines, output, agents, troubleshooting, commands) alongside existing spec.md and RELEASING.md. Pages workflow deploys dist/docs-site to GitHub Pages on push to main; repo Pages source is now "GitHub Actions" instead of legacy /docs.
3.5 KiB
| title | description |
|---|---|
| Library & Playlists | List, save, remove tracks/albums/artists, and create or mutate playlists from the terminal. |
Library & Playlists
Your saved tracks, albums, followed artists, and playlists — all listable, mutable, and pipeable.
library tracks
spogo library tracks list [--limit N]
spogo library tracks add <id|url...>
spogo library tracks remove <id|url...>
add/remove accept multiple IDs or URLs in one call:
spogo library tracks add \
spotify:track:7hQJA50XrCWABAu5v6QZ4i \
https://open.spotify.com/track/4PTG3Z6ehGkBFwjybzWkR8
library albums
spogo library albums list [--limit N]
spogo library albums add <id|url...>
spogo library albums remove <id|url...>
library artists
spogo library artists list [--limit N] [--after <artist-id>]
spogo library artists follow <id|url...>
spogo library artists unfollow <id|url...>
--after paginates by artist ID — pass the last ID from the previous page to fetch the next.
library playlists
spogo library playlists list [--limit N]
Lists every playlist you own or follow. To list tracks in a playlist, use playlist tracks below.
playlist create
spogo playlist create "Road Trip"
spogo playlist create "Team Mix" --public
spogo playlist create "Shared Notes" --collab
--public marks the playlist as discoverable; --collab makes it editable by collaborators (collaborative playlists must be private).
playlist add / remove
spogo playlist add <playlist> <track...>
spogo playlist remove <playlist> <track...>
<playlist> is a playlist ID, spotify:playlist:... URI, https://open.spotify.com/playlist/... URL, or the playlist name if you own it. Tracks accept the same flexible forms as library tracks add.
spogo playlist add "Road Trip" \
spotify:track:7hQJA50XrCWABAu5v6QZ4i \
spotify:track:0sf12qNH5qcw8qpgymFOqD
spogo playlist remove 37i9dQZF1DXcBWIGoYBM5M spotify:track:7hQJA50XrCWABAu5v6QZ4i
Playlist mutations route through Connect by default — Connect avoids the Web API rate limits that bite when you script bulk add/remove. spogo automatically detects writable playlists and falls back to Web API where Connect can't help.
playlist tracks
spogo playlist tracks <playlist> [--limit N]
Lists the items inside a playlist:
spogo playlist tracks "Road Trip" --plain | head
spogo playlist tracks 37i9dQZF1DXcBWIGoYBM5M --json | jq '.tracks[].name'
Common patterns
Save the currently playing track
id=$(spogo status --json | jq -r '.item.id')
spogo library tracks add "$id"
Build a playlist from a search
spogo playlist create "Lo-Fi Coding"
spogo search track "lo-fi" --limit 20 --plain |
awk '{print $1}' |
xargs spogo playlist add "Lo-Fi Coding"
Snapshot all liked tracks to a file
spogo library tracks list --limit 1000 --json > liked-tracks.json
Remove duplicates from a playlist
spogo playlist tracks "Road Trip" --plain |
awk '{print $1}' |
sort | uniq -d |
xargs -I {} spogo playlist remove "Road Trip" {}
Errors
playlist not found— confirm spelling, or pass the URI/URL instead of the name.not collaborative— only owners and explicitly added collaborators can mutate a playlist.429 too many requests— should not happen with Connect; if you see it onweb, switch engines or insert a sleep.