thrash.dev

docs / yafmp / remote control

Yafmp · chapters · 09 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) →

Remote control

Every way to control Yafmp from outside its window: system controls, watches, other devices, home automation and AI apps.

Yafmp can be controlled without touching its window. This chapter lists the ways and says where each one works.

ControlPlatforms
Lock screen, Control Center, media keys, headphone buttonsiPhone, iPad, Mac (menu bar), Vision Pro, Apple TV
Notification, lock screen, Bluetooth controlsAndroid, Android TV
Desktop media keys and now-playing widgets (MPRIS)Linux, FreeBSD
Apple Watch appiPhone
Wear OS app and tileAndroid phones
Connect: Yafmp on your other devicesAll
Home AssistantiPhone, iPad, Mac, Vision Pro
MCP server: AI appsLinux, FreeBSD, Windows

Keys inside the window are covered in Keyboard.

System controls on Apple devices

The Now Playing plugin shows the current track on the lock screen, in Control Center and in the Mac menu bar’s Now Playing item. It is on by default.

The system shows the title, artist, album, cover and position. It can play, pause, stop, skip to the next or previous track and move the position. The media keys on a keyboard and the buttons on headphones do the same.

Switching the plugin off in Preferences → Plugins → Now Playing removes Yafmp from these controls.

System controls on Android

Yafmp runs a media session while it plays. Android shows it as a media notification and on the lock screen, with the usual transport buttons. Bluetooth headphones and car controls work through the same session. Playback continues in the background.

Media keys on Linux and FreeBSD

The desktop edition speaks MPRIS on the session D-Bus, under the name org.mpris.MediaPlayer2.yafmp. Desktop media keys, now-playing widgets, lock screens and tools such as playerctl see and control it.

MPRIS offersNotes
Play, pause, play/pause, stop, next, previous
Seek and set position
Shuffle and loop statusLoop Track is repeat one, Playlist is repeat all.
VolumeOnly when Yafmp can set the volume for what is playing.
RaiseBrings the Yafmp window to the front.
MetadataTitle, artist, album, length and the cover as a local file.

There is no track list, the playback rate is fixed, and Quit is not offered. Without a D-Bus session Yafmp starts without MPRIS.

On Windows the desktop edition has no system media-key integration.

Apple Watch

The Apple Watch app is a remote for Yafmp on the paired iPhone. It comes inside the iPhone app and plays nothing itself.

  • The main screen shows the title and artist over the cover, with previous, play or pause, and next.
  • The Digital Crown sets the iPhone app’s volume. The volume bar is hidden when the volume cannot be set for what is playing.
  • The list button opens the queue: up to 40 rows from just before the playing track. Tap a row to play it.

If Yafmp is not running on the iPhone, the watch starts it in the background. While it waits, the watch shows “Looking for yafmp on your iPhone”. If that fails it shows “Can’t reach yafmp on your iPhone” with a Try Again button.

The watch link is part of the Connect plugin (Other Devices). Switching that plugin off on the iPhone switches the watch off too. The watch controls the iPhone only, not your other devices, and it has no complication.

Wear OS

The Wear OS app is a remote for Yafmp on the paired Android phone. It plays nothing itself. The watch and the phone talk through Google Play services, over Bluetooth or Wi-Fi.

  • The main screen shows the title and artist over the dimmed cover, with previous, play or pause, next and a queue button.
  • The crown sets the phone’s volume. A ring around the screen shows the level while you turn it.
  • The queue shows up to 40 tracks around the playing one. Tap a track to play it. Swipe right to go back.
  • The tile, one swipe from the watch face, shows the current track with play or pause and next. Tapping the text opens the app.

The watch works with the phone app closed: a request from the watch starts it. When the phone does not answer, the watch shows “Phone not reachable”.

Other devices running Yafmp

With Connect, every copy of Yafmp on your network lists the others and can open a remote for each: transport, volume and the queue. It works between the Apple edition and the Android and desktop edition.

Home Assistant

With Home Assistant, a button, remote or sensor in your home can play, pause, skip or switch an equalizer preset. Apple edition only, not on Apple TV.

AI apps

On the desktop, the MCP server lets an AI app on the same computer see what is playing, search the library, play and manage the queue.