Tu proyector, en Home Assistant y Hubitat.

• Publica el estado. El proyector aparece como un sensor de Home Assistant, un dispositivo de Hubitat o una carga JSON en tu webhook, con las mismas lecturas que te muestra la app.
• Publica controles. Cada escena que guardas, además del encendido, cada entrada, cada modo de color y cada memoria de objetivo, se convierte en algo que una automatización o un asistente de voz puede ejecutar.
• Funciona sin servidor. Una vez configurados los scripts, Home Assistant envía los comandos directamente a la dirección IP del proyector. Tu teléfono no necesita estar en la red, y nada pasa por una cuenta en la nube.

Tres vías de entrada, un solo centro

Ajustes › Domótica es el centro. Elige la plataforma que usas - Home Assistant, Hubitat o Webhooks - y configúrala ahí. Puedes conectar más de una a la vez; son independientes.

1. Abre Ajustes › Domótica › Home Assistant.
2. Escribe tu dirección de Home Assistant (por ejemplo http://homeassistant.local:8123 o su IP) y toca Iniciar sesión. Es un inicio de sesión en el navegador contra tu propia instancia - no hay token que pegar. Usa tu inicio de sesión normal de Home Assistant, con doble factor y todo.
3. La app publica el proyector como un sensor, con una entidad como sensor.projector_pilot_epson_qb1000b_qb1000w, que lleva el encendido, la entrada, el modo de color, las cifras de imagen y las horas de lámpara.
4. Activa Enviar el estado del proyector para que esas lecturas se actualicen en Home Assistant cada vez que cambien mientras la app está abierta, y activa Sincronizar controles avanzados para publicar scripts de modos de imagen, entradas, memorias de objetivo y encendido.
5. Pega el bloque shell_command (abajo) en tu configuration.yaml, reinicia Home Assistant y toca Sincronizar con HA.

El bloque shell_command

Este es todo el truco sin servidor. La app escribe un comando que Home Assistant ejecuta para hablar con el Web Control del proyector, y cada script que sincroniza llama a ese comando con un verbo distinto. Toca Copiar bloque en la app y pégalo en configuration.yaml. El ejemplo de abajo es ilustrativo - la app rellena la dirección y el nombre de comando propios de tu proyector:

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 es un ejemplo. La app genera el tuyo con la IP real del proyector y un nombre derivado de su número de serie.

Probar conexión, sincronizar y limpiar

• Probar conexión comprueba que la app llega a tu Home Assistant y que el shell_command pegado está realmente ahí, para que encuentres una errata antes de construir nada encima.
• Sincronizar con HA escribe o actualiza los scripts de tus escenas y controles, y crea un panel de Projector Pilot ya hecho directamente en Home Assistant. Ejecútalo cuando quieras al añadir una escena o cambiar un control - se actualiza sobre la marcha en lugar de acumular duplicados.
• Quitar scripts huérfanos encuentra los scripts que escribió la app y que ya no tienen una escena o control correspondiente - por ejemplo, tras borrar una escena - muestra exactamente cuáles va a quitar y pregunta antes. No se borra nada hasta que confirmas. Solo toca scripts creados por Projector Pilot; nada más de tu Home Assistant se altera, y si Home Assistant no muestra su lista de scripts, no se quita nada.

• Conectado a Home Assistant - sesión iniciada y respondiendo. Si Home Assistant no responde, la fila te dice que revises la dirección y que tu teléfono esté en la misma red.
• Proyector añadido a Home Assistant - si Home Assistant ya tiene este proyector. Si no lo tiene, la fila te lleva a añadir la integración PJLink, y el paso de añadir integración muestra el host y el puerto de PJLink que pide Home Assistant.
• Sensor de lecturas registrado - el sensor que lleva las lecturas de tu proyector. Se registra la primera vez que la app lee el proyector, y la fila ofrece Registrar ahora o Activar cuando algo lo impide.
• Lo que tiene tu Home Assistant - HACS (la tienda de la comunidad), la integración Epson Projector Link, la integración PJLink y los comandos de Projector Pilot en configuration.yaml. Cada uno muestra Encontrado, No instalado o No se pudo determinar, con botones Cómo instalar y Abrir en HACS donde ayudan.

• Primero, las tarjetas integradas. Si no tienes tarjetas de la comunidad, Sincronizar construye tu panel con las tarjetas integradas de Home Assistant y lo dice al terminar. Funciona de serie.
• Mejora cuando hay tarjetas de HACS instaladas. La app comprueba cuáles de las tarjetas de la comunidad (Mushroom, button-card, card-mod, apexcharts-card) están instaladas y mejora cada tarjeta a la más rica donde la tengas. La guía del panel hecho a mano va más allá si quieres el aspecto completo de cristal verde.
• Las escenas y los controles necesitan el único pegado. Si Home Assistant aún no tiene un comando para enviar al proyector, el panel se construye igualmente con lecturas en vivo, y una tarjeta Terminar configuración te guía: toca Copiar bloque, pégalo en configuration.yaml, reinicia Home Assistant y toca Sincronizar otra vez.
• ¿Nada instalado? Pega a mano. Si no hay nada instalado en Home Assistant, aún puedes copiar todo desde la app y pegarlo tú mismo.
• Se avisa de la contraseña. El bloque de comandos que pegas indica cuándo lleva una contraseña de proyector, para que lo sepas antes de compartirlo o guardarlo.

• Es un bloque opcional más: pégalo al final de configuration.yaml (o añade solo sus líneas bajo una sección template: existente) y reinicia Home Assistant. La app tiene un botón Comprobar que está que te dice si Home Assistant lo tiene.
• Un apagado ahora llega a Home Assistant como off, así que el panel y tus automatizaciones ven el proyector como apagado cuando lo está.

• Las automatizaciones pueden ejecutarlas. “Al atardecer, si se enciende la TV, ejecuta Noche de cine” es una automatización normal de Home Assistant una vez que la escena es un script.
• Los asistentes de voz pueden ejecutarlas. Expón un script a tu asistente y “enciende Noche de cine” configura juntos la entrada, el modo de imagen y la memoria de objetivo.
• Solo aparecen tus controles reales. La app escribe un script para cada entrada, modo de color y memoria de objetivo que indica el proyector - no una lista genérica que haya supuesto.
• Quitar la sincronización quita solo lo que escribió la app. Desactiva la sincronización, o usa Quitar scripts huérfanos (que los muestra y pregunta antes), y Projector Pilot borra los scripts que creó y nada más.

El panel

Sincronizar crea el panel por ti

No tienes que montar a mano una vista Lovelace, y ya tampoco tienes que pegar una. Cuando tocas Sincronizar con HA, la app crea un panel completo de Projector Pilot directamente en Home Assistant a través de su propia API: el estado en vivo del proyector y un botón para cada escena y control sincronizado. Aparece en la barra lateral de tu Home Assistant como Projector Pilot - ábrelo y listo.

1. Inicia sesión en Home Assistant desde la app.
2. Pega una vez el bloque Copiar de la app en configuration.yaml y reinicia Home Assistant (el único paso manual - Home Assistant no deja que las apps añadan ese comando de forma remota).
3. Toca Sincronizar con HA. El panel se crea por ti y aparece en la barra lateral como Projector Pilot.

Tanto si te lo crean como si lo pegas, el panel es el mismo - una tarjeta de estado más un botón para cada control (fragmento 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

Solo es un ejemplo. Tu panel lleva la entidad real de tu proyector y tus propias escenas.

1. En Hubitat, activa la app Maker API, anota su URL de acceso y su token, y elige qué dispositivos expone.
2. En Projector Pilot, abre Ajustes › Domótica › Hubitat e introduce los datos de Maker API de tu hub.
3. Elige el dispositivo que representa al proyector. La app sugiere el más probable; elígelo o selecciona el tuyo.
4. La app refleja el encendido, el silencio y la entrada en ese dispositivo, enviando solo los comandos que el dispositivo acepta.
5. Crea reglas de Rule Machine sobre ese dispositivo como harías con cualquier otro - el estado del proyector las activa.

1. Abre Ajustes › Domótica › Webhooks.
2. Introduce la URL a la que publicar. Un webhook de Home Assistant tiene este aspecto: http://homeassistant.local:8123/api/webhook/your-id.
3. Elige qué eventos disparan el webhook: encendido, apagado, cambio de entrada, recuperar escena - y, si quieres, filtra por una entrada o escena concreta.
4. Si quieres, define una carga personalizada si el servicio receptor necesita una forma concreta; si no, la app envía su JSON por defecto.
5. Guarda. A partir de ahí, la app publica en cada evento coincidente.

La carga por defecto es JSON simple - un evento, el proyector y el valor que cambió:

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

Carga de ejemplo. Un evento de cambio de entrada o de encendido lleva los campos que le corresponden.