thrash.dev

docs / providers / airplay

Providers · chapters · 14 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

AirPlay

Play to AirPlay speakers and TVs, including several AirPlay 2 speakers at once.

facts

status
beta
kind
output
on by default
yes
needs
AirPlay speaker or receiver on the same network
platforms
iPhone, iPad, Mac, Vision Pro, Android, Android TV, Linux, FreeBSD, Windows

Description

AirPlay sends what Yafmp plays to AirPlay speakers: HomePods, Apple TVs, Macs, AirPlay receivers and shairport-sync. You can play to several speakers at once and they stay in step.

The two editions do this differently.

  • Apple: Yafmp uses the system’s AirPlay. The AirPlay button in the toolbar opens Apple’s speaker picker. Vision Pro has no button in the app: pick speakers in Control Center.
  • Android and desktop: these systems have no AirPlay, so Yafmp has its own AirPlay 2 sender, with an AirPlay 1 fallback for speakers that need it. The AirPlay button in the top bar opens Yafmp’s own speaker menu.

AirPlay is not on Apple TV.

Requirements

  • An AirPlay speaker or receiver on the same network as the device.
  • Android: Android 9 or later. On older versions the AirPlay button is not shown.
  • Android 16 and later: the Nearby devices permission, so Yafmp may look for speakers on your network.
  • Linux and FreeBSD: avahi-daemon running and the avahi-browse tool installed. Yafmp finds speakers through them.
  • Windows: Apple’s Bonjour installed. Yafmp finds speakers with its dns-sd tool.
  • To play to a Mac or an Apple TV from Android or desktop: its AirPlay Receiver must allow Anyone on the Same Network (see Troubleshooting).

Setup

There is nothing to sign in to.

On iPhone, iPad and Mac:

  1. Choose the AirPlay button in the toolbar.
  2. Pick one or more speakers in the system picker.

On Vision Pro:

  1. Open Control Center.
  2. Pick the speakers there. Several can play at once.

On Android and desktop:

  1. Choose the AirPlay button in the top bar, or press Ctrl+Shift+A.
  2. Choose a speaker. It gets a tick once it is connected.
  3. Choose more speakers to add them to the group. Choose a ticked speaker again to take it out.
  4. Choose This device to stop and carry on playing on the device, at the same spot.

Settings

AirPlay has no settings pane. Its controls are in the toolbar (Apple) or the top bar (Android and desktop).

SettingDefaultWhat it does
Speaker list—Apple: the system picker. Android and desktop: one row per speaker found; choose it to add or remove it.
Volume slider—Android and desktop: one volume for the whole group, at the top of the menu while a speaker is connected.
This device—Android and desktop: disconnects every speaker and plays on the device again.

On Android, the volume keys change the speakers’ volume while Yafmp is in front. With Yafmp in the background they change the device’s own volume.

Limits

  • Mac: the picker is the system’s output picker. Any number of AirPlay 2 speakers can play together, but the Mac’s own speakers can’t play at the same time as AirPlay ones. The choice applies to all sound from the Mac.
  • Android and desktop: audio is sent as 16-bit, 44.1 kHz. Hi-res files are converted on the way.
  • Android and desktop: the equalizer is not applied to what goes to AirPlay speakers.
  • Android and desktop: the group has one volume. There is no volume per speaker.
  • Android and desktop: a Mac that asks for a code on screen can’t be used.
  • Sources with their own player are a special case on Android and desktop. Apple Music goes to the speakers on Android 10 and later, and on Linux and FreeBSD, as a recording of what the device plays. It is heard about a second late, and on Android the system first asks to share your screen (only Yafmp’s own sound is recorded). Spotify is not sent. The menu says so and greys out the speakers.
  • Linux and FreeBSD: some speakers (shairport-sync in AirPlay 2 mode) want timing from network ports 319 and 320. These are privileged ports. To let Yafmp use them, lower net.ipv4.ip_unprivileged_port_start to 319 on Linux, or lower net.inet.ip.portrange.reservedhigh below 319 (or use mac_portacl) on FreeBSD. Without this those speakers still play, over AirPlay 1. Android can use the ports without any setup.
  • Desktop: the position shown runs about two seconds ahead of what the speaker plays.
  • Starting a Chromecast session takes over from AirPlay.

Troubleshooting

ProblemWhyWhat to do
“… only accepts its own user: allow everyone on the network in its AirPlay settings”A Mac or Apple TV only takes AirPlay from its owner’s devicesOn the Mac: System Settings → General → AirDrop & Handoff → AirPlay Receiver → Anyone on the Same Network, with no password. Set the same access on an Apple TV.
A Mac takes a long time to connect the first timeThe Mac shows a prompt and waits for youAccept the prompt on the Mac.
The menu stays on “Looking for speakers…” on Linux or FreeBSDavahi-daemon is not running, or avahi-browse is missingStart avahi-daemon and install the avahi tools.
No speakers on WindowsApple’s Bonjour is not installedInstall Bonjour, then open the menu again.
No speakers on Android 16 or laterYafmp has no permission to look on your networkAllow Nearby devices for Yafmp.
No AirPlay button on AndroidThe Android version is older than 9None. AirPlay needs Android 9 or later.
“… plays through its own player, not to AirPlay speakers”The playing source can’t be sent from this devicePlay from another source, or play that service on a speaker of its own.
“… stays on this device: …”The recording that sends Apple Music was refused or stoppedOpen Yafmp and allow the screen-share prompt.
Mac: no sound from the Mac’s own speakers while AirPlay is onmacOS does not mix its own speakers with AirPlay onesPick the Mac’s speakers again in the picker when you are done.