En una casa inteligente, la tele suele ser la pantalla que se queda fuera. Las luces bajan para la película, las persianas también, y la tele sigue pidiendo el mando. Esta guía conecta el IPTV con Home Assistant a través de OneTV Connect en Apple TV: tus canales pasan a ser un media_player de verdad, la guía de programación se convierte en sensores y un cambio de canal puede activar —o ser activado por— cualquier otra cosa de la casa.
Son unos cinco minutos, todo funciona en tu red local y no cuesta nada: la integración es de código abierto y no requiere suscripción a OneTV Pro. Funciona con la fuente que ya usas en la app: Xtream Codes, lista M3U, portal Stalker, Plex, Jellyfin o Emby.
Qué necesitas
- Un Apple TV con OneTV Connect y al menos una fuente añadida. OneTV Connect es un reproductor: no incluye canales.
- Home Assistant 2024.1 o posterior, con HACS instalado.
- Ambos en la misma red local. La detección usa Bonjour (mDNS), que no cruza VLAN ni redes de invitados salvo que el router lo retransmita.
- Recomendado: la integración Apple TV de Home Assistant, para que pueda despertar el aparato y abrir la app por ti.
Paso 1 · Activa la integración en la app
En el Apple TV, abre OneTV Connect y ve a Ajustes › Integraciones › Control y domótica.
- Abre Home Assistant y activa Habilitar Home Assistant. La pantalla muestra el puerto del servidor, 8766 por defecto.
- Deja también activado el mando de iOS. Home Assistant encuentra el Apple TV gracias al mismo anuncio de red que usa el mando del iPhone, y ese anuncio incluye la clave de acceso: por eso no tienes que escribir nada.
Nada sale de tu red. La clave solo permite que los dispositivos de tu wifi hablen con la app.
Paso 2 · Instala la integración desde HACS
- En Home Assistant, abre HACS, el menú ⋮ de arriba a la derecha y Repositorios personalizados.
- Pega
https://github.com/Seidel76/noopy-tv-homeassistant, elige el tipo Integración y pulsa Añadir. - Busca OneTV en HACS, ábrelo y pulsa Descargar.
- Reinicia Home Assistant por completo (Ajustes › Sistema › Reiniciar). Tras instalar o actualizar, recargar la integración no basta.
Sin HACS, copia la carpeta custom_components/noopy_tv del repositorio en tu directorio config/custom_components/ y reinicia.
Paso 3 · Añade el Apple TV
Tras el reinicio, abre Ajustes › Dispositivos y servicios. El Apple TV aparece en Descubierto, con el nombre que le diste en tvOS. Pulsa Añadir, confirma y se crean el dispositivo y sus entidades. Ni token ni contraseña: la clave llega con la detección.
Si no aparece nada, añádelo a mano: Añadir integración › OneTV, con la dirección IP del Apple TV (tvOS la muestra en Ajustes › Red) y el puerto indicado en OneTV Connect. Reservar una IP fija para el Apple TV en el router ahorra problemas después.
Paso 4 · Deja que Home Assistant abra la app
En tvOS, el servidor de una app solo funciona mientras la app está abierta, y ninguna app puede abrirse sola. Con OneTV Connect cerrada, sus entidades aparecen como no disponibles. La integración lo resuelve con la integración Apple TV que quizá ya tienes:
- Abre Ajustes › Dispositivos y servicios › OneTV › Configurar.
- Elige tu entidad Apple TV en Paired Apple TV y deja App name on the Apple TV en OneTV Connect. Esta ventana solo está traducida al inglés y al francés por ahora.
A partir de ahí, media_player.turn_on despierta el Apple TV y abre la app, y un play_channel enviado con la app cerrada la abre primero. En la misma ventana se ajusta el intervalo de consulta (de 5 a 300 segundos, 10 por defecto), que es sobre todo una red de seguridad: la app envía sus cambios al momento.
Qué aparece en Home Assistant
| Entidad | Qué aporta |
|---|---|
media_player | Reproducir, pausa, detener, canal siguiente y anterior, lista de fuentes (tus canales, en el orden de la lista), volumen y silencio, carátula, título del programa, posición. Avanzar y retroceder funciona en películas y episodios. |
| Reproducción actual (sensor) | El canal, la película o el episodio en pantalla, y si está reproduciéndose, en pausa o cargando. |
| Progreso (sensor) | En directo: el programa, su inicio y su fin, los minutos restantes y la sinopsis. En una película: posición, duración y tiempo restante. |
| Selectores de canal | Uno con todos los canales y, si mantienes la opción, uno por categoría. |
| Pista de audio, Subtítulos | Selectores para las pistas de lo que se está viendo. |
| App accesible | Un sensor binario que indica si OneTV Connect está abierta y responde. |
| Volver al directo | Un botón que aparece cuando ves en diferido. |
La versión actual crea las entidades con nombres en francés, así que los ID se parecen a sensor.onetv_lecture_en_cours. Compruébalos en Ajustes › Entidades y renómbralos si quieres: las automatizaciones de abajo usan media_player.onetv.
El explorador multimedia también funciona: Multimedia, en la barra lateral, muestra Continuar, Favoritos, canales por categoría, Películas y Series.
Cinco automatizaciones para copiar
Usan la sintaxis actual de Home Assistant (triggers / actions). Pégalas en Ajustes › Automatizaciones y escenas › Crear automatización › Editar en YAML y cambia los ID de entidad por los tuyos.
1. Pausa cuando llaman a la puerta
alias: "Pausa cuando llaman a la puerta"
triggers:
- trigger: state
entity_id: binary_sensor.timbre
to: "on"
conditions:
- condition: state
entity_id: media_player.onetv
state: playing
actions:
- action: media_player.media_pause
target:
entity_id: media_player.onetv2. Baja las luces cuando empieza el canal del partido
media_artist lleva el nombre del canal, así que puedes reaccionar a uno en concreto.
alias: "Luces de partido"
triggers:
- trigger: state
entity_id: media_player.onetv
attribute: media_artist
to: "DAZN LaLiga"
actions:
- action: light.turn_on
target:
entity_id: light.salon
data:
brightness_pct: 25
transition: 33. El Telediario de las nueve
La espera garantiza que la app responde antes de pedir el canal. El ID del sensor binario depende de tu instalación.
alias: "El Telediario"
triggers:
- trigger: time
at: "20:58:00"
conditions:
- condition: time
weekday: [mon, tue, wed, thu, fri]
actions:
- action: media_player.turn_on
target:
entity_id: media_player.onetv
- wait_template: "{{ is_state('binary_sensor.onetv_application_accessible', 'on') }}"
timeout: "00:02:00"
- action: noopy_tv.play_channel
data:
channel_id: "La 1"4. Se acabaron los dibujos a la hora de dormir
turn_off detiene la reproducción. tvOS no deja que una app se cierre sola: queda abierta en su pantalla de inicio.
alias: "Fin de los dibujos"
triggers:
- trigger: time
at: "20:30:00"
conditions:
- condition: state
entity_id: media_player.onetv
attribute: media_artist
state: "Clan"
actions:
- action: media_player.turn_off
target:
entity_id: media_player.onetv5. Control por voz con Alexa o Google
Los asistentes de voz no saben elegir un canal por su nombre como fuente. Lo fiable es un script corto por canal, expuesto al asistente mediante Home Assistant Cloud o tu propio puente. play_channel ignora mayúsculas y acentos, y también acepta el ID del canal.
script:
onetv_la_1:
alias: "La 1"
sequence:
- action: media_player.turn_on
target:
entity_id: media_player.onetv
- action: noopy_tv.play_channel
data:
channel_id: "La 1"Las demás acciones siguen el mismo patrón: noopy_tv.play_movie y noopy_tv.play_episode inician contenido del catálogo (los ID se ven en el explorador multimedia), y noopy_tv.send_command cubre pausa, avance, volver al directo, pistas y volumen.
Una tarjeta para el panel
Una tarjeta de control multimedia con los selectores de canal y de pistas es un mando completo en dos tarjetas:
type: vertical-stack
cards:
- type: media-control
entity: media_player.onetv
- type: entities
entities:
- select.onetv_toutes_les_chaines
- select.onetv_piste_audio
- select.onetv_sous_titresEl control de volumen ajusta el nivel de reproducción de OneTV Connect. El volumen del televisor o del receptor va por HDMI-CEC y el Siri Remote, fuera del alcance de cualquier app de tvOS.
Si algo no funciona
- El Apple TV nunca aparece. Comprueba que ambos estén en la misma subred, que el mando de iOS siga activado en la app y que el mDNS no se filtre entre VLAN. Si no, añádelo a mano con su IP.
- Las entidades no están disponibles. OneTV Connect está cerrada o el Apple TV en reposo. Vincula la entidad Apple TV (paso 4) para que Home Assistant pueda abrirla, y basa tus automatizaciones en el sensor «App accesible» y no en el estado del Apple TV.
- Faltan entidades nuevas tras una actualización. Reinicia Home Assistant por completo; recargar mantiene el código antiguo en memoria.
- No encuentra un canal. Usa el nombre tal como aparece en la lista de fuentes del
media_player, o el ID del canal. - La configuración falla al arrancar Home Assistant. La app tiene que responder durante la configuración. Abre OneTV Connect y recarga la integración.
¿Sigue sin funcionar? En la página de la integración está Descargar diagnósticos (la clave de acceso se elimina del archivo). Envíanoslo desde la página de soporte o abre una incidencia en GitHub.
Preguntas frecuentes
¿Existe una integración IPTV para Home Assistant?
Sí. OneTV Connect en Apple TV tiene una integración para Home Assistant que se instala desde HACS. Expone tus canales IPTV como un media_player con carátulas, sensores de la guía, selectores de canal y acciones como play_channel.
¿Hace falta una suscripción de pago?
No. La integración es gratuita y de código abierto, y no requiere OneTV Pro. Necesitas OneTV Connect en un Apple TV, tu propia fuente IPTV y Home Assistant 2024.1 o posterior.
¿Qué fuentes IPTV funcionan?
Cualquier fuente añadida en OneTV Connect: Xtream Codes, listas M3U, portales Stalker, además de Plex, Jellyfin y Emby. Home Assistant ve los mismos canales y la misma guía que la app.
¿Funciona en iPhone o Android?
La integración está pensada para OneTV Connect en Apple TV, el aparato conectado al televisor. La app de iPhone no está pensada para controlarse desde Home Assistant.
¿Home Assistant necesita internet para esto?
No. Todo ocurre en la red local: detección por Bonjour, órdenes y flujo de eventos por HTTP entre Home Assistant y el Apple TV.