Queue and Playlists
Queue changes are quick. Playlist changes are durable, so broad writes should preview first.
Show the queue
Section titled “Show the queue”spotuify queuespotuify queue --format jsonAdd one item
Section titled “Add one item”spotuify queue add spotify:track:4uLU6hMCjMI75M1A2tKUQCAdd by search:
spotuify queue add --search "never too much"The TUI append behavior is the same product rule: queueing a track appends one URI; queueing a playlist or album expands it to playable tracks and appends them. It does not replace the current queue.
spotuify queueQueueing when nothing is playing
Section titled “Queueing when nothing is playing”The queue lives on the active Spotify session, so there has to be one. When
nothing is playing, spotuify plays the first selected track on the embedded
device to start a session, then queues the rest, instead of failing with
NO_ACTIVE_DEVICE:
spotuify queue add --search "never too much" # idle → it starts playingWhat you get: the first item playing on spotuify-hume, any remaining
selections queued behind it. Once something is playing, queue add appends as
usual.
In the TUI, Enter replaces the queue with the item you picked and starts
playback. e appends. A toast after Enter reminds you of the alternative:
Playing Wonderwall (queue replaced · e to enqueue next time)If you wanted to append, Esc dismisses the toast, then re-select and press
e. The replaced queue can also be restored with u (undo); see
Architecture.
List playlists
Section titled “List playlists”spotuify playlistsspotuify playlists --format idsShow playlist tracks
Section titled “Show playlist tracks”spotuify playlist tracks "Quiet Storm" --format jsonlPlay a playlist
Section titled “Play a playlist”spotuify playlist play "Quiet Storm"Add with a dry-run
Section titled “Add with a dry-run”spotuify playlist add "Quiet Storm" spotify:track:4uLU6hMCjMI75M1A2tKUQC --dry-runIn the TUI, press a or A on a selected item. A playlist picker opens; use
Space to select one or more playlists, then Enter to add.
spotuify playlist add "Quiet Storm" spotify:track:4uLU6hMCjMI75M1A2tKUQC --dry-runCommit only after the preview:
spotuify playlist add "Quiet Storm" spotify:track:4uLU6hMCjMI75M1A2tKUQC --yesAgent playlist workflow
Section titled “Agent playlist workflow”spotuify playlist plan "exile and returning home" --format json > plan.jsonspotuify resolve-tracks --from plan.json --format jsonl > candidates.jsonlspotuify playlist create "Exile and Return" --from candidates.jsonl --dry-runAfter approval:
spotuify playlist create "Exile and Return" --from candidates.jsonl --yes --format jsonWhat you get: a receipt with playlist id, playlist URI, playlist name, and added item count.
spotuify playlist create "Exile and Return" --from candidates.jsonl --yes --format json