Ваш проєктор у 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 щоразу, коли вони змінюються, поки застосунок відкрито, а також увімкніть Sync Advanced Controls, щоб публікувати скрипти для режимів зображення, входів, пам'яті об'єктива та живлення.
5. Вставте один блок shell_command (нижче) у ваш configuration.yaml, перезапустіть Home Assistant, потім торкніться Sync With HA.

Блок shell_command

Це і є весь секрет роботи без сервера. Застосунок записує одну команду, яку Home Assistant виконує для зв'язку з Web Control проєктора, а кожен синхронізований скрипт викликає цю команду з іншим дієсловом. Торкніться Copy block у застосунку й вставте її в 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 проєктора та назвою, утвореною від його серійного номера.

Test Connection, Sync і прибирання

• Test Connection перевіряє, що застосунок може зв'язатися з вашим Home Assistant і що вставлений shell_command справді там є, тож помилку друку ви знайдете, перш ніж будувати щось поверх.
• Sync With HA записує або оновлює скрипти для ваших сцен і елементів керування та будує готовий дашборд Projector Pilot просто в Home Assistant. Запускайте знову щоразу, коли додаєте сцену чи змінюєте елемент керування - він оновлює наявне, а не накопичує дублікати.
• Remove orphaned scripts знаходить скрипти, записані застосунком, яким більше не відповідає жодна сцена чи елемент керування, наприклад після видалення сцени, - показує, які саме видалить, і спершу питає. Нічого не видаляється, доки ви не підтвердите. Він торкається лише скриптів, створених 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», де вони допомагають.

• Спершу вбудовані картки. Якщо карток спільноти немає, Sync будує дашборд із вбудованих карток Home Assistant і повідомляє про це по завершенні. Працює одразу.
• Оновлення, коли встановлено картки HACS. Застосунок перевіряє, які з карток спільноти (Mushroom, button-card, card-mod, apexcharts-card) встановлено, і оновлює кожну картку до багатшої, де вона є. Посібник зі збирання дашборда вручну іде далі, якщо вам потрібен повний вигляд із зеленого скла.
• Сцени й елементи керування потребують одного вставлення. Якщо в Home Assistant ще немає команди для надсилання на проєктор, дашборд усе одно будується з живими показаннями, а картка Завершити налаштування проведе вас: торкніться Copy block, вставте в configuration.yaml, перезапустіть Home Assistant, потім знову торкніться Sync.
• Нічого не встановлено? Вставте вручну. Якщо в Home Assistant нічого не встановлено, ви все одно можете скопіювати все із застосунку й вставити самостійно.
• Пароль позначено. Блок команди, який ви вставляєте, повідомляє, коли містить пароль проєктора, тож ви знаєте про це до того, як поділитеся чи збережете його.

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

• Автоматизації можуть їх запускати. «На заході сонця, якщо TV увімкнено, запустити Movie Night» - це звичайна автоматизація Home Assistant, щойно сцена стала скриптом.
• Голосові асистенти можуть їх запускати. Надайте скрипт своєму асистентові, і «увімкни Movie Night» одночасно встановить вхід, режим зображення та пам'ять об'єктива.
• З'являються лише ваші справжні елементи керування. Застосунок записує скрипт для кожного входу, режиму кольору й пам'яті об'єктива, які повідомляє проєктор, а не загальний список, який він вгадав.
• Вимкнення синхронізації видаляє лише те, що записав застосунок. Вимкніть синхронізацію або скористайтеся Remove orphaned scripts (він показує їх і спершу питає), і Projector Pilot видалить створені ним скрипти й нічого більше.

Дашборд

Sync будує дашборд за вас

Вам не потрібно вручну збирати подання Lovelace, і вставляти його вже теж не треба. Коли ви торкаєтеся Sync With HA, застосунок будує повний дашборд Projector Pilot безпосередньо в Home Assistant через його власний API: живий стан проєктора та кнопку для кожної синхронізованої сцени й елемента керування. Він з'являється на бічній панелі Home Assistant як Projector Pilot - відкрийте його, і все готово.

1. Увійдіть у Home Assistant у застосунку.
2. Один раз вставте блок Copy застосунку в configuration.yaml і перезапустіть Home Assistant (єдиний ручний крок - Home Assistant не дозволяє застосункам додавати цю команду віддалено).
3. Торкніться Sync With 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"
}

Приклад корисного навантаження. Подія зміни входу чи живлення несе відповідні їй поля.