Ваш проектор - в Home Assistant и Hubitat.

• Она публикует состояние. Проектор появляется как датчик Home Assistant, устройство Hubitat или JSON-данные в вашем вебхуке с теми же показаниями, что вы видите в приложении.
• Она публикует элементы управления. Каждая сохранённая сцена, а также питание, каждый вход, каждый цветовой режим и каждая память объектива становятся тем, что могут запускать автоматизация или голосовой помощник.
• Она работает без сервера. После настройки скриптов Home Assistant отправляет команды прямо на IP-адрес проектора. Телефону не нужно быть в сети, и ничего не проходит через облачную учётную запись.

Три пути, один центр

Настройки › Домашняя автоматизация - это центр. Выберите свою платформу - Home Assistant, Hubitat или вебхуки - и настройте её там. Можно подключить несколько сразу; они независимы.

1. Откройте Настройки › Домашняя автоматизация › Home Assistant.
2. Введите адрес Home Assistant (например, http://homeassistant.local:8123 или его IP), затем нажмите Войти. Это вход через браузер в вашем собственном экземпляре - вставлять токен не нужно. Используйте обычный логин Home Assistant, включая двухфакторную аутентификацию.
3. Приложение публикует проектор как датчик с сущностью вида sensor.projector_pilot_epson_qb1000b_qb1000w, содержащий питание, вход, цветовой режим, параметры изображения и часы работы лампы.
4. Включите Отправлять состояние проектора, чтобы эти показания обновлялись в Home Assistant при каждом изменении, пока приложение открыто, и включите Синхронизировать расширенное управление, чтобы опубликовать скрипты для режимов изображения, входов, памяти объектива и питания.
5. Вставьте один блок shell_command (ниже) в свой configuration.yaml, перезапустите Home Assistant, затем нажмите Синхронизировать с HA.

Блок shell_command

В этом весь секрет работы без сервера. Приложение записывает одну команду, которую Home Assistant выполняет для связи с Web Control проектора, а каждый синхронизированный скрипт вызывает эту команду с другим действием. Нажмите Копировать блок в приложении и вставьте его в configuration.yaml. Пример ниже - иллюстрация: приложение подставит собственный адрес вашего проектора и имя команды:

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

Только пример. Приложение создаёт ваш блок с реальным IP проектора и именем, производным от его серийного номера.

Проверка подключения, синхронизация и очистка

• Проверить подключение убеждается, что приложение может связаться с вашим Home Assistant и что вставленный shell_command действительно на месте, - так вы найдёте опечатку до того, как что-то на нём построите.
• Синхронизировать с HA записывает или обновляет скрипты для ваших сцен и элементов управления и создаёт готовую панель Projector Pilot прямо в Home Assistant. Запускайте снова при добавлении сцены или изменении элемента управления - обновление идёт на месте, дубликаты не накапливаются.
• Удалить осиротевшие скрипты находит скрипты, записанные приложением, для которых больше нет сцены или элемента управления, - например, после удаления сцены - показывает, какие именно будут удалены, и сначала спрашивает. Ничего не удаляется без вашего подтверждения. Затрагиваются только скрипты, созданные Projector Pilot; остальное в вашем Home Assistant не тронуто, а если Home Assistant не выдаёт список скриптов, ничего не удаляется.

• Подключено к Home Assistant - вход выполнен и ответ получен. Если Home Assistant не отвечает, строка предлагает проверить адрес и что телефон в той же сети.
• Проектор добавлен в Home Assistant - есть ли этот проектор в Home Assistant. Если нет, строка отправляет вас добавить интеграцию PJLink, а шаг добавления интеграции показывает хост и порт PJLink, которые запрашивает Home Assistant.
• Датчик показаний зарегистрирован - датчик, содержащий показания вашего проектора. Он регистрируется при первом считывании данных проектора, а строка предлагает Зарегистрировать или Включить, если что-то этому мешает.
• Что есть в вашем Home Assistant - HACS (магазин сообщества), интеграция Epson Projector Link, интеграция PJLink и команды Projector Pilot в configuration.yaml. Для каждого показано «Найдено», «Не установлено» или «Не удалось определить», а при необходимости есть кнопки «Как установить» и «Открыть в HACS».

• Сначала встроенные карточки. Если карточек сообщества нет, синхронизация создаёт панель из встроенных карточек Home Assistant и сообщает об этом по завершении. Всё работает сразу.
• Улучшение при наличии карточек HACS. Приложение проверяет, какие из карточек сообщества (Mushroom, button-card, card-mod, apexcharts-card) установлены, и заменяет каждую карточку более богатой там, где она есть. Руководство по панели ручной сборки идёт дальше, если вам нужен полный вид из зелёного стекла.
• Сценам и элементам управления нужна одна вставка. Если в Home Assistant ещё нет команды для отправки на проектор, панель всё равно создаётся с показаниями в реальном времени, а карточка Завершить настройку проведёт вас по шагам: нажмите «Копировать блок», вставьте его в configuration.yaml, перезапустите Home Assistant, затем снова нажмите «Синхронизировать».
• Ничего не установлено? Вставьте вручную. Если в Home Assistant ничего не установлено, вы всё равно можете скопировать всё из приложения и вставить самостоятельно.
• Пароль помечается. Вставляемый блок команды сообщает, когда содержит пароль проектора, так что вы знаете об этом, прежде чем делиться им или сохранять.

• Это ещё один необязательный блок: вставьте его в конец configuration.yaml (или добавьте только его строки в существующий раздел template:) и перезапустите Home Assistant. В приложении есть кнопка Проверить, на месте ли, которая сообщает, есть ли он в Home Assistant.
• Выключение теперь доходит до Home Assistant как off, так что панель и ваши автоматизации видят проектор выключенным, когда он выключен.

• Автоматизации могут их запускать. «На закате, если телевизор включился, запустить “Киновечер”» - обычная автоматизация Home Assistant, когда сцена стала скриптом.
• Голосовые помощники могут их запускать. Откройте скрипт своему помощнику, и фраза «включи “Киновечер”» одновременно задаст вход, режим изображения и память объектива.
• Появляются только ваши реальные элементы управления. Приложение записывает скрипт для каждого входа, цветового режима и памяти объектива, о которых сообщает проектор, а не универсальный список, составленный наугад.
• Отключение синхронизации удаляет только записанное приложением. Выключите синхронизацию или воспользуйтесь функцией «Удалить осиротевшие скрипты» (она показывает список и сначала спрашивает), и Projector Pilot удалит созданные им скрипты и больше ничего.

Панель управления

Синхронизация создаёт панель за вас

Вам не нужно собирать представление Lovelace вручную и больше не нужно его вставлять. Когда вы нажимаете Синхронизировать с HA, приложение создаёт полную панель Projector Pilot прямо в Home Assistant через его собственный API: состояние проектора в реальном времени и кнопку для каждой синхронизированной сцены и элемента управления. Она появляется в боковом меню Home Assistant как Projector Pilot - откройте её, и всё готово.

1. Войдите в Home Assistant в приложении.
2. Один раз вставьте блок «Копировать» приложения в configuration.yaml и перезапустите Home Assistant (единственный ручной шаг - Home Assistant не позволяет приложениям добавлять эту команду удалённо).
3. Нажмите Синхронизировать с HA. Панель будет создана и появится в боковом меню как Projector Pilot.

Создана ли панель за вас или вы вставили её сами, она одинакова - карточка состояния плюс кнопка для каждого элемента управления (пример фрагмента):

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

Только пример. В вашей панели - реальная сущность вашего проектора и ваши сцены.

1. В Hubitat включите приложение Maker API, запишите его URL доступа и токен и выберите, какие устройства оно открывает.
2. В Projector Pilot откройте Настройки › Домашняя автоматизация › Hubitat и введите данные Maker API вашего хаба.
3. Выберите устройство, представляющее проектор. Приложение предлагает наиболее подходящее; выберите его или укажите своё.
4. Приложение отражает питание, отключение звука и вход на это устройство, отправляя только те команды, которые устройство принимает.
5. Создавайте правила Rule Machine для этого устройства так же, как для любого другого - ими управляет состояние проектора.

1. Откройте Настройки › Домашняя автоматизация › Вебхуки.
2. Введите URL, на который нужно отправлять. Вебхук Home Assistant выглядит так: http://homeassistant.local:8123/api/webhook/your-id.
3. Выберите, какие события запускают вебхук: включение, выключение, смена входа, вызов сцены - и при желании отфильтруйте по конкретному входу или сцене.
4. При необходимости задайте собственные данные запроса, если принимающему сервису нужен определённый формат; иначе приложение отправляет JSON по умолчанию.
5. Сохраните. С этого момента приложение отправляет запрос при каждом подходящем событии.

Данные по умолчанию - обычный JSON: событие, проектор и изменившееся значение:

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

Пример данных. Событие смены входа или питания содержит соответствующие ему поля.