Apple AirPlayer

hacs_badge Stable

Home Assistant integration component, make your AirPlay devices as TTS speakers.

Before Use

2021.6.X or earlier

Apple Airplayer component requires pyatv 0.8.1, which is self-contained in the latest version Home Assistant (2021.7.3). You can run pip list | grep pyqatv in your Home Assistant container host to check the version of pyatv. If lower than 0.8.1, you should run commands as below to upgrade pyatv.

apk update
apk add build-base
pip3 install --upgrade pyatv
pip3 install --upgrade attrs

2021.7.X or later

There is a bug in Home Assistant 2021.7.3 ~ 2021.8.2 and it will cause HA core crash. If you are using HA 2021.7.3 ~ 2021.8.2, you need to reinstall miniaudio. Enter the following commands

apk update
apk add build-base
pip3 uninstall --yes miniaudio
pip3 install miniaudio

Notice: If you upgrade HA core to new release, you need to re-install miniaudio.


Use HACS and Install as a custom repository, or copy all files in custom_components/apple_airplayer from Latest Release to your /custom_components/apple_airplayer in Home Assistant manually. Restart HomeAssistant.


Add Apple AirPlayer component in Home Assistant integrations page, it could auto-discover Airplay devices in network. If component can not found any devices, you can specify the IP address to add the device.

Supported Devices

  • AirPort Express
  • AirPort Express Gen2
  • Apple TV 2
  • Apple TV 3
  • Apple TV 4
  • Apple TV 4K
  • Apple TV 4K Gen2
  • HomePod
  • HomePod Mini
  • Other AirPlay compatible devices