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; when idle/ended, play selected Home, Search, Library, or Playlist 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)
Uspotuify refresh-media
Terminal window
spotuify toggle
spotuify next
spotuify refresh-media

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

U refetches the current track’s cover art and lyrics. The TUI keeps the current media visible until the new fetch returns.

When there is no resumable current item, Space starts the selected item instead of toggling. That applies on Home, Search, Library, and Playlists. Once a current item can resume, Space goes back to play/pause.

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

Press Enter on an artist to open the discography overlay. These keys apply while it is open:

KeyAction
Ltoggle all releases vs only albums in your library
Tabswap focus between the album list and the track list
j / kmove within the focused list
Enterplay the focused album or track
equeue the focused track
Esc / b / qclose the overlay
Terminal window
spotuify artist albums spotify:artist:36QJpDe2go2KgaRleHCDTp --library-only

Inside the overlay, L filters the discography. The global L lyrics-rail toggle applies only when the overlay is closed.

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