Home Assistant остается одной из самых мощных платформ для умного дома, однако ее интерфейс не всегда можно назвать интуитивно понятным. Даже такая простая вещь, как редактирование боковой панели для более удобной навигации, может занять больше времени, чем ожидалось. В то же время результат стоит усилий.
Ниже описана последовательность действий, позволяющая отредактировать панель навигации в Home Assistant.
Важно отметить, что этот метод работает только в контролируемых (supervised) установках Home Assistant. В случае контейнеризованных (Docker) или старых Core-версий такой способ не поддерживается. Перед любыми изменениями необходимо создать резервную копию Home Assistant.
Зачем редактировать боковую панель
Основная цель редактирования-добавить быстрый доступ к часто используемым интеграциям, таким как Zigbee Home Automation (для быстрого добавления и управления устройствами) или надстройка “File editor”, которая удобна для редактирования файла configuration.yaml.
Доступ к этим разделам обычно требует нескольких нажатий и переходов через меню настроек. Кроме того, в стандартном списке есть элементы, которые почти никогда не используются (например, Map или Energy). Обе проблемы можно решить, настроив собственные ярлыки.
Добавление ссылки на конкретный раздел с настраиваемым значком довольно просто, если известно, где находится этот раздел.
Установка надстройки File Editor
Для начала необходимо иметь возможность редактировать главный файл configuration.yaml. Для этого требуется соответствующая надстройка. Надстройки в Home Assistant-это отдельные сервисы и приложения, работающие рядом с основной системой, в отличие от интеграций, которые работают внутри нее.
Чтобы установить надстройку, вам нужно открыть Settings > Add-ons , нажать синюю кнопку “Добавить в магазин” в правом нижнем углу экрана, найти “редактор файлов” и нажать Install . После завершения установки вы должны нажать Start . После запуска появится кнопка «Open Web UI» , которая понадобится на следующем этапе.
Рекомендуется сразу включить опцию «Start on boot» , чтобы надстройка автоматически запускалась во время старта системы. Она не потребляет много ресурсов, но является крайне полезной.
Добавление пунктов меню с помощью пользовательских панелей
Добавление новых элементов в меню осуществляется через базовую интеграцию Home Assistant под названием Custom panel . Документация доступна на официальном сайте Home Assistant, но Подробнее это описано ниже.
Необходимо создать ярлыки к Zigbee Home Automation и к надстройке “File editor”. Для этого нужно знать адрес расположения каждого элемента. Для ZHA он имеет вид config/integrations/integration / zha .
Этот адрес можно узнать, открыв нужную интеграцию и посмотрев на URL в строке браузера. Нужно скопировать все, что идет после адреса сервера и порта.
Далее нужно нажать «Open Web UI “ в надстройке” File editor» ( Settings > Add-ons > File editor ). В новом интерфейсе откроется файл configuration.yaml , расположенный в каталоге / homeassistant/ . Если файл не открылся, вам нужно вручную перейти к нему через панель навигации в верхней части редактора.
В самом конце файла следует добавить следующие строки:
Для создания ярлыка к надстройке «File editor» нужно добавить еще один блок непосредственно под предыдущим:
Поля, которые следует изменять при создании новых элементов:
-
name -внутреннее название элемента;
-
sidebar_title -имя, отображаемое в меню;
-
sidebar_icon -значок, отображаемый рядом с именем;
-
url_path -это путь к элементу, на который создается ссылка.
Для выбора значков используется набор Material Design Icons . Нужно найти нужную иконку, после чего указать ее в формате mdi:name .
Все новые ярлыки добавляются под раздел panel_custom . После внесения изменений вы должны нажать красную кнопку «Сохранить» в верхней части экрана, а затем перезапустить Home Assistant ( настройки > три точки > Restart Home Assistant ), чтобы применить изменения.
Скрытие и упорядочение элементов боковой панели
Чтобы убрать иконку, достаточно удалить соответствующий YAML-блок из файла configuration.yaml. Однако существует более простой способ-скрыть ненужные элементы или изменить порядок их отображения.
Для этого нужно нажать на имя пользователя или иконку профиля в нижнем левом углу экрана и прокрутить страницу вниз до пункта “Change the order and hide items from the sidebar” .
После нажатия «редактировать» появится список всех элементов, включая те, которые были добавлены вручную. Их можно перетащить в нужном порядке, после чего нажать “Save” .
В результате панель навигации становится полностью гибкой: можно добавлять собственные разделы, убирать лишние, менять порядок и создавать ярлыки к часто используемым частям системы, что существенно повышает удобство работы с Home Assistant.
