thrash.dev

docs / yafmp / keyboard and commands

Yafmp · chapters · 08 of 11
  1. Overview
  2. Install
  3. First run
  4. Playing music
  5. Library and browser
  6. Sound
  7. Visualizers
  8. Keyboard and commands
  9. Remote control
  10. TV and Steam Deck
  11. Troubleshooting

Providers (25) →

Keyboard and commands

Keyboard shortcuts, the command console and the Keyboard settings pane.

Apple: keyboard shortcuts

The shortcuts are the Playback and View menus on the Mac. The same keys work on iPhone, iPad and Vision Pro with a keyboard attached. On the iPad, hold ⌘ to see the list. Apple TV has no keyboard shortcuts.

All of them use ⌘ except Space, so none gets in the way of typing.

Playback

ShortcutWhat it does
SpacePlay or pause
⌘.Stop
⌘→Next track
⌘←Previous track
⌥⌘→Forward 10 seconds
⌥⌘←Back 10 seconds
⇧⌥⌘→Forward 1 minute
⇧⌥⌘←Back 1 minute
⌥⌘SShuffle on or off
⌥⌘RRepeat: off → all → one
⇧⌘⌫Clear the queue. It does not ask first.

Volume

ShortcutWhat it does
⌘↑Volume up
⌘↓Volume down
⌥⌘↓Mute or unmute

The volume shortcuts are disabled while the output has no app volume, such as Apple Music or a Chromecast.

View

ShortcutWhat it doesWhere
⌘1HomeAll
⌘2QueueAll
⌘FSearch the libraryAll
⌘[BackAll
⌥⌘IShow or hide Now PlayingAll. On the iPad the player column is always there.
⌘,PreferencesAll
⌘KCommand consoleAll
⌥⌘AQueue as AlbumsAll
⌘+ and ⌘−Larger and smaller covers in the browserAll

Windows

ShortcutWhat it doesWhere
⌥⌘VVisualizer windowMac, Vision Pro
⇧⌘MMini PlayerMac, Vision Pro
⌥⌘EImmersive, or leave itVision Pro
⌥⌘33D CoverVision Pro

To change a shortcut on the Mac, use macOS: System Settings → Keyboard → Keyboard Shortcuts → App Shortcuts. Yafmp has no key settings of its own in the Apple edition.

Apple: the command console

The command console over the main window

The command console is a line you type commands into. It is on Mac, iPhone, iPad and Vision Pro.

  1. Press ⌘K.
  2. Type a command’s name or part of it. Up to six matches show under the line as you type.
  3. Press Return to run the first match, or choose another one.
  4. The console stays open for the next command. What the commands report is listed below the line. Done closes it.

A command that takes text has the text after its name: volume 30, seek to 1:30, play portishead dummy. You can type the name from either column of the tables below.

On the iPhone the console does not show while the full-screen player is open. Close the player first.

Playback

CommandWhat it does
play-pausePlay or pause.
play artist, album or songSearches the sources in order and plays the first hit.
play-number numberPlays that track of the queue.
next, previous, stopTransport.
seek-forward, seek-backForward or back 10 seconds.
seek-to 1:30 or 90Jumps to that time.
volume 0–100Sets the volume.
volume-up, volume-down, muteVolume in steps, and mute or unmute.
shuffle, repeatShuffle on or off. Repeat off → all → one.
clear-playlistClears the queue.
statusShows what is playing, the volume, queue length, shuffle, repeat, format and effects in one line.
versionShows the version and build.

The library and getting around

CommandWhat it does
find textReports how many results each source has.
get-info artist, album or labelOpens Get Info for that row.
sourcesLists the sources, and whether each is on.
source nameOpens that source in the browser.
home, playlist, search, backHome, the queue, search and back.
now-playing, settingsNow Playing and Preferences.
settings:pluginOpens that plugin’s pane in Preferences, for example settings:plex.
enable plugin id, disable plugin idSwitches a plugin on or off. sources lists the ids.
albumsQueue as albums on or off.

Visualizers and effects

CommandWhat it does
visualizer:styleShows that style in place of the cover, for example visualizer:plasma.
coverShows the cover again.
visualizer-windowMac and Vision Pro: opens the Visualizer window.
visualizer-window:styleMac and Vision Pro: opens the window with that style.
immersive, immersive-offVision Pro: enter or leave the immersive scene.
immersive:sceneVision Pro: picks the scene and enters it.
album-3dVision Pro: the 3D Cover.
sparks intensity height sizeVision Pro: the Ring of Sparks dials, each 0–100.
eq-toggleEqualizer on or off.
eq:presetSets an equalizer preset and switches the equalizer on, for example eq:Rock.
compressor-toggle, compressor:presetThe same for the compressor.

Plugins. These are there only while the plugin is switched on.

CommandWhat it does
cast device name, cast-stopStarts or stops casting. See Chromecast.
devicesLists the other devices running Yafmp. See Connect.
remote play, pause, next or previous device nameControls another device.
dj what to hearMakes and plays a playlist. See DJ.
labels nameLists the labels you follow. With a name, follows that label first. See Labels.
releasesLooks for new releases and opens the page. See Releases.

Android and desktop: keys

Every command can have keys. The defaults are below. On Android you need a hardware keyboard.

Plain keys, such as Space or M, do not act while you type in a search field or in Settings.

Playback

KeyWhat it does
Space, Play/Pause media keyPlay or pause
Ctrl+→, Next media keyNext track
Ctrl+←, Previous media keyPrevious track
Ctrl+., Stop media keyStop
→Forward 10 seconds
←Back 10 seconds
Shift+→Forward 1 minute
Shift+←Back 1 minute
SShuffle on or off
RRepeat: off → all → one
Ctrl+Shift+DeleteClear the queue
Ctrl+IStatus

Volume

KeyWhat it does
Ctrl+↑Volume up
Ctrl+↓Volume down
MMute or unmute

Getting around

KeyWhat it does
Ctrl+KCommand palette
Ctrl+F, /Search the library
Ctrl+1Show or hide the library
Ctrl+2Show the queue
Ctrl+3Show or hide Now Playing
Ctrl+,Settings
Esc, Alt+←Back
Ctrl+HLibrary home
Ctrl+JJump to the playing track
Ctrl+GOpen the playing track’s album

Extras

KeyWhat it does
Ctrl+DDJ
Ctrl+Shift+EEqualizer
FVisualizer full screen
]Next visualizer
[Previous visualizer
Ctrl+QQuit (desktop)

Some commands have no key at first, such as Resume, Remove the playing track from the playlist, the equalizer presets and each visualizer style. You can give them one.

Android and desktop: the Keyboard pane

Open Settings → Keyboard. It lists every command with its keys, and has two preset buttons.

ButtonWhat it does
Yafmp keysPuts every command back to the defaults above.
Winamp keysStarts from the defaults, then gives the commands below Winamp’s keys.

Winamp keys

KeyWhat it does
ZPrevious track
XResume
CPlay or pause
VStop
BNext track
←Back 10 seconds
→Forward 10 seconds
↑Volume up
↓Volume down
JSearch the library

With the Winamp preset, these commands lose their other keyboard keys. Space no longer pauses and Ctrl+F no longer searches. The media keys keep working.

Changing a key

  1. Choose the command in the list.
  2. Press the keys you want. The dialog shows them, and tells you if another command has them now.
  3. Choose Set to replace the command’s keys, or Add to keep its other keys as well.

A key that another command had moves to this one. The other buttons are No key (the command gets no key), Default (back to its default) and Cancel.

Android and desktop: the command palette

  1. Press Ctrl+K.
  2. Type part of a command’s name. Use ↑ and ↓ to pick from the matches.
  3. Press Enter to run it. Esc closes the palette.

A command that takes text needs the text after its name, for example seek to 1:30 or volume 30. If you run one without text, the palette fills in the name and waits for the rest.

The palette lists every command, including the ones with no key: each equalizer preset, each visualizer style, each AVS preset and each Settings pane.