Pilotez votre IPTV depuis Home Assistant (sans cloud, sans token)

Votre télé est sans doute le seul écran de la maison qui n'est jamais entré dans votre domotique. OneTV Connect y remédie : l'app embarque un petit serveur HTTP local que Home Assistant découvre sur votre réseau et avec lequel il s'appaire en un seul clic. À partir de là, votre Apple TV se comporte comme n'importe quelle entité media_player Home Assistant — vous lisez ce qu'elle diffuse, vous changez de chaîne depuis un tableau de bord, et vous branchez des automatisations qui réagissent dès que la chaîne change. C'est un vrai contrôle IPTV Home Assistant, entièrement sur votre réseau local, sans cloud et sans token.

Ce que fait l'intégration

OneTV Connect intègre un serveur REST léger qui expose l'état courant de l'app et la liste des chaînes en JSON simple, plus un flux d'événements en direct. Lorsque vous l'activez, l'app s'annonce sur votre réseau local via Bonjour pour que Home Assistant la trouve automatiquement — rien à configurer à la main. Le résultat : une véritable entité media_player dans Home Assistant, avec un contrôle bidirectionnel — lisez l'état sur vos tableaux de bord, et envoyez des commandes (changer de chaîne, lecture, pause, stop) depuis des tuiles ou des automatisations. Comme le serveur pré-encode ses caches JSON, l'interroger ne coûte quasiment rien — cela ne ralentit pas la lecture sur l'Apple TV.

Votre télé devient ainsi un membre à part entière de la maison connectée. « Ambiance salon à 20 h », « mettre en pause quand quelqu'un sonne à la porte », « faire clignoter les lumières lorsqu'un but est marqué » — autant d'automatisations tenant en une ligne. Et ce n'est pas réservé à Home Assistant : tout ce qui parle HTTP (les Raccourcis iOS, Node-RED, openHAB, un script sur Raspberry Pi) peut dialoguer avec les mêmes points d'accès.

Appairage Bonjour en un clic

L'appairage est pensé pour être trivial — pas d'adresse MAC, pas d'IP, pas de token durable à recopier. Voici le déroulé complet :

1. Dans OneTV, ouvrez Réglages → Home Assistant et activez « Exposer à Home Assistant ». Le serveur REST local et son annonce Bonjour démarrent aussitôt.
2. Dans Home Assistant, allez dans Paramètres → Appareils et services → Ajouter une intégration et cherchez « OneTV Connect ».
3. Votre Apple TV apparaît dans la liste de découverte en quelques secondes. Cliquez dessus — l'appairage est instantané, sans token ni configuration manuelle.
4. OneTV apparaît désormais en entité media_player, prête pour les tableaux de bord et les automatisations.

La découverte Bonjour fonctionne de la même façon que OneTV tourne sur Apple TV, iPhone ou iPad : l'automatisation Apple TV Home Assistant n'est jamais qu'à deux clics.

L'entité media_player

Une fois appairée, OneTV est un media_player Home Assistant standard. Vous récupérez l'état et les attributs habituels attendus d'un appareil media_player IPTV Home Assistant :

• State — playing, paused ou idle, pour que vos automatisations sachent si la télé est réellement utilisée.
• media_title et media_artist — le programme en cours et les métadonnées de la chaîne.
• media_image_url — la jaquette du programme diffusé, prête à insérer dans une carte Lovelace.
• source et source_list — le nom de la chaîne courante et la liste complète des chaînes, pour construire un sélecteur de chaîne directement depuis l'entité.
• Services — les classiques media_play, media_pause, media_stop et media_next_track, appelables depuis une tuile ou une automatisation.

Exemples d'automatisations

Comme il s'agit d'une entité normale, vous écrivez vos automatisations exactement comme d'habitude. Un grand classique : mettre en pause ce qui passe à la télé quand on sonne à la porte.

automation:
  - alias: "Pause de l'IPTV quand on sonne"
    trigger:
      - platform: state
        entity_id: binary_sensor.sonnette_entree
        to: "on"
    condition:
      - condition: state
        entity_id: media_player.onetv_connect
        state: "playing"
    action:
      - service: media_player.media_pause
        target:
          entity_id: media_player.onetv_connect

Un autre favori pour les soirées match — planter l'ambiance dès qu'une chaîne de sport démarre :

automation:
  - alias: "Lumières de match"
    trigger:
      - platform: state
        entity_id: media_player.onetv_connect
        attribute: source
        to: "beIN Sports 1"
    action:
      - service: light.turn_on
        target:
          entity_id: light.salon
        data:
          brightness_pct: 30

À partir de là, ce ne sont que des briques : basculer sur la chaîne d'info à 20 h avec media_player.select_source, couper le son de tout l'étage au démarrage de la lecture, ou envoyer une notification lorsque la télé est inactive depuis une heure.

Réagir aux événements de lecture via SSE

Interroger le serveur toutes les quelques secondes fonctionne, mais OneTV pousse aussi un flux d'événements en direct pour que vos automatisations se déclenchent à l'instant précis où quelque chose se produit. Le serveur REST expose un point d'accès Server-Sent Events qui émet un événement dès que la chaîne change, que la lecture démarre ou s'arrête, ou qu'un contexte sportif est détecté — avec une latence inférieure à la seconde. Au lieu que Home Assistant demande « qu'est-ce qui passe maintenant ? » dix fois par minute, OneTV le lui annonce dès que la réponse change.

En pratique, l'état et les attributs de l'entité media_player se mettent à jour à partir de ces push, si bien que les automatisations ci-dessus réagissent en temps réel — les lumières se tamisent au coup d'envoi, pas cinq secondes plus tard. Si vous voulez consommer le flux brut vous-même (pour Node-RED ou un script maison), vous pouvez vous abonner directement au point d'accès SSE et agir sur chaque événement.

Confidentialité : tout en local, sans cloud

Tout se passe ici sur votre propre réseau. Le serveur REST de OneTV n'écoute que sur le LAN — aucun token exposé, aucun relais cloud, aucun tiers dans la boucle. Home Assistant parle directement à votre Apple TV sur le réseau local, et votre état de visionnage ne quitte jamais votre domicile. C'est un choix de conception délibéré : une télé qui rejoint la maison connectée ne doit pas se payer au prix de l'envoi de vos habitudes sur le serveur de quelqu'un d'autre.

Voilà tout — une télé scriptable qui s'intègre à la domotique que vous faites déjà tourner. Retrouvez la liste complète des points d'accès sur la page de l'intégration Home Assistant, découvrez comment OneTV s'utilise sur grand écran sur la page Apple TV, ou récupérez l'app sur l'App Store. Bloqué sur la découverte ? La page de support contient la checklist réseau.