Providers · chapters · 14 of 25
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-daemonrunning and theavahi-browsetool installed. Yafmp finds speakers through them. - Windows: Apple’s Bonjour installed. Yafmp finds speakers with its
dns-sdtool. - 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:
- Choose the AirPlay button in the toolbar.
- Pick one or more speakers in the system picker.
On Vision Pro:
- Open Control Center.
- Pick the speakers there. Several can play at once.
On Android and desktop:
- Choose the AirPlay button in the top bar, or press Ctrl+Shift+A.
- Choose a speaker. It gets a tick once it is connected.
- Choose more speakers to add them to the group. Choose a ticked speaker again to take it out.
- 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).
| Setting | Default | What 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_startto 319 on Linux, or lowernet.inet.ip.portrange.reservedhighbelow 319 (or usemac_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
| Problem | Why | What 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 devices | On 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 time | The Mac shows a prompt and waits for you | Accept the prompt on the Mac. |
| The menu stays on “Looking for speakers…” on Linux or FreeBSD | avahi-daemon is not running, or avahi-browse is missing | Start avahi-daemon and install the avahi tools. |
| No speakers on Windows | Apple’s Bonjour is not installed | Install Bonjour, then open the menu again. |
| No speakers on Android 16 or later | Yafmp has no permission to look on your network | Allow Nearby devices for Yafmp. |
| No AirPlay button on Android | The Android version is older than 9 | None. AirPlay needs Android 9 or later. |
| “… plays through its own player, not to AirPlay speakers” | The playing source can’t be sent from this device | Play 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 stopped | Open Yafmp and allow the screen-share prompt. |
| Mac: no sound from the Mac’s own speakers while AirPlay is on | macOS does not mix its own speakers with AirPlay ones | Pick the Mac’s speakers again in the picker when you are done. |