Applel TV integration Error

weelco · October 19, 2025, 4:41pm

Upon installing the integration, my AppleTV device is found (without having to specify the ip address) but when I select the device to finilize the installation process I reveive an errror:

Oops!

Something went wrong while setting up the integration.

Other

Any ideas anyone? My Apple TV is 4K (A2169).

Cheers Eelco

kennymc.c · October 19, 2025, 4:53pm

Please post the logs from the integration after the error occured (settings/development/logs). Also make sure that all settings on the Apple TV are correct.: https://support.unfoldedcircle.com/hc/en-us/articles/19479576638620-Apple-TV-integration

weelco · October 19, 2025, 4:57pm

how do i get to the logs? SSH?

kennymc.c · October 19, 2025, 4:58pm

Like I wrote: Go to Settings/Development/Logs and choose the Apple TV integration from the dropdown.

weelco · October 19, 2025, 5:18pm

2025-10-19 17:17:51.748674 +00:00 intg-appletv INFO DEBUG:driver:Client disconnect command: disconnecting device(s)
2025-10-19 17:17:51.744851 +00:00 intg-appletv INFO INFO:ucapi.api:WS: Client removed
2025-10-19 17:17:47.745972 +00:00 intg-appletv INFO client_session: <aiohttp.client.ClientSession object at 0xffffb962a650>
2025-10-19 17:17:47.745972 +00:00 intg-appletv INFO ERROR:asyncio:Unclosed client session
2025-10-19 17:17:47.744845 +00:00 intg-appletv INFO DEBUG:tv:[Woonkamer] Polling was already stopped
2025-10-19 17:17:47.743869 +00:00 intg-appletv INFO DEBUG:tv:[Woonkamer] Disconnecting from device
2025-10-19 17:17:47.742533 +00:00 intg-appletv INFO INFO:setup_flow:Setup was aborted with code: IntegrationSetupError.OTHER
2025-10-19 17:17:47.742533 +00:00 intg-appletv INFO DEBUG:ucapi.api:[(‘127.0.0.1’, 48748)] <-: {“kind”:“event”,“msg”:“abort_driver_setup”,“cat”:“DEVICE”,“ts”:“2025-10-19T17:17:47.737172711Z”,“msg_data”:{“error”:“OTHER”}}
2025-10-19 17:17:47.734818 +00:00 intg-appletv INFO DEBUG:ucapi.api:[(‘127.0.0.1’, 48748)] ->: {‘kind’: ‘event’, ‘msg’: <WsMsgEvents.DRIVER_SETUP_CHANGE: ‘driver_setup_change’>, ‘msg_data’: {‘event_type’: ‘STOP’, ‘state’: ‘ERROR’, ‘error’: ‘OTHER’}, ‘cat’: <EventCategory.DEVICE: ‘DEVICE’>}
2025-10-19 17:17:47.230320 +00:00 intg-appletv INFO ERROR:ucapi.api:Exception in setup handler, aborting setup! Exception: not authenticated
2025-10-19 17:17:47.190596 +00:00 intg-appletv INFO DEBUG:tv:[Woonkamer] Pairing started
2025-10-19 17:17:47.189613 +00:00 intg-appletv INFO DEBUG:setup_flow:Pairing process begin
2025-10-19 17:17:47.117123 +00:00 intg-appletv INFO DEBUG:setup_flow:Chosen Apple TV: 4A:86:3F:6C:87:A1
2025-10-19 17:17:47.117123 +00:00 intg-appletv INFO DEBUG:setup_flow:UserDataResponse(input_values={‘address’: ‘’, ‘choice’: ‘4A:86:3F:6C:87:A1’, ‘global_volume’: ‘false’})
2025-10-19 17:17:47.114049 +00:00 intg-appletv INFO DEBUG:ucapi.api:[(‘127.0.0.1’, 48748)] ->: {‘kind’: ‘event’, ‘msg’: <WsMsgEvents.DRIVER_SETUP_CHANGE: ‘driver_setup_change’>, ‘msg_data’: {‘event_type’: ‘SETUP’, ‘state’: ‘SETUP’}, ‘cat’: <EventCategory.DEVICE: ‘DEVICE’>}
2025-10-19 17:17:46.612294 +00:00 intg-appletv INFO DEBUG:ucapi.api:[(‘127.0.0.1’, 48748)] ->: {‘kind’: ‘resp’, ‘req_id’: 37, ‘code’: 200, ‘msg’: ‘result’, ‘msg_data’: {}}
2025-10-19 17:17:46.608541 +00:00 intg-appletv INFO DEBUG:ucapi.api:[(‘127.0.0.1’, 48748)] <-: {“kind”:“req”,“id”:37,“msg”:“set_driver_user_data”,“msg_data”:{“input_values”:{“address”:“”,“choice”:“4A:86:3F:6C:87:A1”,“global_volume”:“false”}}}
2025-10-19 17:17:42.915137 +00:00 intg-appletv INFO DEBUG:ucapi.api:[(‘127.0.0.1’, 48748)] ->: {‘kind’: ‘event’, ‘msg’: <WsMsgEvents.DRIVER_SETUP_CHANGE: ‘driver_setup_change’>, ‘msg_data’: {‘event_type’: ‘SETUP’, ‘state’: ‘WAIT_USER_ACTION’, ‘require_user_action’: {‘input’: {‘title’: {‘en_US’: ‘Please choose your Apple TV’, ‘de_DE’: ‘Bitte wähle deinen Apple TV’, ‘es_ES’: ‘Por favor, elige tu Apple TV’, ‘fr_FR’: ‘Choisissez votre Apple TV’, ‘nl_NL’: ‘Kies je Apple TV’, ‘sv_SE’: ‘Vänligen välj din Apple TV’}, ‘settings’: [{‘field’: {‘dropdown’: {‘value’: ‘4A:86:3F:6C:87:A1’, ‘items’: [{‘id’: ‘4A:86:3F:6C:87:A1’, ‘label’: {‘en’: ‘Woonkamer (192.168.1.72)’}}]}}, ‘id’: ‘choice’, ‘label’: {‘en_US’: ‘Choose your Apple TV’, ‘de_DE’: ‘Wähle deinen Apple TV’, ‘es_ES’: ‘Elige tu Apple TV’, ‘fr_FR’: ‘Choisissez votre Apple TV’, ‘nl_NL’: ‘Kies je Apple TV’, ‘sv_SE’: ‘Välj din Apple TV’}}, {‘id’: ‘global_volume’, ‘label’: {‘en_US’: ‘Change volume on all connected devices’, ‘de_DE’: ‘Lautstärkeregelung auf allen verbundenen Geräten’, ‘es_ES’: ‘Cambia el volumen en todos los dispositivos conectados’, ‘fr_FR’: ‘Régler le volume sur tous les appareils connectés’, ‘nl_NL’: ‘Wijzig volume op alle aangesloten apparaten’, ‘sv_SE’: ‘Styr volymen på alla anslutna enheter’}, ‘field’: {‘checkbox’: {‘value’: True}}}]}}}, ‘cat’: <EventCategory.DEVICE: ‘DEVICE’>}
2025-10-19 17:17:42.911121 +00:00 intg-appletv INFO INFO:setup_flow:Found: Apple TV 4K (gen 2), tvOS 26.0.1, Woonkamer (192.168.1.72)
2025-10-19 17:17:37.843890 +00:00 intg-appletv INFO INFO:discover:Starting Apple TV device discovery
2025-10-19 17:17:37.841137 +00:00 intg-appletv INFO DEBUG:setup_flow:Starting driver setup with Apple TV discovery
2025-10-19 17:17:37.841137 +00:00 intg-appletv INFO DEBUG:setup_flow:UserDataResponse(input_values={‘address’: ‘’})
2025-10-19 17:17:37.838108 +00:00 intg-appletv INFO DEBUG:ucapi.api:[(‘127.0.0.1’, 48748)] ->: {‘kind’: ‘event’, ‘msg’: <WsMsgEvents.DRIVER_SETUP_CHANGE: ‘driver_setup_change’>, ‘msg_data’: {‘event_type’: ‘SETUP’, ‘state’: ‘SETUP’}, ‘cat’: <EventCategory.DEVICE: ‘DEVICE’>}
2025-10-19 17:17:37.337173 +00:00 intg-appletv INFO DEBUG:ucapi.api:[(‘127.0.0.1’, 48748)] ->: {‘kind’: ‘resp’, ‘req_id’: 36, ‘code’: 200, ‘msg’: ‘result’, ‘msg_data’: {}}
2025-10-19 17:17:37.332525 +00:00 intg-appletv INFO DEBUG:ucapi.api:[(‘127.0.0.1’, 48748)] <-: {“kind”:“req”,“id”:36,“msg”:“set_driver_user_data”,“msg_data”:{“input_values”:{“address”:“”}}}
2025-10-19 17:17:34.820354 +00:00 intg-appletv INFO DEBUG:ucapi.api:[(‘127.0.0.1’, 48748)] ->: {‘kind’: ‘resp’, ‘req_id’: 35, ‘code’: 200, ‘msg’: <WsMsgEvents.DRIVER_VERSION: ‘driver_version’>, ‘msg_data’: {‘name’: ‘Apple TV’, ‘version’: {‘api’: ‘0.7.1’, ‘driver’: ‘0.19.0’}}}
2025-10-19 17:17:34.816355 +00:00 intg-appletv INFO DEBUG:ucapi.api:[(‘127.0.0.1’, 48748)] <-: {“id”:35,“kind”:“req”,“msg”:“get_driver_version”}
2025-10-19 17:17:34.816355 +00:00 intg-appletv INFO DEBUG:ucapi.api:[(‘127.0.0.1’, 48748)] ->: {‘kind’: ‘event’, ‘msg’: <WsMsgEvents.DRIVER_SETUP_CHANGE: ‘driver_setup_change’>, ‘msg_data’: {‘event_type’: ‘SETUP’, ‘state’: ‘WAIT_USER_ACTION’, ‘require_user_action’: {‘input’: {‘title’: {‘en_US’: ‘Setup mode’, ‘de_DE’: ‘Setup Fortschritt’, ‘es_ES’: ‘Modo de configuración’, ‘fr_FR’: ‘Progression de la configuration’, ‘nl_NL’: ‘Setup-modus’, ‘sv_SE’: ‘Konfigureringsprocess’}, ‘settings’: [{‘id’: ‘info’, ‘label’: {‘en_US’: ‘Discover or connect to Apple TV device’, ‘de_DE’: ‘Suche oder Verbinde auf Apple TV Gerät’, ‘es_ES’: ‘Descubre o conecta con el dispositivo Apple TV’, ‘fr_FR’: “Découvrir ou connexion à l’appareil Apple TV”, ‘nl_NL’: ‘Ontdek of maak verbinding met Apple TV apparaat’, ‘sv_SE’: ‘Upptäck eller anslut till Apple TV-enhet’}, ‘field’: {‘label’: {‘value’: {‘en_US’: ‘Leave blank to use auto-discovery and click Next.\n\nThe device must be on the same network as the remote.’, ‘de_DE’: ‘Leer lassen, um automatische Erkennung zu verwenden und auf Weiter klicken.\n\nDas Gerät muss sich im gleichen Netzwerk wie die Fernbedienung befinden.’, ‘es_ES’: ‘Deje en blanco para usar auto-discovery y haga click en Siguiente.\n\nEl dispositivo debe estar en la misma red que el mando a distancia.’, ‘fr_FR’: “Laissez le champ vide pour utiliser la découverte automatique et cliquez sur Suivant.\n\nL’appareil doit être sur le même réseau que la télécommande.”, ‘nl_NL’: ‘Laat dit veld leeg om auto-discovery te gebruiken en klik Volgende.\n\nHet apparaat moet op hetzelfde netwerk aangesloten zijn als de afstandsbediening.’, ‘sv_SE’: ‘Lämna tomt för att hitta automatiskt och klicka på Nästa.\n\nEnheten måste vara på samma nätverk som fjärrkontrollen.’}}}}, {‘id’: ‘address’, ‘label’: {‘en_US’: ‘IP address (same network only)’, ‘de_DE’: ‘IP-Adresse (nur im gleichen Netzwerk)’, ‘es_ES’: ‘Dirección IP (solo de la misma red)’, ‘fr_FR’: ‘Adresse IP (seulement dans le même réseau)’, ‘nl_NL’: ‘IP-adres (alleen op hetzelfde netwerk)’, ‘sv_SE’: ‘IP-adress (endast samma nätverk)’}, ‘field’: {‘text’: {‘value’: ‘’}}}]}}}, ‘cat’: <EventCategory.DEVICE: ‘DEVICE’>}
2025-10-19 17:17:34.803878 +00:00 intg-appletv INFO DEBUG:ucapi.api:[(‘127.0.0.1’, 48748)] ->: {‘kind’: ‘event’, ‘msg’: <WsMsgEvents.DRIVER_SETUP_CHANGE: ‘driver_setup_change’>, ‘msg_data’: {‘event_type’: ‘SETUP’, ‘state’: ‘SETUP’}, ‘cat’: <EventCategory.DEVICE: ‘DEVICE’>}
2025-10-19 17:17:34.800628 +00:00 intg-appletv INFO DEBUG:driver:Configuration cleared, disconnecting & removing all configured ATV instances
2025-10-19 17:17:34.799413 +00:00 intg-appletv INFO DEBUG:setup_flow:Starting driver setup, reconfigure=False
2025-10-19 17:17:34.797546 +00:00 intg-appletv INFO DEBUG:ucapi.api:[(‘127.0.0.1’, 48748)] ->: {‘kind’: ‘resp’, ‘req_id’: 34, ‘code’: 200, ‘msg’: ‘result’, ‘msg_data’: {}}
2025-10-19 17:17:34.795803 +00:00 intg-appletv INFO DEBUG:ucapi.api:[(‘127.0.0.1’, 48748)] <-: {“kind”:“req”,“id”:34,“msg”:“setup_driver”,“msg_data”:{“reconfigure”:false,“setup_data”:{}}}
2025-10-19 17:17:34.794100 +00:00 intg-appletv INFO DEBUG:ucapi.api:[(‘127.0.0.1’, 48748)] ->: {‘kind’: ‘resp’, ‘req_id’: 0, ‘code’: 200, ‘msg’: <WsMessages.AUTHENTICATION: ‘authentication’>, ‘msg_data’: {}}
2025-10-19 17:17:34.788353 +00:00 intg-appletv INFO INFO:ucapi.api:WS: Client added: (‘127.0.0.1’, 48748)

kennymc.c · October 19, 2025, 5:50pm

ERROR:ucapi.api:Exception in setup handler, aborting setup! Exception: not authenticated

Check that you have “Allow Access” set to “Anyone on the Same Network” for AirPlay on your Apple TV. This is also mentioned in the support article I linked above.

weelco · October 19, 2025, 6:06pm

Ok now i see thanks a lot that helps, sorry for not reading properly! Thanks again works now!