Dein Projektor, in Home Assistant und Hubitat.

• Es veröffentlicht den Status. Der Projektor erscheint als Home Assistant Sensor, als Hubitat-Gerät oder als JSON-Payload an deinem Webhook und trägt dieselben Messwerte, die dir die App zeigt.
• Es veröffentlicht Steuerungen. Jede Szene, die du speicherst, sowie Ein/Aus, jeder Eingang, jeder Farbmodus und jeder Objektivspeicher wird zu etwas, das eine Automation oder ein Sprachassistent ausführen kann.
• Es läuft serverlos. Sobald die Skripte eingerichtet sind, sendet Home Assistant Befehle direkt an die IP-Adresse des Projektors. Dein Handy muss nicht im Netzwerk sein, und nichts läuft über ein Cloud-Konto.

Drei Wege hinein, ein Hub

Einstellungen › Hausautomation ist der Hub. Wähle die Plattform, die du nutzt - Home Assistant, Hubitat oder Webhooks - und richte sie dort ein. Du kannst mehrere gleichzeitig einrichten; sie sind voneinander unabhängig.

1. Öffne Einstellungen › Hausautomation › Home Assistant.
2. Gib deine Home Assistant Adresse ein (zum Beispiel http://homeassistant.local:8123 oder seine IP) und tippe dann auf Anmelden. Es ist eine Browser-Anmeldung bei deiner eigenen Instanz - du musst kein Token einfügen. Nutze deine normale Home Assistant Anmeldung samt Zwei-Faktor-Authentifizierung.
3. Die App veröffentlicht den Projektor als Sensor mit einer Entity wie sensor.projector_pilot_epson_qb1000b_qb1000w, die Ein/Aus, Eingang, Farbmodus, die Bildwerte und die Lampenstunden trägt.
4. Aktiviere Projektorstatus senden, damit diese Messwerte in Home Assistant aktualisiert werden, sobald sie sich ändern, solange die App geöffnet ist, und aktiviere Erweiterte Steuerungen synchronisieren, um Skripte für Bildmodi, Eingänge, Objektivspeicher und Ein/Aus zu veröffentlichen.
5. Füge den einen shell_command-Block (unten) in deine configuration.yaml ein, starte Home Assistant neu und tippe dann auf Mit HA synchronisieren.

Der shell_command-Block

Das ist der ganze Serverlos-Trick. Die App schreibt einen Befehl, den Home Assistant ausführt, um mit Web Control des Projektors zu sprechen, und jedes synchronisierte Skript ruft diesen Befehl mit einem anderen Verb auf. Tippe in der App auf Copy-Block kopieren und füge ihn in configuration.yaml ein. Das Beispiel unten dient nur der Veranschaulichung - die App trägt die eigene Adresse und den Befehlsnamen deines Projektors ein:

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

Nur ein Beispiel. Die App erzeugt deinen Block mit der echten IP des Projektors und einem von seiner Seriennummer abgeleiteten Namen.

Verbindung testen, Sync und Aufräumen

• Verbindung testen prüft, ob die App dein Home Assistant erreicht und ob der eingefügte shell_command tatsächlich vorhanden ist, damit du einen Tippfehler findest, bevor du etwas darauf aufbaust.
• Mit HA synchronisieren schreibt oder aktualisiert die Skripte für deine Szenen und Steuerungen und baut direkt in Home Assistant ein fertiges Projector Pilot Dashboard. Führe es jederzeit erneut aus, wenn du eine Szene hinzufügst oder eine Steuerung änderst - es aktualisiert an Ort und Stelle, statt Duplikate anzuhäufen.
• Verwaiste Skripte entfernen findet Skripte, die die App geschrieben hat und zu denen es keine passende Szene oder Steuerung mehr gibt - zum Beispiel nach dem Löschen einer Szene -, listet genau auf, welche es entfernen wird, und fragt vorher nach. Nichts wird gelöscht, bevor du bestätigst. Es berührt nur Skripte, die Projector Pilot erstellt hat; nichts anderes in deinem Home Assistant wird angefasst, und wenn Home Assistant seine Skripte nicht auflistet, wird nichts entfernt.

• Mit Home Assistant verbunden - angemeldet und antwortend. Antwortet Home Assistant nicht, rät die Zeile, die Adresse zu prüfen und ob dein Handy im selben Netzwerk ist.
• Projektor zu Home Assistant hinzugefügt - ob Home Assistant diesen Projektor schon hat. Falls nicht, schickt dich die Zeile zum Hinzufügen der PJLink-Integration, und der Schritt zum Hinzufügen zeigt den PJLink-Host und -Port, nach denen Home Assistant fragt.
• Messwert-Sensor registriert - der Sensor, der die Messwerte deines Projektors trägt. Er wird registriert, wenn die App den Projektor zum ersten Mal liest, und die Zeile bietet Jetzt registrieren oder Einschalten an, wenn etwas das verhindert.
• Was dein Home Assistant hat - HACS (der Community-Store), die Epson-Projector-Link-Integration, die PJLink-Integration und die Projector Pilot Befehle in configuration.yaml. Jede zeigt Gefunden, Nicht installiert oder Nicht feststellbar, mit den Schaltflächen So installierst du und In HACS öffnen, wo sie helfen.

• Zuerst die integrierten Karten. Hast du keine Community-Karten, baut Sync dein Dashboard mit den integrierten Karten von Home Assistant und sagt es dir, wenn es fertig ist. Es funktioniert sofort.
• Aufgerüstet, wenn HACS-Karten installiert sind. Die App prüft, welche der Community-Karten (Mushroom, button-card, card-mod, apexcharts-card) installiert sind, und rüstet jede Karte auf die aufwendigere um, wo du sie hast. Die Anleitung für das selbst gebaute Dashboard geht weiter, wenn du den vollen Green-Glass-Look möchtest.
• Szenen und Steuerungen brauchen das eine Einfügen. Hat Home Assistant noch keinen Befehl zum Senden an den Projektor, wird das Dashboard trotzdem mit Live-Messwerten gebaut, und eine Karte Einrichtung abschließen führt dich durch: Tippe auf Copy-Block kopieren, füge ihn in configuration.yaml ein, starte Home Assistant neu und tippe dann erneut auf Sync.
• Nichts installiert? Von Hand einfügen. Ist in Home Assistant nichts installiert, kannst du trotzdem alles aus der App kopieren und selbst einfügen.
• Ein Passwort wird kenntlich gemacht. Der Befehlsblock, den du einfügst, sagt, wenn er ein Projektorpasswort enthält, damit du es weißt, bevor du ihn teilst oder speicherst.

• Es ist ein weiterer optionaler Block: Füge ihn am Ende von configuration.yaml ein (oder nur seine Zeilen unter einem bestehenden Abschnitt template:) und starte Home Assistant neu. Die App hat eine Schaltfläche Prüfen, ob es da ist, die dir sagt, ob Home Assistant ihn hat.
• Ein Ausschalten erreicht Home Assistant jetzt als aus, sodass das Dashboard und deine Automationen den Projektor als ausgeschaltet sehen, wenn er es ist.

• Automationen können sie ausführen. „Bei Sonnenuntergang, wenn der TV angeht, starte Filmabend“ ist eine ganz normale Home Assistant Automation, sobald die Szene ein Skript ist.
• Sprachassistenten können sie ausführen. Gib ein Skript für deinen Assistenten frei, und „Filmabend einschalten“ setzt Eingang, Bildmodus und Objektivspeicher zusammen.
• Es erscheinen nur deine echten Steuerungen. Die App schreibt ein Skript für jeden Eingang, Farbmodus und Objektivspeicher, den der Projektor meldet - nicht eine allgemeine Liste, die sie erraten hat.
• Das Entfernen der Synchronisierung entfernt nur, was die App geschrieben hat. Schalte die Synchronisierung aus oder nutze Verwaiste Skripte entfernen (listet sie auf und fragt vorher nach), und Projector Pilot löscht die Skripte, die es erstellt hat, und sonst nichts.

Das Dashboard

Sync baut das Dashboard für dich

Du musst keine Lovelace-Ansicht von Hand bauen und musst auch keine mehr einfügen. Wenn du auf Mit HA synchronisieren tippst, baut die App über die eigene API direkt in Home Assistant ein komplettes Projector Pilot Dashboard: den Live-Status des Projektors und eine Schaltfläche für jede Szene und Steuerung, die sie synchronisiert hat. Es erscheint in der Seitenleiste von Home Assistant als Projector Pilot - öffne es, und es ist erledigt.

1. Melde dich in der App bei Home Assistant an.
2. Füge den Copy-Block der App einmal in configuration.yaml ein und starte Home Assistant neu (der eine manuelle Schritt - Home Assistant erlaubt Apps nicht, diesen Befehl aus der Ferne hinzuzufügen).
3. Tippe auf Mit HA synchronisieren. Das Dashboard wird für dich gebaut und erscheint in der Seitenleiste als Projector Pilot.

Ob es für dich gebaut oder von dir eingefügt wird, das Dashboard ist dasselbe - eine Statuskarte plus eine Schaltfläche für jede Steuerung (veranschaulichender Ausschnitt):

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

Nur ein Beispiel. Dein Dashboard trägt die echte Entity deines Projektors und deine eigenen Szenen.

1. Aktiviere in Hubitat die App Maker API, notiere ihre Zugriffs-URL und das Token und wähle, welche Geräte sie freigibt.
2. Öffne in Projector Pilot Einstellungen › Hausautomation › Hubitat und gib die Details der Maker API deines Hubs ein.
3. Wähle das Gerät, das für den Projektor steht. Die App schlägt das wahrscheinlichste vor; nimm es oder wähle dein eigenes.
4. Die App spiegelt Ein/Aus, Stummschaltung und Eingang auf dieses Gerät und sendet nur die Befehle, die das Gerät annimmt.
5. Baue Rule Machine-Regeln für dieses Gerät, wie für jedes andere auch - der Status des Projektors steuert sie.

1. Öffne Einstellungen › Hausautomation › Webhooks.
2. Gib die URL ein, an die gesendet werden soll. Ein Home Assistant Webhook sieht so aus: http://homeassistant.local:8123/api/webhook/your-id.
3. Wähle, welche Ereignisse den Webhook auslösen: Einschalten, Ausschalten, Eingangswechsel, Szenenabruf - und filtere optional auf einen bestimmten Eingang oder eine bestimmte Szene.
4. Lege optional eine eigene Payload fest, falls der empfangende Dienst eine bestimmte Form verlangt; andernfalls sendet die App ihr Standard-JSON.
5. Speichern. Die App sendet ab dann bei jedem passenden Ereignis.

Die Standard-Payload ist schlichtes JSON - ein Ereignis, der Projektor und der Wert, der sich geändert hat:

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

Beispiel-Payload. Ein Eingangswechsel- oder Ein/Aus-Ereignis trägt die dafür relevanten Felder.