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, натиснути синю кнопку “Add-on store” у нижньому правому куті екрана, знайти “File editor” і натиснути Install. Після завершення встановлення слід натиснути Start. Після запуску з’явиться кнопка “Open Web UI”, яка знадобиться на наступному етапі.
Рекомендується одразу ввімкнути опцію “Start on boot”, щоб надбудова автоматично запускалася під час старту системи. Вона не споживає багато ресурсів, але є вкрай корисною.
Додавання пунктів меню за допомогою Custom Panels
Додавання нових елементів у меню здійснюється через базову інтеграцію 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. Після внесення змін потрібно натиснути червону кнопку “Save” у верхній частині екрана, а потім перезапустити Home Assistant (Settings > три крапки > Restart Home Assistant) для застосування змін.
Приховування та впорядкування елементів бічної панелі
Щоб прибрати іконку, достатньо видалити відповідний YAML-блок із файлу configuration.yaml. Однак існує простіший спосіб – приховати непотрібні елементи або змінити порядок їхнього відображення.
Для цього потрібно натиснути на ім’я користувача або іконку профілю в нижньому лівому куті екрана та прокрутити сторінку вниз до пункту “Change the order and hide items from the sidebar”.
Після натискання “Edit” з’явиться список усіх елементів, включно з тими, що були додані вручну. Їх можна перетягнути у потрібному порядку, після чого натиснути “Save”.
У результаті панель навігації стає повністю гнучкою: можна додавати власні розділи, прибирати зайві, змінювати порядок і створювати ярлики до часто використовуваних частин системи, що суттєво підвищує зручність роботи з Home Assistant.
