Articles in this section

Apple TV integration

This integrated integration discovers Apple TV devices on the network and pairs them using AirPlay and Companion protocols. Multiple Apple TV devices are supported and a media-player entity is exposed to the Remote per device.

Network requirements

  • The Apple TV device must be on the same network subnet as the Remote. Routed networks are not supported.
  • Zeroconf (multicast DNS) must be a allowed. Check your WiFi access point and router that this traffic is not filtered out.
  • When using DHCP: a static IP address reservation for the Apple TV device(s) is recommended. A fixed IP address can speed up reconnection and helps to identify the device again if Apple changes the (not so) unique device identifiers.
  • See general Network requirements for further information.

Apple TV device

  • Supported versions: Apple TV 4 and newer models with tvOS 16+
  • Make sure you have “Allow Access” set to “Anyone on the Same Network” for AirPlay on your Apple TV.
  • When using multiple Apple TVs, each device should have a unique name for easier identification.
    • The name can be set under Settings, General, About: Name
  • The name should not be changed anymore once the Apple TV is connected with this integration. This helps to identify the device again if the device identifiers change after a tvOS update.
  • Disabling automatic software updates is recommended, especially if you rely on controlling an Apple TV with an Unfolded Circle Remote.
    • tvOS updates might break certain functionality.
    • It can take time to fix these issues and release a new integration version.

More information

This integration is open sourced. It can also be run on a PC on your network and used as an external integration.

Was this article helpful?
0 out of 0 found this helpful