ha-warm-family-panel/docs/SETUP.md

Установка «Тёплого дома» в Home Assistant

Небольшая пошаговая инструкция. Ничего сложного — минут на 15, дальше только подставляете свои устройства. Всё на стандартном Home Assistant, HACS и сторонние модули не нужны.

Путь к папке конфигурации HA дальше обозначаю как <config> — это папка, где лежит ваш configuration.yaml (в Supervised/HAOS обычно /config).

---

1. Скопировать файлы

Положите содержимое репозитория в папку конфигурации так:

<config>/
├── configuration.yaml          # ваш существующий — в него добавим пару строк
├── themes/
│   └── warm_home.yaml          # тёплая тема
├── packages/
│   ├── family_scenarios.yaml   # сценарии (scripts + automations)
│   └── helpers.yaml            # флажки-режимы и расписание  (перенести сюда, см. §4)
└── lovelace/
    └── dashboard.yaml          # дашборд «Тёплый дом»

---

2. Включить тему

В configuration.yaml:

frontend:
  themes: !include_dir_merge_named themes

После перезапуска: профиль пользователя (кружок внизу слева) → Тема → «warm_home». Можно поставить отдельно каждому члену семьи.

---

3. Включить пакеты (сценарии)

В configuration.yaml, внутри блока homeassistant::

homeassistant:
  packages: !include_dir_named packages

Теперь HA подхватит packages/family_scenarios.yaml — все script: и automation: из него появятся автоматически.

Если у вас уже есть automation: !include automations.yaml — это нормально, пакетные автоматизации просто добавятся к вашим. Ничего не перезапишется.

---

4. Помощники-режимы (helpers)

Файл helpers.yaml заводит флажки-режимы (input_boolean.family_mode, guests, movie, night, eco, quiet_hours, sick_child, party…), время подъёма/отбоя и пару чисел (эко/комфорт температура).

Самый простой способ — положить helpers.yaml в папку packages/ рядом с family_scenarios.yaml. Тогда шага §3 достаточно, и helpers подключатся сами.

(Альтернатива — подключать по доменам в configuration.yaml: input_boolean: !include ... и т.д. Но с packages проще.)

После старта зайдите в Настройки → Устройства и службы → Помощники и выставьте:

• время подъёма в школу (будни) и в выходные;
• время отбоя у детей;
• окно ночного тарифа (если он у вас есть);
• комфортную и эко-температуру.

---

5. Добавить дашборд

В configuration.yaml:

lovelace:
  mode: yaml            # если у вас уже storage-режим — см. примечание ниже
  dashboards:
    warm-home:
      mode: yaml
      title: Тёплый дом
      icon: mdi:home-heart
      show_in_sidebar: true
      filename: lovelace/dashboard.yaml

Если основной дашборд у вас в UI-режиме (storage) и переводить его в YAML не хочется — оставьте lovelace: без mode: yaml, только с блоком dashboards: и вложенным warm-home: { mode: yaml, ... }. Тогда «Тёплый дом» будет отдельным YAML-дашбордом, а остальные — как были.

Перезапустите HA (или «Проверить конфигурацию» → «Быстрая перезагрузка» для темы/lovelace).

---

6. Заменить entity_id на свои

Это главный шаг. В сценариях и дашборде стоят понятные плейсхолдеры:

Плейсхолдер	Что это	Ваш пример
light.gostinaya	свет в гостиной	light.living_room_ceiling
climate.detskaya_1	климат/термостат в детской №1	climate.kids_1_trv
cover.gostinaya	шторы/жалюзи гостиной	cover.living_blind
binary_sensor.protechka_vannaya	датчик протечки в ванной	binary_sensor.leak_bath
person.rebenok_1	член семьи (для «кто дома»)	person.ivan
alarm_control_panel.dom	охранная панель	ваша alarm_control_panel.*
weather.dom	погода	weather.forecast_home
media_player.ves_dom	«весь дом» (мультирум)	ваша группа медиаплееров

Как найти свои: Инструменты разработчика → Состояния — там список всех entity_id. Удобно менять «Найти и заменить» прямо в редакторе файлов (например, через дополнение File editor / Studio Code Server).

Несуществующие сущности не ломают панель — они просто покажутся серым «недоступно». Можно заменять постепенно, комната за комнатой.

---

7. Уведомления и голос

Сценарии шлют сообщения в notify.family_adults и говорят через tts.speak.

Группа взрослых — заведите в configuration.yaml (пример для мобильного приложения HA):

notify:
  - platform: group
    name: family_adults
    services:
      - service: mobile_app_telefon_mamy    # ваши notify.* устройства
      - service: mobile_app_telefon_papy

Голос (TTS) — в сценарии Тревога и мультирумных сценах используется tts.speak и media_player.ves_dom. Подставьте свой TTS-движок (HA Cloud, Piper, Yandex и т.п.) и реальный медиаплеер/группу «весь дом».

Код охраны — в сценариях стоит code: "!secret alarm_code". Добавьте в <config>/secrets.yaml:

alarm_code: "1234"     # ваш код

---

8. Проверка

1. Разработчик → Проверить конфигурацию — должно быть «Конфигурация верна».
2. Откройте дашборд «Тёплый дом» в боковой панели.
3. Нажмите крупную кнопку сцены (например «Вечер») — свет должен отреагировать на тех сущностях, которые вы уже подставили.
4. Автоматизации видны в Настройки → Автоматизации с префиксом «Тёплый дом · …» — их можно включать/выключать и запускать вручную для теста.

Готово. Дальше — просто живите в тёплом доме 🏡