shairport-sync/AIRPLAY2.md

AirPlay 2

Shairport Sync offers AirPlay 2 support for audio sources on iOS devices, Macs, HomePod minis and Apple TVs.

What Works

• AirPlay 2 for iOS, HomePod mini, AppleTV and Mac players.

What Does Not Work

• No Remote Control
• No AirPlay 2 for Windows iTunes

General

The focus of the development effort has been on getting good audio performance for iOS and Mac.

For AirPlay 2, Shairport Sync uses another application called nqptp ("Not Quite PTP") for timing and synchronisation. nqptp must run as root and must have exclusive access to ports 319 and 320.

The AirPlay 2 version of Shairport Sync will not work if installed on macOS. This is because nqptp uses ports 319 and 320 but these ports are unavailable because there are used by macOS to support its implementation of AirPlay 2.

Shairport Sync does not support lossless playback of Lossless or High Definition Lossless material. Instead, this material is automatically transcoded to ALAC or AAC before sending it via AirPlay 2 to Shairport Sync.

AirPlay 2 -- What You Need

AirPlay 2 support needs a slightly more powerful CPU for decoding and synchronisation and more memory for bigger buffers and larger libraries. A Raspberry Pi 2 or Raspberry Pi Zero 2 W or better is required.

Here are some guidelines:

• Full access, including root privileges, to a system at least as powerful as a Raspberry Pi 2 or a Raspberry Pi Zero 2 W.
• A fully up-to-date Linux. This is important, as some of the libraries must be the latest available.
• An audio output, for example an alsa device (or sndio in FreeBSD). You can use an application called sps-alsa-explore is available to test hardware alsa audio devices on your device for suitability. The stdout and pipe backends continue to work as before.

Guides

• To build Shairport Sync for AirPlay 2 on Linux, please follow the guide at BUILDFORAP2.md.
• A guide for building on FreeBSD is forthcoming.

AirPlay 2 -- More About What Works

• Two types of audio are received by Shairport Sync -- "Realtime" streams of CD quality ALAC (like AirPlay 1) and "Buffered Audio" streams of AAC stereo at 44,100 frames per second. The selection of stream type is made by the player.
• Audio is synchronised with other AirPlay 2 devices, including AirPlay 2 devices that have their own master clocks.
• Shairport Sync continues to support AirPlay 1, and offers an AirPlay 1 compatibility mode for situations where iTunes on macOS or macOS Music plays to multiple speakers and one of more of them is compatible with AirPlay 1 only.

Acknowledgements

Huge thanks are due to a number of individuals who made direct and valuable contributions to Shairport Sync:

1. ejurgensen contributed ideas and code. The pair_ap submodule and related code in rtsp.c is theirs.
2. JD Smith contributed ideas, comments and suggestions along with extensive and thorough testing.
3. Charles Omer contributed ideas, comments, bug fixes, documentation and Docker automation (forthcoming).
4. ckdo for their pathfinding work on AirPlay 2, especially the HomeKit pairing.

Much of Shairport Sync's AirPlay 2 functionality is based on ideas developed at the openairplay airplay2-receiver repository. It is a pleasure to acknowledge the work of the contributors there.

Finally

Did we mention AirPlay 2 support is experimental?