Votre projecteur, dans Home Assistant et Hubitat.

• Elle publie l'état. Le projecteur apparaît comme un capteur Home Assistant, un appareil Hubitat ou une charge JSON sur votre webhook, avec les mêmes mesures que celles que l'appli vous montre.
• Elle publie les commandes. Chaque scène que vous enregistrez, ainsi que l'alimentation, chaque entrée, chaque mode couleur et chaque mémoire d'objectif, devient quelque chose qu'une automatisation ou un assistant vocal peut exécuter.
• Elle fonctionne sans serveur. Une fois les scripts configurés, Home Assistant envoie les commandes directement à l'adresse IP du projecteur. Votre téléphone n'a pas besoin d'être sur le réseau, et rien ne passe par un compte cloud.

Trois voies d'accès, un seul hub

Réglages › Domotique est le hub. Choisissez la plateforme que vous utilisez - Home Assistant, Hubitat ou Webhooks - et configurez-la là. Vous pouvez en brancher plusieurs à la fois ; elles sont indépendantes.

1. Ouvrez Réglages › Domotique › Home Assistant.
2. Saisissez votre adresse Home Assistant (par exemple http://homeassistant.local:8123 ou son IP), puis touchez Se connecter. C'est une connexion dans le navigateur auprès de votre propre instance - il n'y a aucun jeton à coller. Utilisez votre identifiant Home Assistant habituel, avec la double authentification et tout le reste.
3. L'appli publie le projecteur comme capteur, avec une entité du type sensor.projector_pilot_epson_qb1000b_qb1000w, qui porte l'alimentation, l'entrée, le mode couleur, les valeurs d'image et les heures de lampe.
4. Activez Envoyer l'état du projecteur pour que ces mesures se mettent à jour dans Home Assistant dès qu'elles changent tant que l'appli est ouverte, et activez Sync Advanced Controls pour publier des scripts pour les modes d'image, les entrées, les mémoires d'objectif et l'alimentation.
5. Collez le bloc shell_command (ci-dessous) dans votre configuration.yaml, redémarrez Home Assistant, puis touchez Sync With HA.

Le bloc shell_command

Voilà toute l'astuce du fonctionnement sans serveur. L'appli écrit une commande que Home Assistant exécute pour parler au Web Control du projecteur, et chaque script synchronisé appelle cette commande avec un verbe différent. Touchez Copier le bloc dans l'appli et collez-le dans configuration.yaml. L'exemple ci-dessous est illustratif : l'appli renseigne l'adresse et le nom de commande propres à votre projecteur :

shell_command:
  projector_pilot_epson: >-
    curl -s --max-time 5 --digest -u 'EPSONWEB:'
    -H "X-Requested-With: XMLHttpRequest"
    -H "Referer: http://192.168.1.50/cgi-bin/webconf"
    "http://192.168.1.50/cgi-bin/directsend?{{ verb }}={{ value | urlencode }}"

Exemple uniquement. L'appli génère le vôtre avec la vraie IP du projecteur et un nom dérivé de son numéro de série.

Tester la connexion, synchroniser et nettoyer

• Tester la connexion vérifie que l'appli joint votre Home Assistant et que le shell_command collé s'y trouve bien, pour que vous découvriez une faute de frappe avant de construire quoi que ce soit dessus.
• Sync With HA écrit ou met à jour les scripts de vos scènes et commandes, et construit un tableau de bord Projector Pilot prêt à l'emploi directement dans Home Assistant. Relancez-le à tout moment quand vous ajoutez une scène ou changez une commande : il met à jour sur place au lieu d'empiler des doublons.
• Supprimer les scripts orphelins trouve les scripts écrits par l'appli qui n'ont plus de scène ou de commande correspondante - par exemple après la suppression d'une scène - indique précisément lesquels il va supprimer, et demande d'abord. Rien n'est supprimé avant votre confirmation. Il ne touche jamais qu'aux scripts créés par Projector Pilot ; rien d'autre dans votre Home Assistant n'est perturbé, et si Home Assistant ne veut pas lister ses scripts, rien n'est supprimé.

• Connecté à Home Assistant - connecté et répond. Si Home Assistant ne répond pas, la ligne vous dit de vérifier l'adresse et que votre téléphone est sur le même réseau.
• Projecteur ajouté à Home Assistant - indique si Home Assistant a déjà ce projecteur. Sinon, la ligne vous envoie ajouter l'intégration PJLink, et l'étape d'ajout d'intégration affiche l'hôte et le port PJLink que Home Assistant demande.
• Capteur de mesures enregistré - le capteur qui porte les mesures de votre projecteur. Il s'enregistre la première fois que l'appli lit le projecteur, et la ligne propose Enregistrer maintenant ou Activer quand quelque chose l'en empêche.
• Ce que contient votre Home Assistant - HACS (la boutique communautaire), l'intégration Epson Projector Link, l'intégration PJLink et les commandes Projector Pilot dans configuration.yaml. Chacun affiche Trouvé, Non installé ou Impossible de savoir, avec des boutons Comment installer et Ouvrir dans HACS quand ils sont utiles.

• Les cartes intégrées d'abord. Si vous n'avez aucune carte communautaire, Sync construit votre tableau de bord avec les cartes intégrées de Home Assistant et vous le dit à la fin. Cela fonctionne dès le départ.
• Amélioré quand des cartes HACS sont installées. L'appli vérifie lesquelles des cartes communautaires (Mushroom, button-card, card-mod, apexcharts-card) sont installées et remplace chaque carte par la version plus riche quand vous l'avez. Le guide du tableau de bord fait main va plus loin si vous voulez le look verre vert complet.
• Les scènes et commandes demandent un seul collage. Si Home Assistant n'a pas encore de commande pour envoyer au projecteur, le tableau de bord est quand même construit avec les mesures en direct, et une carte Terminer la configuration vous guide : touchez Copier le bloc, collez-le dans configuration.yaml, redémarrez Home Assistant, puis touchez Sync à nouveau.
• Rien d'installé ? Collez à la main. Si rien n'est installé dans Home Assistant, vous pouvez quand même tout copier depuis l'appli et le coller vous-même.
• Un mot de passe est signalé. Le bloc de commande que vous collez indique quand il contient un mot de passe de projecteur, pour que vous le sachiez avant de le partager ou de le stocker.

• C'est un bloc facultatif de plus : collez-le à la fin de configuration.yaml (ou ajoutez seulement ses lignes sous une section template: existante) et redémarrez Home Assistant. L'appli propose un bouton Vérifier qu'il est présent qui vous dit si Home Assistant l'a.
• Une extinction arrive désormais dans Home Assistant comme off, donc le tableau de bord et vos automatisations voient le projecteur comme éteint quand il l'est.

• Les automatisations peuvent les exécuter. « Au coucher du soleil, si la TV s'allume, lancer Movie Night » est une automatisation Home Assistant tout à fait normale une fois la scène devenue un script.
• Les assistants vocaux peuvent les exécuter. Exposez un script à votre assistant et « allume Movie Night » règle l'entrée, le mode d'image et la mémoire d'objectif ensemble.
• Seules vos vraies commandes apparaissent. L'appli écrit un script pour chaque entrée, mode couleur et mémoire d'objectif que le projecteur signale, et non une liste générique devinée.
• Retirer la synchronisation ne retire que ce que l'appli a écrit. Désactivez la synchronisation, ou utilisez Supprimer les scripts orphelins (qui les liste et demande d'abord), et Projector Pilot supprime les scripts qu'il a créés et rien d'autre.

Le tableau de bord

Sync construit le tableau de bord pour vous

Vous n'avez pas à construire une vue Lovelace à la main, et vous n'avez plus à en coller une non plus. Quand vous touchez Sync With HA, l'appli construit un tableau de bord Projector Pilot complet directement dans Home Assistant via sa propre API : l'état en direct du projecteur et un bouton pour chaque scène et commande synchronisée. Il apparaît dans la barre latérale de Home Assistant sous le nom Projector Pilot - ouvrez-le et c'est fini.

1. Connectez-vous à Home Assistant dans l'appli.
2. Collez une fois le bloc Copier de l'appli dans configuration.yaml et redémarrez Home Assistant (la seule étape manuelle - Home Assistant ne permet pas aux applis d'ajouter cette commande à distance).
3. Touchez Sync With HA. Le tableau de bord est construit pour vous et apparaît dans la barre latérale sous le nom Projector Pilot.

Qu'il soit construit pour vous ou que vous le colliez, le tableau de bord est le même - une carte d'état plus un bouton pour chaque commande (extrait illustratif) :

views:
  - title: Projector
    cards:
      - type: entity
        entity: sensor.projector_pilot_epson_qb1000b_qb1000w
        name: Projector
      - type: button
        name: Power On
        tap_action:
          action: perform-action
          perform_action: script.turn_on
          target:
            entity_id: script.projector_pilot_power_on
      - type: button
        name: Movie Night
        tap_action:
          action: perform-action
          perform_action: script.turn_on
          target:
            entity_id: script.projector_pilot_scene_movie_night

Exemple uniquement. Votre tableau de bord porte la vraie entité de votre projecteur et vos propres scènes.

1. Dans Hubitat, activez l'application Maker API, notez son URL d'accès et son jeton, et choisissez les appareils qu'elle expose.
2. Dans Projector Pilot, ouvrez Réglages › Domotique › Hubitat et saisissez les informations Maker API de votre hub.
3. Choisissez l'appareil qui représente le projecteur. L'appli suggère le plus probable ; sélectionnez-le ou choisissez le vôtre.
4. L'appli reflète l'alimentation, la sourdine et l'entrée sur cet appareil, en n'envoyant que les commandes que l'appareil accepte.
5. Créez des règles Rule Machine sur cet appareil comme pour n'importe quel autre - c'est l'état du projecteur qui les pilote.

1. Ouvrez Réglages › Domotique › Webhooks.
2. Saisissez l'URL vers laquelle envoyer. Un webhook Home Assistant ressemble à http://homeassistant.local:8123/api/webhook/your-id.
3. Choisissez les événements qui déclenchent le webhook : allumage, extinction, changement d'entrée, rappel de scène - et filtrez éventuellement sur une entrée ou une scène précise.
4. Définissez éventuellement une charge personnalisée si le service récepteur attend une forme particulière ; sinon l'appli envoie son JSON par défaut.
5. Enregistrez. L'appli envoie une requête à chaque événement correspondant à partir de là.

La charge par défaut est du JSON simple - un événement, le projecteur et la valeur qui a changé :

{
  "event": "scene_recalled",
  "projector": "Epson QB1000B/QB1000W",
  "scene": "Movie Night",
  "power": "on",
  "input": "HDMI1",
  "color_mode": "Cinema",
  "timestamp": "2026-09-23T20:14:07Z"
}

Exemple de charge. Un événement de changement d'entrée ou d'alimentation contient les champs qui le concernent.