Seu projetor, no Home Assistant e no Hubitat.

• Ela publica o estado. O projetor aparece como um sensor do Home Assistant, um dispositivo do Hubitat ou um payload JSON no seu webhook, com as mesmas leituras que o app mostra.
• Ela publica controles. Cada Cena que você salva, mais energia, cada entrada, cada modo de cor e cada memória de lente, vira algo que uma automação ou um assistente de voz pode executar.
• Ela roda sem servidor. Depois que os scripts estão configurados, o Home Assistant envia comandos direto para o endereço IP do projetor. Seu celular não precisa estar na rede, e nada passa por uma conta na nuvem.

Três caminhos, um hub

Configurações › Automação Residencial é o hub. Escolha a plataforma que você usa - Home Assistant, Hubitat ou Webhooks - e configure por lá. Você pode ligar mais de uma ao mesmo tempo; elas são independentes.

1. Abra Configurações › Automação Residencial › Home Assistant.
2. Digite o endereço do seu Home Assistant (por exemplo http://homeassistant.local:8123 ou o IP dele), depois toque em Entrar. É um login pelo navegador na sua própria instância - não há token para colar. Use seu login normal do Home Assistant, com verificação em duas etapas e tudo.
3. O app publica o projetor como um sensor, com uma entidade como sensor.projector_pilot_epson_qb1000b_qb1000w, com energia, entrada, modo de cor, os valores de imagem e as horas da lâmpada.
4. Ative Enviar o estado do projetor para que essas leituras sejam atualizadas no Home Assistant sempre que mudarem enquanto o app estiver aberto, e ative Sincronizar Controles Avançados para publicar scripts de modos de imagem, entradas, memórias de lente e energia.
5. Cole o bloco shell_command (abaixo) no seu configuration.yaml, reinicie o Home Assistant e toque em Sincronizar com HA.

O bloco shell_command

Este é o truque inteiro do modo sem servidor. O app escreve um comando que o Home Assistant executa para conversar com o Web Control do projetor, e cada script que ele sincroniza chama esse comando com um verbo diferente. Toque em Copiar bloco no app e cole em configuration.yaml. O exemplo abaixo é ilustrativo - o app preenche o endereço e o nome de comando do seu próprio projetor:

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

Apenas exemplo. O app gera o seu com o IP real do projetor e um nome derivado do número de série.

Testar Conexão, Sincronizar e limpeza

• Testar Conexão verifica se o app consegue alcançar o seu Home Assistant e se o shell_command colado está mesmo lá, para você achar um erro de digitação antes de construir qualquer coisa em cima dele.
• Sincronizar com HA escreve ou atualiza os scripts das suas Cenas e controles, e monta um painel pronto do Projector Pilot direto no Home Assistant. Execute de novo sempre que adicionar uma Cena ou mudar um controle - ele atualiza no lugar em vez de acumular duplicatas.
• Remover scripts órfãos encontra scripts que o app escreveu e que não têm mais uma Cena ou controle correspondente - por exemplo depois que você apaga uma Cena - lista exatamente quais vai remover e pergunta antes. Nada é apagado até você confirmar. Ele só mexe em scripts criados pelo Projector Pilot; nada mais no seu Home Assistant é perturbado, e se o Home Assistant não listar seus scripts, nada é removido.

• Conectado ao Home Assistant - logado e respondendo. Se o Home Assistant não responder, a linha diz para conferir o endereço e se o celular está na mesma rede.
• Projetor adicionado ao Home Assistant - se o Home Assistant já tem este projetor. Se não tiver, a linha leva você a adicionar a integração PJLink, e o passo de adicionar a integração mostra o host e a porta do PJLink que o Home Assistant pede.
• Sensor de leituras registrado - o sensor que carrega as leituras do seu projetor. Ele é registrado na primeira vez que o app lê o projetor, e a linha oferece Registrar agora ou Ativar quando algo o impede.
• O que o seu Home Assistant tem - HACS (a loja da comunidade), a integração Epson Projector Link, a integração PJLink e os comandos do Projector Pilot em configuration.yaml. Cada um mostra Encontrado, Não instalado ou Não foi possível saber, com botões Como instalar e Abrir no HACS quando ajudam.

• Cartões nativos primeiro. Se você não tem cartões da comunidade, a sincronização monta seu painel com os cartões nativos do Home Assistant e avisa ao terminar. Funciona de cara.
• Atualizado quando há cartões do HACS instalados. O app verifica quais cartões da comunidade (Mushroom, button-card, card-mod, apexcharts-card) estão instalados e atualiza cada cartão para o mais rico onde você o tiver. O guia do painel feito à mão vai além se você quiser o visual completo de vidro verde.
• Cenas e controles precisam de uma colagem. Se o Home Assistant ainda não tem um comando para enviar ao projetor, o painel é montado mesmo assim com leituras ao vivo, e um cartão Concluir configuração guia você: toque em Copiar bloco, cole em configuration.yaml, reinicie o Home Assistant e toque em Sincronizar de novo.
• Nada instalado? Cole manualmente. Se nada estiver instalado no Home Assistant, você ainda pode copiar tudo do app e colar por conta própria.
• Uma senha é sinalizada. O bloco de comando que você cola avisa quando carrega uma senha do projetor, para você saber antes de compartilhar ou guardar.

• É mais um bloco opcional: cole no final de configuration.yaml (ou adicione apenas as linhas dele sob uma seção template: existente) e reinicie o Home Assistant. O app tem um botão Verificar se está lá que diz se o Home Assistant o tem.
• Um desligamento agora chega ao Home Assistant como off, então o painel e suas automações veem o projetor como desligado quando ele está.

• Automações podem executá-las. "Ao pôr do sol, se a TV ligar, executar Noite de Cinema" é uma automação normal do Home Assistant depois que a Cena é um script.
• Assistentes de voz podem executá-las. Exponha um script ao seu assistente e "ligar Noite de Cinema" define a entrada, o modo de imagem e a memória de lente juntos.
• Só aparecem seus controles reais. O app escreve um script para cada entrada, modo de cor e memória de lente que o projetor informa - não uma lista genérica que ele chutou.
• Remover a sincronização remove só o que o app escreveu. Desative a sincronização, ou use Remover scripts órfãos (que lista e pergunta antes), e o Projector Pilot apaga os scripts que criou e nada mais.

O painel

A sincronização monta o painel para você

Você não precisa montar uma visão Lovelace à mão, e também não precisa mais colar uma. Quando você toca em Sincronizar com HA, o app monta um painel completo do Projector Pilot direto no Home Assistant pela API dele: o estado ao vivo do projetor e um botão para cada Cena e controle sincronizado. Ele aparece na barra lateral do Home Assistant como Projector Pilot - abra e pronto.

1. Entre no Home Assistant pelo app.
2. Cole o bloco Copiar do app em configuration.yaml uma vez e reinicie o Home Assistant (o único passo manual - o Home Assistant não deixa apps adicionarem esse comando remotamente).
3. Toque em Sincronizar com HA. O painel é montado para você e aparece na barra lateral como Projector Pilot.

Seja montado para você ou colado por você, o painel é o mesmo - um cartão de estado mais um botão para cada controle (trecho ilustrativo):

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

Apenas exemplo. Seu painel traz a entidade real do seu projetor e as suas próprias Cenas.

1. No Hubitat, ative o app Maker API, anote a URL de acesso e o token dele, e escolha quais dispositivos ele expõe.
2. No Projector Pilot, abra Configurações › Automação Residencial › Hubitat e digite os dados da Maker API do seu hub.
3. Escolha o dispositivo que representa o projetor. O app sugere o mais provável; escolha-o ou selecione o seu.
4. O app espelha energia, mudo e entrada nesse dispositivo, enviando apenas os comandos que o dispositivo aceita.
5. Crie regras do Rule Machine para esse dispositivo como faria com qualquer outro - o estado do projetor as aciona.

1. Abra Configurações › Automação Residencial › Webhooks.
2. Digite a URL para onde enviar. Um webhook do Home Assistant tem este formato: http://homeassistant.local:8123/api/webhook/your-id.
3. Escolha quais eventos disparam o webhook: ligar, desligar, mudança de entrada, recuperar Cena - e, se quiser, filtre por uma entrada ou Cena específica.
4. Se quiser, defina um payload personalizado caso o serviço receptor queira um formato específico; caso contrário o app envia o JSON padrão.
5. Salve. O app envia a cada evento correspondente a partir de então.

O payload padrão é JSON simples - um evento, o projetor e o valor que mudou:

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

Payload de exemplo. Um evento de mudança de entrada ou de energia traz os campos relevantes para ele.