thrash.dev

docs / providers / connect

Providers · chapters · 22 of 25

← Yafmp manual

  1. Local Files
  2. Plex
  3. Navidrome
  4. Jellyfin
  5. Bandcamp
  6. Lidarr
  7. Apple Music
  8. Spotify
  9. SoundCloud
  10. YouTube Music
  11. SiriusXM
  12. Radio
  13. Podcasts
  14. AirPlay
  15. Chromecast
  16. MusicBrainz
  17. Discogs
  18. Labels
  19. Releases
  20. Last.fm
  21. ListenBrainz
  22. Connect
  23. Home Assistant
  24. MCP server
  25. DJ

Connect

See and control Yafmp on your other devices on the same network.

facts

status
beta
kind
control
on by default
yes
needs
Two or more devices running Yafmp, The same local network, iCloud Keychain, or the key copied from an Apple device
platforms
iPhone, iPad, Mac, Vision Pro, Apple TV, Android, Android TV, Linux, FreeBSD, Windows

Description

Connect lets copies of Yafmp on one network list each other and control each other. In the app the plugin is called Other Devices.

Each running copy announces itself on the local network. The others show it in a devices menu with what it is playing. Pick a device and a remote opens: the current track, previous, play or pause, next, a volume slider and that device’s queue. Tap a row in the queue to play it there.

Connect is see and control only. Playback never moves from one device to another.

The devices talk over an encrypted connection that needs a shared key, so only your own devices can connect. Both editions use the same protocol, so an iPhone can control the Linux desktop and the other way round.

Requirements

  • Yafmp running on at least two devices on the same local network.
  • A network that lets devices find each other with Bonjour (mDNS). Yafmp listens on TCP port 43830, or on another free port when that one is taken.
  • Apple: the devices signed in to the same iCloud account with iCloud Keychain on. iOS asks for permission to use the local network.
  • Android and desktop: the key from one of your Apple devices, pasted in once per device.
  • Linux and FreeBSD: Avahi, with avahi-daemon running. Windows: Bonjour (the dns-sd tool).

Setup

On Apple devices there is nothing to set up. The first device to run Yafmp makes the key, and iCloud Keychain carries it to the others. The Other devices button appears in the Output menu when another copy is found.

On Android and desktop:

  1. On an Apple device, open Preferences → Plugins → Other Devices.
  2. Choose Show to see the key, or Copy to copy it.
  3. On the Android or desktop device, open Settings → Other Devices.
  4. Paste the key into Key and choose Use Key. The line above changes to “Key set. Listening on port 43830.”
  5. The devices button appears in the toolbar when another copy is found.

Repeat steps 3 and 4 on each Android or desktop device.

Settings

SettingDefaultWhat it does
Show / HidehiddenApple: shows the shared key as text, for your Android and desktop copies.
Copy—Apple: copies the key. Not on Apple TV.
KeyemptyAndroid and desktop: the field for the key from the Apple app. Once a key is set it is labelled Replace the key.
Use Key—Android and desktop: saves the key and restarts Connect with it.

On Android and desktop the section also lists the other copies found, each with what it plays or “can’t connect”.

The name a device shows to the others is the device’s own name. The desktop shows the computer’s host name followed by “desktop”.

Limits

  • Playback does not transfer between devices.
  • The remote has transport, volume and the queue. It has no seek, shuffle, repeat or library browsing, and it shows no cover art.
  • The queue in the remote is one window of up to 100 rows, starting just before the playing track.
  • The volume slider is disabled when the other device cannot set the volume for what it is playing.
  • An iPhone or iPad is only listed while Yafmp is in front or playing. iOS suspends the app otherwise.
  • An Android device in the background keeps answering, so you can control it while it plays. It stops searching for the others until the app is in front again.
  • The Apple TV can be listed and controlled, but it has no remote for the others.
  • The Android and desktop editions do not create a key. The app expects the key from an Apple device. The key field takes any 32-byte key written as base64 (44 characters), and copies that hold the same key connect to each other.
  • Connections use IPv4 addresses only.
  • A device remembers where it last reached each of the others, for 30 days. One device does not tell a second where a third one is.

Troubleshooting

ProblemWhyWhat to do
No devices buttonNo other copy has been found; the button only appears when there is onePut the devices on the same network. On Linux and FreeBSD start avahi-daemon; on Windows install Bonjour; on Android 16 and later allow Nearby devices.
A device is listed but says “Can’t connect”It does not have the same keyApple: check that both devices use the same iCloud account with iCloud Keychain on, and give the key time to arrive. Android and desktop: paste the key again.
“That isn’t the key: 44 characters of base64, from the Apple app”The pasted text is not a complete keyCopy the key again with Copy and paste all of it.
Devices on the same network never find each otherThe network does not pass Bonjour between themOn the Android or desktop device open the command palette, choose Connect to and enter the other device’s address (host or host:port). After one contact the address is remembered.
A Mac sees none of the othersThe Mac is on the same network twice, over Ethernet and Wi-FiTurn one of the two connections off.
An iPhone or iPad drops out of the listiOS suspended Yafmp in the backgroundBring Yafmp to the front, or start playback on it.