Keybindings

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

Key	Action
`1`	Home
`2`	Search
`3`	Library
`4`	Playlists
`5`	Queue
`6`	Devices
`7`	Diagnostics
`8`	Lyrics
`Q`	show/hide queue rail
`L`	show/hide lyrics rail
`H`	show/hide contextual hints rail
`F`	expand/collapse active queue or lyrics rail
`j` / Down	move down
`k` / Up	move up
`Ctrl-d`	half page down
`Ctrl-u`	half page up
`b` / Esc	back or cancel
`q`	quit TUI

spotuify

Playback

Key	CLI equivalent
Space	`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`	cycle visualizer source
`O`	choose local audio output device (`spotuify audio-output NAME`)
`U`	`spotuify refresh-media`

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:

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.

Search and filters

Key	Action
`/`	global search
`Enter`	submit search or play/open selected
`Ctrl-f`	filter current list
`Esc`	cancel input

spotuify search "luther vandross"

Selection

Key	Action
`m`	mark or unmark item
`M`	mark range
`e`	queue selected
`l`	like selected/current
`a` / `A`	open playlist picker for selected/current
`x` / Enter on devices	transfer playback
`Delete`	confirm unfollow on the playlist list, unsave in Liked Songs, or exact occurrence removal in playlist detail

spotuify queue add spotify:track:...
spotuify playlist add "Coding" spotify:track:... --dry-run
spotuify playlist remove-at "Coding" 2 5 --dry-run

Artist discography overlay

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

Key	Action
`L`	toggle all releases vs only albums in your library
`Tab`	swap focus between the album list and the track list
`j` / `k`	move within the focused list
`Enter`	play the focused album or track
`e`	queue the focused track
`Esc` / `b` / `q`	close the overlay

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.

Help and palette

Key	Action
`?`	searchable help
`Ctrl-p`	command palette
`u`	refresh current view
`u` on Diagnostics	undo last reversible operation
`R` (when the update banner shows)	restart the daemon onto a freshly-installed build

spotuify doctor

Diagnostics

Key	Action
`Ctrl-f`	filter recent logs
`j` / Down	scroll log matches
`k` / Up	scroll log matches

spotuify logs tail 200