Keybindings

Keybindings

Press ? in spotatui to see the help menu with all keybindings.

Default Keybindings

Key	Action
Space	Toggle play/pause
n	Next track
p	Previous track
+ / -	Volume up/down
< / >	Seek backward/forward
/	Search
a	Jump to album
A	Jump to artist's albums
o	Jump to context
d	Manage devices
c	Copy song URL
C	Copy album URL
r	Toggle repeat mode
Ctrl-s	Toggle shuffle
v	Audio visualization
z	Add to queue
B	Lyrics view
,	Open sort menu
Alt-,	Open settings
?	Show help
q	Go back / Quit

Customizing Keybindings

Edit ~/.config/spotatui/config.yml:

keybindings:
  back: "q"
  jump_to_album: "a"
  toggle_playback: " "
  # ... etc

Key Format

• Single keys: "a", "/", " " (space)
• With Ctrl: "ctrl-q", "ctrl-s"
• With Shift: Use capital letter "A", "C"
• Special keys: "enter", "esc", "tab"

Note: Three-key combinations like ctrl-alt-q are not supported.