Il tuo proiettore, in Home Assistant e Hubitat.

• Pubblica lo stato. Il proiettore compare come sensore Home Assistant, dispositivo Hubitat o payload JSON sul tuo webhook, con le stesse letture che ti mostra l'app.
• Pubblica i comandi. Ogni Scena che salvi, più accensione, ogni ingresso, ogni modalità colore e ogni memoria obiettivo, diventa qualcosa che un'automazione o un assistente vocale può eseguire.
• Funziona senza server. Una volta configurati gli script, Home Assistant invia i comandi direttamente all'indirizzo IP del proiettore. Il telefono non deve essere in rete e nulla passa da un account cloud.

Tre strade, un solo hub

Impostazioni › Automazione domestica è l'hub. Scegli la piattaforma che usi (Home Assistant, Hubitat o Webhook) e configurala da lì. Puoi collegarne più di una alla volta; sono indipendenti.

1. Apri Impostazioni › Automazione domestica › Home Assistant.
2. Digita l'indirizzo di Home Assistant (per esempio http://homeassistant.local:8123 o il suo IP), poi tocca Accedi. È un accesso tramite browser sulla tua istanza: nessun token da incollare. Usa il tuo normale login di Home Assistant, autenticazione a due fattori compresa.
3. L'app pubblica il proiettore come sensore, con un'entità come sensor.projector_pilot_epson_qb1000b_qb1000w, che riporta accensione, ingresso, modalità colore, valori dell'immagine e ore lampada.
4. Attiva Invia lo stato del proiettore perché queste letture si aggiornino in Home Assistant a ogni cambiamento mentre l'app è aperta, e attiva Sincronizza comandi avanzati per pubblicare gli script per modalità immagine, ingressi, memorie obiettivo e accensione.
5. Incolla l'unico blocco shell_command (qui sotto) nel tuo configuration.yaml, riavvia Home Assistant, poi tocca Sync With HA.

Il blocco shell_command

Questo è tutto il trucco del funzionamento senza server. L'app scrive un comando che Home Assistant esegue per parlare con il Web Control del proiettore, e ogni script sincronizzato richiama quel comando con un verbo diverso. Tocca Copia blocco nell'app e incollalo in configuration.yaml. L'esempio qui sotto è indicativo: l'app inserisce l'indirizzo e il nome del comando propri del tuo proiettore:

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

Solo un esempio. L'app genera il tuo con l'IP reale del proiettore e un nome derivato dal suo numero di serie.

Test connessione, sincronizzazione e pulizia

• Test connessione verifica che l'app raggiunga il tuo Home Assistant e che il shell_command incollato sia davvero presente, così scopri un errore di battitura prima di costruirci sopra qualcosa.
• Sync With HA scrive o aggiorna gli script per le tue Scene e i tuoi comandi, e costruisce una dashboard Projector Pilot già pronta direttamente in Home Assistant. Eseguilo di nuovo ogni volta che aggiungi una Scena o cambi un comando: si aggiorna sul posto senza accumulare duplicati.
• Rimuovi script orfani trova gli script scritti dall'app che non hanno più una Scena o un comando corrispondente, per esempio dopo aver eliminato una Scena, elenca esattamente quali rimuoverà e chiede prima conferma. Non viene eliminato nulla finché non confermi. Tocca solo gli script creati da Projector Pilot; il resto del tuo Home Assistant resta intatto, e se Home Assistant non elenca i suoi script, non viene rimosso nulla.

• Connesso a Home Assistant - accesso effettuato e risposta ricevuta. Se Home Assistant non risponde, la riga ti invita a controllare l'indirizzo e che il telefono sia sulla stessa rete.
• Proiettore aggiunto a Home Assistant - indica se Home Assistant ha già questo proiettore. Se non lo ha, la riga ti porta ad aggiungere l'integrazione PJLink, e il passaggio di aggiunta mostra l'host e la porta PJLink richiesti da Home Assistant.
• Sensore delle letture registrato - il sensore che riporta le letture del tuo proiettore. Si registra la prima volta che l'app legge il proiettore, e la riga offre Registra ora o Attiva quando qualcosa lo impedisce.
• Cosa ha il tuo Home Assistant - HACS (lo store della community), l'integrazione Epson Projector Link, l'integrazione PJLink e i comandi Projector Pilot in configuration.yaml. Ognuno mostra Trovato, Non installato o Impossibile stabilirlo, con i pulsanti Come installare e Apri in HACS dove servono.

• Prima le schede integrate. Se non hai schede della community, Sync costruisce la dashboard con le schede integrate di Home Assistant e te lo dice al termine. Funziona subito, senza altro.
• Potenziata se sono installate le schede HACS. L'app controlla quali schede della community (Mushroom, button-card, card-mod, apexcharts-card) sono installate e potenzia ogni scheda con quella più ricca dove ce l'hai. La guida alla dashboard fatta a mano va oltre, se vuoi l'aspetto completo in vetro verde.
• Scene e comandi richiedono un solo incolla. Se Home Assistant non ha ancora un comando per inviare al proiettore, la dashboard viene comunque costruita con le letture in tempo reale, e una scheda Completa la configurazione ti guida: tocca Copia blocco, incollalo in configuration.yaml, riavvia Home Assistant, poi tocca di nuovo Sync.
• Niente installato? Incolla a mano. Se in Home Assistant non c'è nulla di installato, puoi comunque copiare tutto dall'app e incollarlo tu.
• Una password viene segnalata. Il blocco di comando che incolli indica quando contiene una password del proiettore, così lo sai prima di condividerlo o conservarlo.

• È un altro blocco facoltativo: incollalo in fondo a configuration.yaml (o aggiungi solo le sue righe sotto una sezione template: esistente) e riavvia Home Assistant. L'app ha un pulsante Controlla che sia presente che ti dice se Home Assistant lo ha.
• Uno spegnimento ora arriva a Home Assistant come off, quindi la dashboard e le tue automazioni vedono il proiettore spento quando lo è davvero.

• Le automazioni possono eseguirle. "Al tramonto, se la TV si accende, esegui Serata cinema" è una normale automazione di Home Assistant una volta che la Scena è uno script.
• Gli assistenti vocali possono eseguirle. Esponi uno script al tuo assistente e "accendi Serata cinema" imposta insieme ingresso, modalità immagine e memoria obiettivo.
• Compaiono solo i tuoi comandi reali. L'app scrive uno script per ogni ingresso, modalità colore e memoria obiettivo che il proiettore comunica, non un elenco generico tirato a indovinare.
• Disattivare la sincronizzazione rimuove solo ciò che ha scritto l'app. Disattiva la sincronizzazione, oppure usa Rimuovi script orfani (che li elenca e chiede prima), e Projector Pilot elimina gli script che ha creato e nient'altro.

La Dashboard

Sync costruisce la dashboard per te

Non devi costruire a mano una vista Lovelace, e non devi nemmeno più incollarne una. Quando tocchi Sync With HA, l'app costruisce una dashboard Projector Pilot completa direttamente in Home Assistant tramite la sua API: lo stato in tempo reale del proiettore e un pulsante per ogni Scena e comando sincronizzati. Compare nella barra laterale di Home Assistant come Projector Pilot: aprila ed è fatta.

1. Accedi a Home Assistant nell'app.
2. Incolla una sola volta il blocco Copia dell'app in configuration.yaml e riavvia Home Assistant (l'unico passaggio manuale: Home Assistant non permette alle app di aggiungere quel comando da remoto).
3. Tocca Sync With HA. La dashboard viene costruita per te e compare nella barra laterale come Projector Pilot.

Che sia costruita per te o incollata da te, la dashboard è la stessa: una scheda di stato più un pulsante per ogni comando (frammento illustrativo):

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

Solo un esempio. La tua dashboard riporta l'entità reale del tuo proiettore e le tue Scene.

1. In Hubitat, abilita l'app Maker API, annota il suo URL di accesso e il token, e scegli quali dispositivi espone.
2. In Projector Pilot, apri Impostazioni › Automazione domestica › Hubitat e inserisci i dati Maker API del tuo hub.
3. Scegli il dispositivo che rappresenta il proiettore. L'app suggerisce quello più probabile; sceglilo oppure seleziona il tuo.
4. L'app rispecchia accensione, muto e ingresso su quel dispositivo, inviando solo i comandi che il dispositivo accetta.
5. Crea regole Rule Machine su quel dispositivo come faresti con qualsiasi altro: è lo stato del proiettore a guidarle.

1. Apri Impostazioni › Automazione domestica › Webhook.
2. Inserisci l'URL a cui inviare. Un webhook di Home Assistant ha questo aspetto: http://homeassistant.local:8123/api/webhook/your-id.
3. Scegli quali eventi attivano il webhook: accensione, spegnimento, cambio ingresso, richiamo di una Scena, e se vuoi filtra su un ingresso o una Scena specifici.
4. Se vuoi, imposta un payload personalizzato nel caso il servizio ricevente richieda una forma particolare; altrimenti l'app invia il suo JSON predefinito.
5. Salva. Da quel momento l'app invia i dati a ogni evento corrispondente.

Il payload predefinito è semplice JSON: un evento, il proiettore e il valore cambiato:

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

Payload di esempio. Un evento di cambio ingresso o di accensione riporta i campi pertinenti.