Default bindings follow the TUI key dispatcher and action registry; modals and
text entry can consume keys before global actions. When a key has a CLI equivalent, the help text should show it.
spotuify toggle; when idle/ended, play selected Home, Search, Library, or Playlist item
n
spotuify next
p
spotuify previous
Left
spotuify seek -15s
Right
spotuify seek +15s
+ / =
spotuify volume +5
-
spotuify volume -5
s
spotuify shuffle toggle
r
spotuify repeat context
z
switch compact/large player
v
toggle visualizer
V
open/close fullscreen visualizer
Ctrl-v
visualizer style picker
O
choose local audio output device (spotuify audio-output NAME)
U
spotuify refresh-media
Terminal window
spotuifytoggle
spotuifynext
spotuifyrefresh-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
spotuifyaudio-outputs# list outputs
spotuifyaudio-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.