Yafmp · chapters · 09 of 11
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.
| Control | Platforms |
|---|---|
| Lock screen, Control Center, media keys, headphone buttons | iPhone, iPad, Mac (menu bar), Vision Pro, Apple TV |
| Notification, lock screen, Bluetooth controls | Android, Android TV |
| Desktop media keys and now-playing widgets (MPRIS) | Linux, FreeBSD |
| Apple Watch app | iPhone |
| Wear OS app and tile | Android phones |
| Connect: Yafmp on your other devices | All |
| Home Assistant | iPhone, iPad, Mac, Vision Pro |
| MCP server: AI apps | Linux, 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 offers | Notes |
|---|---|
| Play, pause, play/pause, stop, next, previous | |
| Seek and set position | |
| Shuffle and loop status | Loop Track is repeat one, Playlist is repeat all. |
| Volume | Only when Yafmp can set the volume for what is playing. |
| Raise | Brings the Yafmp window to the front. |
| Metadata | Title, 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.