Skip to content

Keybindings

Keybindings come from the TUI action registry. When a key has a CLI equivalent, the help text should show it.

KeyAction
1Home
2Search
3Library
4Playlists
5Queue
6Devices
7Diagnostics
8Lyrics
Qshow/hide queue rail
Lshow/hide lyrics rail
Hshow/hide contextual hints rail
Fexpand/collapse active queue or lyrics rail
j / Downmove down
k / Upmove up
Ctrl-dhalf page down
Ctrl-uhalf page up
b / Escback or cancel
qquit TUI
Terminal window
spotuify
KeyCLI equivalent
Spacespotuify toggle; on idle Home, play selected item
nspotuify next
pspotuify previous
Leftspotuify seek -15s
Rightspotuify seek +15s
+ / =spotuify volume +5
-spotuify volume -5
sspotuify shuffle toggle
rspotuify repeat context
zswitch compact/large player
vtoggle visualizer
Vcycle visualizer source
Ochoose local audio output device (spotuify audio-output NAME)
Terminal window
spotuify toggle
spotuify next

O opens a picker of the Mac audio outputs the embedded spotuify-hume player can render to; selecting one writes player.audio_output_device and restarts the player. The CLI equivalent:

Terminal window
spotuify audio-outputs # list outputs
spotuify audio-output "MacBook Pro Speakers" # set + reconnect
KeyAction
/global search
Entersubmit search or play/open selected
Ctrl-ffilter current list
Esccancel input
Terminal window
spotuify search "luther vandross"
KeyAction
mmark or unmark item
Mmark range
equeue selected
llike selected/current
a / Aopen playlist picker for selected/current
x / Enter on devicestransfer playback
Terminal window
spotuify queue add spotify:track:...
spotuify playlist add "Coding" spotify:track:... --dry-run
KeyAction
?searchable help
Ctrl-pcommand palette
urefresh current view
u on Diagnosticsundo last reversible operation
R (when the update banner shows)restart the daemon onto a freshly-installed build
Terminal window
spotuify doctor
KeyAction
Ctrl-ffilter recent logs
j / Downscroll log matches
k / Upscroll log matches
Terminal window
spotuify logs tail 200