Визуализация с помощью Lovelace-UI

С помощью этого адаптера вы можете создавать визуализацию для ioBroker с Home Assistant Lovelace UI

Текущий релиз
7.4.1
Разработчик
bluefox
Лицензия
Apache-2.0

Адаптер Lovelace для ioBroker

С помощью этого адаптера вы можете создавать визуализации для ioBroker с использованием пользовательского интерфейса Home Assistant Lovelace.

Документация

В документации рассматриваются вопросы настройки (автоматические/ручные параметры), панели и специальные элементы (будильник, таймер, погода, карта, видео и т. д.), пользовательские карточки, темы оформления, значки, уведомления, голосовое управление и устранение неполадок.

Разработка

Оригинальные источники для Лавлейс

Исходный код использован здесь: https://github.com/GermanBluefox/home-assistant-polymer.

Todo

Права доступа должны обеспечиваться за счет текущего пользователя, а не за счет default_user.

Версия

Используемая версия home-assistant-frontend@20260826.7. Версия Browser Mod: 3.2.3

Как собрать новую версию Lovelace

Прежде всего, необходимо вручную объединить репозиторий https://github.com/home-assistant/frontend (ветка разработки) с репозиторием https://github.com/GermanBluefox/home-assistant-polymer.git (ветка iob!).

Все изменения для ioBroker отмечены комментарием // IoB. На данный момент (20260826.7) были изменены следующие файлы:

  • build-scripts/gulp/app.js - Добавить новую задачу gulp develop-iob
  • build-scripts/gulp/rspack.js - Добавить новую задачу gulp rspack-dev-app
  • build-scripts/rspack.cjs - отключить карты исходного кода в сборке продакшена, чтобы уменьшить количество генерируемых файлов.
  • src/data/icons.ts - пока сохранить старые иконки.
  • src/data/weather.ts - добавлена поддержка отображения значка погоды по URL-адресу.
  • src/dialogs/more-info/const.ts - удалить состояние погоды и историю, если это изображение.
  • src/dialogs/more-info/ha-more-info-dialog.ts - удалить кнопку и вкладку настроек сущности.
  • src/dialogs/more-info/ha-more-info-history.ts - удалить ссылку show more в истории
  • src/dialogs/more-info/ha-more-info-logbook.ts - удалить ссылку show more в логбуке
  • src/dialogs/more-info/controls/more-info-weather.ts - добавлена поддержка отображения значка погоды по URL-адресу.
  • src/dialogs/voice-command-dialog/ha-voice-command-dialog.ts - отключить настройку голосовых помощников
  • src/entrypoints/core.ts - добавить опцию без аутентификации
  • src/panels/lovelace/cards/hui-weather-forecast-card.ts - добавлена поддержка отображения значка погоды по URL-адресу.
  • src/panels/lovelace/entity-rows/hui-weather-entity-row.ts - добавлена поддержка отображения значка погоды по URL-адресу с авторизацией.
  • src/panels/lovelace/hui-root.ts - добавлена кнопка уведомлений, отключена ссылка «Управление панелями мониторинга», скрыта кнопка «Добавить (устройство/автоматизация/область/человек)», открыто диалоговое окно редактирования панели для досок Lovelace, заголовок панели мониторинга в реальном времени из hass.panels
  • src/layouts/hass-router-page.ts - защита updatePageEl от неопределенного маршрута во время перестройки (сбой при переименовании панели).
  • src/panels/config/dashboard/ha-config-dashboard.ts - скрыть разделы настроек (автоматизация, приложения, голосовые помощники, система, люди, подсказки).
  • src/panels/config/config-sections.ts - скрыть вкладку интеграций в разделе «Устройства и службы», разместить плитку «Устройства и службы» в файле /config/devices.
  • src/panels/config/tools/ha-panel-tools.ts - удалить вкладки YAML, событий и подсказок из инструментов разработчика.
  • src/panels/config/tools/tools-router.ts - по умолчанию используется вкладка "Состояния" (YAML удален).
  • src/panels/config/info/ha-config-info.ts - скрыть ссылки doc/credits/community/license в about (сохранить сочетания клавиш).
  • src/panels/config/lovelace/dashboards/ha-config-lovelace-dashboards.ts - отображать фиксированные панели (включая browser-mod) в списке встроенных панелей мониторинга.
  • src/panels/profile/ha-panel-profile.ts - скрыть вкладку безопасности в профиле пользователя.
  • src/util/documentation-url.ts - ссылка на справку iobroker вместо Home Assistant.
  • src/html/index.html.template - удалить баннер приложения Safari Smart (метафайл apple-itunes-app) для приложения HA iOS (#418).
  • .husky/pre-commit - удалить хуки для коммитов Git.

После этого загрузите модифицированную версию в папку ./build. Затем.

  1. Перейдите в каталог ./build.
  2. git clone https://github.com/GermanBluefox/home-assistant-polymer.git - это форк https://github.com/home-assistant/frontend.git, но некоторые вещи в нём изменены (см. список файлов выше).
  3. cd home-assistant-polymer
  4. git checkout master
  5. yarn install
  6. gulp build-app для релизной версии или gulp develop-iob для отладочной. Для сборки веб-версии после внесения изменений можно вызвать webpack-dev-app для более быстрой сборки, но в любом случае необходимо вызвать build-app после того, как версия будет готова к использованию.
  7. Запустите скрипт hass_frontend/static_cards/newFrontend.sh в репозитории адаптера, чтобы обновить фронтенд (предполагается, что два репозитория находятся рядом друг с другом в одной папке; если это не так, пожалуйста, доработайте скрипт, желательно с обработкой параметров, и создайте запрос на слияние, спасибо :smile: )
  8. Запустите npm run rename (переименовывает и перезаписывает скопированный интерфейс для ioBroker; эта задача заменила предыдущую задачу gulp rename).
  9. Обновите версию в файле README.md.

Changelog

7.0.0 (2026-09-18)

  • (Garfonso/Claude) Fixed custom cards that fetch history directly (e.g. the windrose card) crashing with "TypeError: t.callback is not a function": a one-shot history request was answered like a subscription. (#722)
  • (Garfonso/Claude) instances.hideSidebar / hideHeader no longer fall back to the default on an adapter restart. (#733)
  • (Garfonso/Claude) User names from ioBroker (person list, logbook user list) are resolved like every other name, so a multilingual common.name cannot break those views. (#731)
  • (Garfonso/Claude) The dashboard now uses the configured adapter language instead of the browser language. A language picked in the frontend profile still wins.
  • (Garfonso/Claude) Custom entities: new expert table at the end of the custom dialog that fills any attribute from a freely picked state.
  • (@GermanBluefox) Security: fixed a path traversal in the card and icon routes (/cards/, /hacsfiles/, /local/custom_ui/, /static/icons/) that allowed reading arbitrary files without authentication. All static file routes now verify that the resolved path stays inside the served folder.
  • (Garfonso/Claude) The map no longer shows an "API KEY REQUIRED" watermark: CARTO now requires a key for its tiles, so the base map comes from OpenStreetMap through the adapter (which caches the tiles).
  • (Garfonso/Claude) Expert attributes: a state of type array/object now arrives as an array/object instead of its JSON string, so cards like flex-table-card can iterate it.
  • (Garfonso/Claude) Custom cards: uploading a new version of a card over the old file works now. Their url carries the file's timestamp, so the browser loads the new one instead of its cached copy.
  • (Garfonso/Claude) Custom cards: the admin page shows the version a card reports about itself.
  • (Garfonso/Claude) The frontend is served precompressed (brotli) and cached for good, its entry points (index, service worker) are revalidated instead. This cuts the traffic of a remote connection (e.g. ioBroker.pro) roughly to a quarter and no longer hides a frontend update.
  • (Garfonso/Claude) Everything else (custom cards, the index page, api answers) is compressed on the fly now.
  • (Garfonso/Claude) The instance settings were rebuilt with jsonConfig: a real YAML editor for the themes, working theme dropdowns, upload/delete of custom cards with their version, and a searchable entity list. Needs admin 7.9.11 or newer. (#587)
  • (Garfonso/Claude) The new frontend draws its map with vector tiles: the adapter serves them, together with the TileJSON, the label fonts and the icon sprites, and answers the access-token request the frontend makes for them.
  • (Garfonso/Claude) Vacuums no longer claim the battery feature Home Assistant removed. A manually configured vacuum now gets the same battery sensor entity as an auto-detected one, so the charge level stays visible.
  • (Garfonso/Claude) Updated Browser Mod to 3.2.3 (from 2.13.5). Its settings are split in two pages now: the sidebar entry holds the settings of this browser, the registered browsers and the global/user settings moved to a page of their own behind it.
  • (Garfonso/Claude) Fixed global and per-user Browser Mod settings never being stored: those requests carry no browser id and were dropped.
  • (Garfonso/Claude) A default dashboard set in Browser Mod is honored now, for a user, for one browser or globally.
  • (Garfonso/Claude) Energy dashboard: the costs of import and export are calculated from the price configured for a source, so a fixed price (or a price entity) no longer shows 0.00.
  • (Garfonso/Claude) Custom cards: the adapter watches its cards folder, so a card added, replaced or deleted anywhere (file browser, settings page, command line) is picked up without pressing anything - a browser reload still imports a brand new card.
  • (Garfonso/Claude) Updated the dependencies (TypeScript 6, type-detector 6, webserver 3, suncalc 2, …) and replaced gulp with a plain node script.
  • (Garfonso/Claude) New device types of type-detector 6 become entities: fans and air purifiers (fan), pumps (a switch plus its measurements), air quality monitors (one sensor per value), contact sensors, CO alarms, pressure and flow sensors.
  • (Garfonso/Claude) Thermostats that only heat or only cool keep their target temperature: type-detector 6 reports that setpoint as SET_HEATING / SET_COOLING instead of SET.
  • (Garfonso/Claude) Fixed the sun entity's elevation and azimuth with suncalc 2, which answers in degrees and measures the azimuth from north.
  • (Garfonso/Claude) Custom cards: the file selector deletes a card now, the table is titled as the overview of the installed cards, and a link leads to the cards folder in the ioBroker file browser.
  • (Garfonso/Claude) Updated the Home Assistant frontend to 20260826.7: new alert card, date on the clock card, search in the media browser, more tile features (vacuum fan speed, light effects, thermostat humidity) and the map now uses sharper vector tiles.
  • (Garfonso/Claude) Statistics are converted into the unit the frontend asks for: an energy meter counting in Wh is no longer drawn as if it counted kWh, and the same for a power sensor in W. (#741)
  • (Garfonso/Claude) Repository checker: the missing translations of the expert attribute settings were added in all languages, the license section links to the LICENSE file, and the history timeout uses the adapter's own timer. (#725)

6.1.3 (2026-09-01)

  • (Garfonso/Claude) Fixed auto-generated entity_ids growing longer and longer within a single start for devices sharing a generated display name and having no own readable state (e.g. several buttons named the same): they no longer collapse onto the same internal registry key and overwrite each other's name.
  • (Garfonso/Claude) Fixed the energy dashboard's power graph showing "no data" for the whole day on some history backends: the "5minute" statistics period used a 30-second bucket step instead of 5 minutes, requesting 10x more buckets than needed.
  • (Garfonso/Claude) Fixed the current power missing in the energy dashboard ("Stromquellen" on the summary tab and the "Jetzt" tab) while all other cards showed it: the power sensor picked for a grid/battery source was not passed on to those cards. Existing configurations are fixed automatically on start.
  • (Garfonso/Claude) Devices that report a battery level (value.battery) now get a battery sensor entity, so the charge level is visible and can be graphed - previously only the low-battery warning was used. This also removes the "Unknown state BATTERY" log message. (#718)

6.1.2 (2026-07-20)

  • (Garfonso/Claude) History and logbook no longer show duplicate adjacent entries when the history backend re-logs unchanged values (e.g. InfluxDB "still record the same values"). (#711)
  • (Garfonso/Claude) Energy/statistics graphs no longer draw a phantom line into the future when the requested range ends after now (e.g. History carrying the last value forward).
  • (Garfonso/Claude) A browser with a broken browser_mod id (e.g. [object Object] in its localStorage) no longer spams "Used invalid characters" warnings: the id is sanitized, the client is asked to pick a fresh id, and leftover invalid instance objects are cleaned up on start.
  • (Garfonso/Claude) Fixed simple on/off lights with a separate read-only state (ON_ACTUAL): the real device state is subscribed again and pushed to the UI.

6.1.1 (2026-06-25)

  • (Garfonso/Claude) Fixed a crash (adapter restart loop) when a room enum has no name; the area list no longer brings the adapter down.
  • (Garfonso/Claude) Custom dialog: device classes are sorted with clearer labels (id + unit), missing classes were added, device/state class can be cleared, and has_time/has_date no longer cause spurious "unsaved changes".
  • (Garfonso/Claude) Auto-detected temperature/humidity/illuminance sensors now report state_class: measurement (for HA statistics).
  • (Garfonso/Claude) Custom dialog: device class is suggested from the state's unit, and state class from the unit, when unambiguous.

6.1.0 (2026-06-23)

  • (Garfonso/Claude) Remove HA-App Banner on iPhone (#418).
  • (Garfonso/Claude) New manual entity types device_tracker and person to show presence/GPS on the map, with object pickers for the presence and location states.
  • (Garfonso/Claude) Manual cover entities can now be configured with object pickers (e.g. an automatic window), reusing the full cover logic.
  • (Garfonso/Claude) Reorganized the user documentation into matching English and German pages under docs/en / docs/de (entities, cards & UI, features), linked from the README; development/build notes stay in the README.
  • (Garfonso/Claude) Fixed history/logbook stopping to load after a while (a hung history request could permanently block all following ones).
  • (Garfonso/Claude) Manual lock and media_player entities can now be configured with object pickers for their states.
  • (Garfonso/Claude) Vacuum cleaners are now supported (auto-detection + manual object pickers): start/stop/pause, fan speed and battery.
  • (Garfonso/Claude) New manual entity types humidifier and water_heater, configurable with object pickers.
  • (Garfonso/Claude) Manual light and climate (thermostat) entities can now be configured with object pickers (brightness/colour/temperature, target/mode/…), reusing the full converters.
  • (Garfonso/Claude) Fixed room and function being swapped in the auto-generated name of advanced lights.
  • (Garfonso/Claude) Manual device_tracker/person entities can get a picture (entity_picture) from a fixed URL or a state, plus a battery level and (device_tracker) a source type.
  • (Garfonso/Claude) More manual-entity options: cover tilt open/close/stop, light white/RGBW/CIE colour states, sensor state class, humidifier device class.
  • (Garfonso/Claude) Manual fan entities now have object pickers (on/off, speed/preset, oscillation, direction).
  • (Garfonso/Claude) Vacuum can show its map (URL or base64 state) as the entity picture.
  • (Garfonso/Claude) Removed plant, weblink and history_graph from the manual entity types (no longer Home Assistant entity domains).

License

The full license text is in LICENSE.

Copyright (c) 2019-2026, bluefox dogafox@gmail.com

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.