O seu projetor, no Home Assistant e no Hubitat.

• 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 a app lhe mostra.
• Publica controlos. Cada Cena que guarda, mais energia, cada entrada, cada modo de cor e cada memória da lente, passa a ser algo que uma automação ou um assistente de voz pode executar.
• Funciona sem servidor. Depois de os scripts estarem configurados, o Home Assistant envia os comandos diretamente para o endereço IP do projetor. O telemóvel não precisa de estar na rede e nada passa por uma conta na nuvem.

Três entradas, um só centro

Definições › Automação doméstica é o centro. Escolha a plataforma que usa - Home Assistant, Hubitat ou Webhooks - e configure-a aí. Pode ligar mais do que uma em simultâneo; são independentes.

1. Abra Definições › Automação doméstica › Home Assistant.
2. Escreva o seu endereço do Home Assistant (por exemplo http://homeassistant.local:8123 ou o respetivo IP) e toque em Iniciar sessão. É um início de sessão no navegador, na sua própria instância - não há token para colar. Use o seu início de sessão normal do Home Assistant, com autenticação de dois fatores e tudo.
3. A 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 da imagem e as horas da lâmpada.
4. Ative Enviar o estado do projetor para que essas leituras se atualizem no Home Assistant sempre que mudam enquanto a app está aberta, e ative Sincronizar controlos avançados para publicar scripts para modos de imagem, entradas, memórias da lente e energia.
5. Cole o bloco shell_command (abaixo) no seu configuration.yaml, reinicie o Home Assistant e depois toque em Sincronizar com o HA.

O bloco shell_command

Este é todo o truque do funcionamento sem servidor. A app escreve um comando que o Home Assistant executa para falar com o Web Control do projetor, e cada script que sincroniza chama esse comando com um verbo diferente. Toque em Copiar bloco na app e cole-o em configuration.yaml. O exemplo abaixo é ilustrativo - a app preenche o endereço e o nome do 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 um exemplo. A app gera o seu com o IP real do projetor e um nome derivado do número de série.

Testar ligação, Sincronizar e limpeza

• Testar ligação verifica se a app consegue chegar ao seu Home Assistant e se o shell_command colado está mesmo lá, para encontrar um erro de escrita antes de construir seja o que for por cima.
• Sincronizar com o HA escreve ou atualiza os scripts das suas Cenas e controlos, e cria um painel Projector Pilot pronto a usar diretamente no Home Assistant. Execute-o outra vez sempre que adicionar uma Cena ou alterar um controlo - atualiza no local, sem acumular duplicados.
• Remover scripts órfãos encontra scripts que a app escreveu e que já não têm uma Cena ou um controlo correspondente - por exemplo depois de apagar uma Cena - lista exatamente quais vai remover e pergunta primeiro. Nada é apagado até confirmar. Só mexe em scripts criados pelo Projector Pilot; nada mais no seu Home Assistant é perturbado, e se o Home Assistant não listar os seus scripts, nada é removido.

• Ligado ao Home Assistant - sessão iniciada e a responder. Se o Home Assistant não responder, a linha pede para verificar o endereço e se o telemóvel está na mesma rede.
• Projetor adicionado ao Home Assistant - se o Home Assistant já tem este projetor. Se não tiver, a linha leva-o a adicionar a integração PJLink, e o passo de adicionar integração mostra o host e a porta PJLink que o Home Assistant pede.
• Sensor de leituras registado - o sensor que transporta as leituras do seu projetor. Regista-se na primeira vez que a app lê o projetor, e a linha oferece Registar 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.

• Primeiro os cartões integrados. Se não tem cartões da comunidade, a sincronização cria o seu painel com os cartões integrados do Home Assistant e diz isso quando termina. Funciona logo de origem.
• Melhorado quando há cartões HACS instalados. A app verifica quais dos cartões da comunidade (Mushroom, button-card, card-mod, apexcharts-card) estão instalados e atualiza cada cartão para o mais rico onde o tem. O guia do painel feito à mão vai mais longe se quiser o aspeto completo de vidro verde.
• As Cenas e os controlos precisam da colagem. Se o Home Assistant ainda não tem um comando para enviar ao projetor, o painel é construído na mesma com leituras em direto, e um cartão Concluir configuração guia-o: toque em Copiar bloco, cole-o em configuration.yaml, reinicie o Home Assistant e depois toque em Sincronizar de novo.
• Nada instalado? Cole à mão. Se não há nada instalado no Home Assistant, pode copiar tudo da app e colar você mesmo.
• Uma palavra-passe é assinalada. O bloco de comandos que cola diz quando leva uma palavra-passe do projetor, para saber antes de o partilhar ou guardar.

• É mais um bloco opcional: cole-o no fim de configuration.yaml (ou adicione só as respetivas linhas numa secção template: existente) e reinicie o Home Assistant. A app tem um botão Verificar se está lá que diz se o Home Assistant o tem.
• Um desligar chega agora ao Home Assistant como desligado, para que o painel e as suas automações vejam o projetor como desligado quando está.

• As automações podem executá-las. "Ao pôr do sol, se a TV ligar, executar Movie Night" é uma automação normal do Home Assistant depois de a Cena ser um script.
• Os assistentes de voz podem executá-las. Exponha um script ao seu assistente e "liga o Movie Night" define a entrada, o modo de imagem e a memória da lente em conjunto.
• Só aparecem os seus controlos reais. A app escreve um script para cada entrada, modo de cor e memória da lente que o projetor comunica - não uma lista genérica adivinhada.
• Remover a sincronização remove só o que a app escreveu. Desative a sincronização, ou use Remover scripts órfãos (que os lista e pergunta primeiro), e o Projector Pilot apaga os scripts que criou e mais nada.

O painel

A sincronização cria o painel por si

Não tem de construir à mão uma vista Lovelace, nem tem de colar uma. Quando toca em Sincronizar com o HA, a app cria um painel Projector Pilot completo diretamente no Home Assistant, através da respetiva API: o estado em direto do projetor e um botão para cada Cena e controlo que sincronizou. Aparece na barra lateral do Home Assistant como Projector Pilot - abra-o e está feito.

1. Inicie sessão no Home Assistant na app.
2. Cole uma vez o bloco Copiar da app em configuration.yaml e reinicie o Home Assistant (o único passo manual - o Home Assistant não deixa as apps adicionar esse comando remotamente).
3. Toque em Sincronizar com o HA. O painel é criado por si e aparece na barra lateral como Projector Pilot.

Quer seja criado por si ou colado por si, o painel é o mesmo - um cartão de estado mais um botão para cada controlo (excerto 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 um exemplo. O seu painel traz a entidade real do seu projetor e as suas próprias Cenas.

1. No Hubitat, ative a app Maker API, tome nota do respetivo URL de acesso e token, e escolha que dispositivos expõe.
2. No Projector Pilot, abra Definições › Automação doméstica › Hubitat e introduza os dados da Maker API do seu hub.
3. Escolha o dispositivo que representa o projetor. A app sugere o mais provável; escolha-o ou selecione o seu.
4. A app espelha a energia, o silêncio e a 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 comanda-as.

1. Abra Definições › Automação doméstica › Webhooks.
2. Introduza o URL para onde enviar. Um webhook do Home Assistant tem este aspeto: http://homeassistant.local:8123/api/webhook/your-id.
3. Escolha que eventos disparam o webhook: ligar, desligar, mudança de entrada, recuperação de Cena - e, opcionalmente, filtre para uma entrada ou Cena específica.
4. Opcionalmente, defina um payload personalizado se o serviço recetor quiser uma forma específica; caso contrário, a app envia o JSON predefinido.
5. Guarde. A app envia em cada evento correspondente a partir daí.

O payload predefinido é 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 que lhe dizem respeito.