Terminal Control

Use this page when you do not want the TUI. The commands are meant for aliases, status bars, editor commands, and agents.

Play and move on

spotuify play "imagine dragons" --type track

What you get: the first matching track starts on the active or preferred device.

Common controls

spotuify toggle
spotuify next
spotuify previous
spotuify seek +15s
spotuify volume 70
spotuify shuffle toggle
spotuify repeat context

What you get: small mutation receipts. Add --format json when another program reads the result.

Shell aliases

Small commands make good aliases:

alias splay='spotuify play'
alias snext='spotuify next'
alias spause='spotuify pause'
alias sstatus='spotuify status --format json'

Long pipelines usually want a shell function. Put this in ~/.zshrc, ~/.bashrc, or your shell’s equivalent:

freedom() {
  spotuify search "songs about freedom" --type track --format ids \
    | fzf \
    | xargs spotuify play-uri
}

Then open a terminal and run:

freedom

Use the same pattern for agent prompts, playlist recipes, or any search you repeat often. spotuify stays boring and pipeable; your shell gives the workflow a short name.

Editor commands

For Neovim, bind a command to one-shot playback:

command! -nargs=+ SPlay !spotuify play "<args>"
command! SNext !spotuify next

Then:

:SPlay inspirational music

Status bar data

spotuify status --format json \
  | jq -r '.item.name + " - " + .item.subtitle'

What you get: a compact now-playing string for tmux, SketchyBar, Waybar, or a custom prompt.

Recover from network changes

spotuify reconnect
spotuify status

Use reconnect after a VPN flap, sleep/wake, or a Spotify session that went stale.