Je projector, in Home Assistant en Hubitat.

• Het publiceert de status. De projector verschijnt als Home Assistant-sensor, als Hubitat-apparaat of als JSON-payload op je webhook, met dezelfde waarden die de app je toont.
• Het publiceert bediening. Elke scène die je opslaat, plus voeding, elke bron, elke kleurmodus en elk lensgeheugen, wordt iets wat een automatisering of een spraakassistent kan uitvoeren.
• Het werkt serverloos. Zodra de scripts zijn ingesteld, stuurt Home Assistant commando's rechtstreeks naar het IP-adres van de projector. Je telefoon hoeft niet op het netwerk te zijn en er loopt niets via een cloudaccount.

Drie wegen naar binnen, één hub

Instellingen › Domotica is de hub. Kies het platform dat je gebruikt - Home Assistant, Hubitat of webhooks - en stel het daar in. Je kunt er meerdere tegelijk koppelen; ze zijn onafhankelijk van elkaar.

1. Open Instellingen › Domotica › Home Assistant.
2. Typ je Home Assistant-adres (bijvoorbeeld http://homeassistant.local:8123 of het IP-adres) en tik op Aanmelden. Het is een browseraanmelding bij je eigen instantie - er is geen token om te plakken. Gebruik je gewone Home Assistant-login, inclusief tweestapsverificatie.
3. De app publiceert de projector als sensor, met een entity zoals sensor.projector_pilot_epson_qb1000b_qb1000w, met voeding, bron, kleurmodus, de beeldwaarden en lampuren.
4. Schakel Status van de projector verzenden in zodat die waarden in Home Assistant worden bijgewerkt telkens als ze veranderen terwijl de app open is, en schakel Sync Advanced Controls in om scripts te publiceren voor beeldmodi, bronnen, lensgeheugens en voeding.
5. Plak het ene shell_command-blok (hieronder) in je configuration.yaml, start Home Assistant opnieuw en tik dan op Sync With HA.

Het shell_command-blok

Dit is de hele serverloze truc. De app schrijft één commando dat Home Assistant uitvoert om met de Web Control van de projector te praten, en elk script dat hij synchroniseert roept dat commando aan met een ander werkwoord. Tik in de app op Copy block en plak het in configuration.yaml. Het voorbeeld hieronder is ter illustratie - de app vult het eigen adres en de commandonaam van je projector in:

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 }}"

Alleen een voorbeeld. De app genereert het jouwe met het echte IP-adres van de projector en een naam afgeleid van het serienummer.

Verbinding testen, Sync en opruimen

• Verbinding testen controleert of de app je Home Assistant kan bereiken en of de geplakte shell_command er echt staat, zodat je een typefout vindt voordat je er iets bovenop bouwt.
• Sync With HA schrijft of werkt de scripts voor je scènes en bediening bij, en bouwt een kant-en-klaar Projector Pilot-dashboard rechtstreeks in Home Assistant. Voer het opnieuw uit zodra je een scène toevoegt of een bediening wijzigt - het werkt ter plekke bij in plaats van duplicaten op te stapelen.
• Verweesde scripts verwijderen vindt scripts die de app heeft geschreven en waarvoor geen scène of bediening meer bestaat - bijvoorbeeld nadat je een scène hebt verwijderd - toont precies welke het gaat verwijderen en vraagt eerst bevestiging. Er wordt niets verwijderd voordat je bevestigt. Het raakt alleen scripts aan die Projector Pilot heeft gemaakt; niets anders in je Home Assistant wordt verstoord, en als Home Assistant zijn scripts niet wil tonen, wordt er niets verwijderd.

• Verbonden met Home Assistant - aangemeld en antwoordend. Antwoordt Home Assistant niet, dan zegt de rij dat je het adres moet controleren en moet nagaan of je telefoon op hetzelfde netwerk zit.
• Projector toegevoegd aan Home Assistant - of Home Assistant deze projector al heeft. Zo niet, dan stuurt de rij je naar het toevoegen van de PJLink-integratie, en de stap voor het toevoegen van de integratie toont de PJLink-host en -poort waar Home Assistant om vraagt.
• Waardesensor geregistreerd - de sensor die de waarden van je projector bevat. Hij wordt geregistreerd zodra de app de projector voor het eerst leest, en de rij biedt Nu registreren of Inschakelen aan als er iets in de weg zit.
• Wat je Home Assistant heeft - HACS (de community store), de Epson Projector Link-integratie, de PJLink-integratie en de Projector Pilot-commando's in configuration.yaml. Elk toont Gevonden, Niet geïnstalleerd of Kon het niet bepalen, met knoppen Zo installeer je het en Openen in HACS waar die helpen.

• Eerst ingebouwde kaarten. Heb je geen community-kaarten, dan bouwt Sync je dashboard met de ingebouwde kaarten van Home Assistant en meldt dat als het klaar is. Het werkt direct.
• Geüpgraded wanneer HACS-kaarten zijn geïnstalleerd. De app controleert welke van de community-kaarten (Mushroom, button-card, card-mod, apexcharts-card) zijn geïnstalleerd en upgradet elke kaart naar de rijkere versie waar je die hebt. De gids voor het zelfgebouwde dashboard gaat verder als je de volledige groene glazen look wilt.
• Scènes en bediening hebben die ene plak-actie nodig. Heeft Home Assistant nog geen commando om naar de projector te sturen, dan wordt het dashboard toch gebouwd met live waarden en loodst een kaart Installatie afronden je erdoorheen: tik op Copy block, plak het in configuration.yaml, start Home Assistant opnieuw en tik weer op Sync.
• Niets geïnstalleerd? Plak met de hand. Is er niets geïnstalleerd in Home Assistant, dan kun je alles toch uit de app kopiëren en zelf plakken.
• Een wachtwoord wordt benoemd. Het commandoblok dat je plakt, meldt wanneer het een projectorwachtwoord bevat, zodat je dat weet voordat je het deelt of opslaat.

• Het is nog één optioneel blok: plak het aan het einde van configuration.yaml (of voeg alleen de regels ervan toe onder een bestaande template:-sectie) en start Home Assistant opnieuw. De app heeft een knop Controleren of het er is die vertelt of Home Assistant het heeft.
• Een uitschakeling bereikt Home Assistant nu als off, zodat het dashboard en je automatiseringen de projector als uit zien wanneer hij dat is.

• Automatiseringen kunnen ze uitvoeren. "Bij zonsondergang, als de TV aangaat, voer Filmavond uit" is een gewone Home Assistant-automatisering zodra de scène een script is.
• Spraakassistenten kunnen ze uitvoeren. Stel een script beschikbaar voor je assistent en "zet Filmavond aan" stelt de bron, de beeldmodus en het lensgeheugen tegelijk in.
• Alleen je echte bediening verschijnt. De app schrijft een script voor elke bron, kleurmodus en elk lensgeheugen dat de projector meldt - geen algemene lijst waar hij naar raadde.
• Sync verwijderen verwijdert alleen wat de app schreef. Schakel de sync uit, of gebruik Verweesde scripts verwijderen (dat ze toont en eerst vraagt), en Projector Pilot verwijdert de scripts die hij heeft gemaakt en niets anders.

Het dashboard

Sync bouwt het dashboard voor je

Je hoeft geen Lovelace-weergave met de hand te bouwen, en je hoeft er ook geen meer te plakken. Als je op Sync With HA tikt, bouwt de app via de eigen API van Home Assistant een compleet Projector Pilot-dashboard rechtstreeks in Home Assistant: de live status van de projector en een knop voor elke scène en bediening die hij heeft gesynchroniseerd. Het verschijnt in de zijbalk van Home Assistant als Projector Pilot - open het en je bent klaar.

1. Meld je in de app aan bij Home Assistant.
2. Plak het Copy block van de app één keer in configuration.yaml en start Home Assistant opnieuw (de enige handmatige stap - Home Assistant laat apps dat commando niet op afstand toevoegen).
3. Tik op Sync With HA. Het dashboard wordt voor je gebouwd en verschijnt in de zijbalk als Projector Pilot.

Of het nu voor je is gebouwd of je het zelf plakt, het dashboard is hetzelfde - een statuskaart plus een knop voor elke bediening (illustratief fragment):

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

Alleen een voorbeeld. Je dashboard bevat de echte entity van je projector en je eigen scènes.

1. Schakel in Hubitat de app Maker API in, noteer de toegangs-URL en het token, en kies welke apparaten hij beschikbaar stelt.
2. Open in Projector Pilot Instellingen › Domotica › Hubitat en voer de Maker API-gegevens van je hub in.
3. Kies het apparaat dat voor de projector staat. De app stelt het waarschijnlijke voor; kies dat of selecteer je eigen apparaat.
4. De app spiegelt voeding, mute en bron naar dat apparaat en stuurt alleen de commando's die het apparaat accepteert.
5. Bouw Rule Machine-regels op dat apparaat zoals bij elk ander apparaat - de status van de projector stuurt ze aan.

1. Open Instellingen › Domotica › Webhooks.
2. Voer de URL in waarnaar gepost moet worden. Een Home Assistant-webhook ziet eruit als http://homeassistant.local:8123/api/webhook/your-id.
3. Kies welke gebeurtenissen de webhook activeren: aanzetten, uitzetten, bronwissel, scène oproepen - en filter eventueel op een specifieke bron of scène.
4. Stel desgewenst een eigen payload in als de ontvangende dienst een bepaalde vorm wil; anders stuurt de app zijn standaard-JSON.
5. Sla op. Vanaf dan post de app bij elke overeenkomende gebeurtenis.

De standaardpayload is gewone JSON - een gebeurtenis, de projector en de waarde die veranderde:

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

Voorbeeldpayload. Een bronwissel of voedingsgebeurtenis bevat de velden die erbij horen.