Keybindings
Everything ytmgo does has a key. The app also shows the ones that matter where they are used: in panel titles, on the player bar and in the help bar along the bottom. z hides those inline hints once you no longer need them.
Press ? at any time to open Settings, which lists the full set.
Getting around
| Key | Action |
|---|---|
Tab | Cycle focus: search → results → queue → search |
↑ ↓ / j k | Move through a list |
g / G | Jump to the top / bottom of a list |
1 … 7 | Switch page: Stream, Favourites, Library, History, Downloads, Playlists, Settings |
L | Jump straight to the Library page |
? | Open Settings, which lists every shortcut |
esc | Cancel, or step back one level: an album returns to the artist's releases, the artist returns to your results |
q / Ctrl+C | Quit |
Playback
| Key | Action |
|---|---|
Enter | In results: add to queue. In the queue: play that track |
Space | Play / pause |
n / → | Next track |
p / ← | Previous track, or restart the current one if more than 3s in |
l / Ctrl+F | Seek forward 5s |
h / Ctrl+B | Seek backward 5s |
+ / = | Volume up |
- / _ | Volume down |
c | Toggle autoplay (continuous play) |
s | Toggle shuffle |
r | Cycle repeat: off → one → all |
Repeat-one and the next key
Repeat-one governs what happens when a track ends, not whether you can move on. n always advances, even with repeat-one enabled.
Queue
| Key | Action |
|---|---|
d / Delete | Remove the selected track from the queue |
D | Clear the entire queue (press Enter to confirm) |
Ctrl+↑ / Ctrl+↓ | Move the selected track up or down, in the queue or an open playlist |
Finding music
| Key | Action |
|---|---|
R | Refresh recommendations |
e | Queue every track in the list on screen |
a | Open the album the selected song came from. Inside an album, queue every song on it |
A | Open the artist of the selected track. On their page, switch songs ⇄ releases |
f | Toggle favourite on the selected track |
m | Add the selected song to one of your playlists, or a new one |
M | Save the list on screen as a playlist (a pasted playlist keeps its name) |
C | Clear play history (History page) |
Downloads
| Key | Action |
|---|---|
x | Download the selected track, and jump to the Downloads page |
X | Download every track in the list on screen, and jump to the Downloads page |
u | Copy the track's link to the clipboard — a youtube.com link by default, music.youtube.com if you change Copy Link As in Settings |
o | Open the download directory in your file manager |
U | Check for updates, and confirm the install |
Panels
| Key | Action |
|---|---|
v | Toggle the visualizer beneath the results list |
y | Toggle the lyrics pane beneath the queue. Scroll it with the wheel |
z | Show or hide the inline [key] hints |
Mouse
The mouse works throughout, which is unusual for a terminal app:
- Click a page tab in the header to switch pages
- Click a track to select it, double-click to play it
- Click the seek bar to jump to that point in the song
- Click prev / play / next, the autoplay, shuffle and repeat labels, or anywhere on the volume bar
- Scroll any list, or the lyrics pane, with the wheel
Your keyboard's media keys and your desktop's media widget also control playback, over MPRIS.