homebridge-config-ui-x/CHANGELOG.md

A web based management, configuration and control platform for Homebridge.

# Change Log

All notable changes to `homebridge-config-ui-x` will be documented in this file. This project tries to adhere to [Semantic Versioning](http://semver.org/).

## v4.72.0 (2025-03-22)

### ⚠️ Upcoming Deprecations:

- The **next major version** `v5` of the Homebridge UI will:
  - Be compatible with Homebridge `v1` and `v2`
  - Drop support for Node.js `v18` and earlier, so please update to `v20` or `v22` - [more info on updating](https://github.com/homebridge/homebridge/wiki/How-To-Update-Node.js)
  - Drop support for Raspberry Pi devices running on the `armv6` architecture (like the Pi 1 and Pi Zero) - please update your hardware
  - Drop support for instances using `pnpm` as the package manager - consider updating your Homebridge instance to use npm instead - [more info on updating](https://github.com/homebridge/homebridge-apt-pkg/blob/latest/README.md#using-apt)
- Note that Homebridge UI `v5` will not be released before May 2025 (aligning with when Node.js `v18` reaches end-of-life)
- Note that these are not requirements for UI `v4.72.0`

### UI Changes

- updates to the `th.json` language file (#2365) (@tomzt)
- updates to the `es.json` language file (#2376) (@kyrokode)
- updates to the `id.json` language file (#2377) (@dwaan)
- updates to the `ru.json` language file (#2384) (@SeregaTarasov)
- fixed issue with UI config incorrectly reporting as invalid
- don't allow adding multiple config blocks for singular plugins

### Other Changes

- updated dependencies

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v2.0.6`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.11.14`
- `@homebridge/plugin-ui-utils` @ `v2.0.1`

## v4.71.2 (2025-02-23)

### Other Changes

- fix alpha/beta update checks for bundled ui (#2363) (@dnicolson)
- fix ui config validation when default theme selected

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v2.0.5`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.11.14`
- `@homebridge/plugin-ui-utils` @ `v2.0.1`

## v4.71.1 (2025-02-22)

### UI Changes

- updates to the `uk.json` language file (#2352) (@xrust83)
- add missing add section button to plugin config screens
- improve active/stale bridge detection
- fix error state on plugin search input

### Other Changes

- re-add `reflect-metadata` to `dependencies` in `package.json`

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v2.0.5`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.11.14`
- `@homebridge/plugin-ui-utils` @ `v2.0.1`

## v4.71.0 (2025-02-09)

### UI Changes

- updates to the `uk.json` language file (#2348) (@xrust83)
- allow docker users to disable the UI terminal via env
  - set `HOMEBRIDGE_CONFIG_UI_TERMINAL_ENABLED=0`
  - note that this has not been extensively tested
- fix opening control accessory modal on mobile devices

### Other Changes

- update `@ng-formworks/` dependencies

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v2.0.5`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.11.14`
- `@homebridge/plugin-ui-utils` @ `v2.0.1`

## v4.70.0 (2025-02-08)

### UI Changes

- updates to the `th.json` language file (#2338) (@tomzt)
- improvements to long-click accessory control
  - also fixes accessory and room rearranging on the accessories page
  - accessory and status page layout will now be locked by default on each visit
- add message for docker/synology users in node update info modal

### Other Changes

- append `--omit=dev` to `npm i` commands
- clean up `npm` cache before any install/uninstall

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v2.0.5`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.11.14`
- `@homebridge/plugin-ui-utils` @ `v2.0.1`

## v4.69.0 (2025-01-25)

### ⚠️ Plugin Config Validation

This version of Homebridge UI adds validation to plugin config screens. This does not apply to manual plugin configuration (with raw `JSON`).

- If your entered configuration is valid, then you will see a green tick by the save button.
- If your configuration is not valid, then you will see an orange warning triangle by the save button. You will still be allowed to save the configuration.
- A plugin can enforce strict validation:
  - For plugin developers: if you want to enforce a valid configuration, you can add `"strictValidation": true` as a root property to your `config.schema.json` file.
  - For users: if the plugin developer has enabled this setting and your configuration is invalid, then you will see a red warning triangle by the save button. You will not be allowed to save the configuration until it is valid.

If you have a plugin which can be configured multiple times, then an icon will be shown on each configuration block.

Plugin developers:

- Please do not rely on this validation and assume that a user's configuration will be valid: you should still validate the user's config on plugin startup
- Remember that some users do not use the UI at all, and other users may prefer to configure using raw `JSON` rather than config screens
- For custom UI screens, the validation icon will be hidden when the save button is disabled (using `homebridge.disableSaveButton()` from `@homebridge/plugin-ui-utils`)
- Please report any cases where the validation is not working as expected

### UI Changes

- updates to the `uk.json` language file (#2312) (@xrust83)
- updates to the `cs.json` language file (#2332) (@DavidHuljak)
- fix typos in hb/ui settings schemas (#2317) (@dnicolson)
- fix margins in update plugin modal
- add plugin config validation functionality
- refactor status and child bridge widgets
  - the existing 'status' widget has been renamed to 'update info' widget
  - the existing 'child bridges' widget has been renamed to 'bridges' widget
  - the homebridge status (from the old status widget) is now shown as a bridge in the new bridges widget
  - node update information has been added to the new update info widget
    - a widget option has been added to hide node update information: this may be useful for docker/synology users
  - homebridge and ui version information has been moved from the footer to the new update info widget
- add 'homebridge name' setting to settings page
- migrate bootstrap from `v4` to `v5`
- fix plugin config/bridge screens for certain plugins
- add lighting mode option for terminal and log widgets
  - only available when the UI is already in light mode
- fix long press on mobile devices
- control fan rotation direction from the ui

### Other Changes

- improvements to GH actions and build processes (@NorthernMan54)

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v2.0.5`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.11.14`
- `@homebridge/plugin-ui-utils` @ `v2.0.1`

## v4.68.0 (2025-01-08)

Happy 2025 to all our users! 🎉

### UI Changes

- updates to the `cs.json` language file (#2311) (@DavidHuljak)
- improved messaging on plugin child bridge modal
- further improvements to plugin search
- implement and allow switching to scoped plugins
- merge plugin info and verified modals
  - condensing plugin card into title + three lines of description
- consistent formatting of child bridge names across the ui
- general improvements across the ui
  - status page:
    - individual widget setting form design made consistent with other forms
    - added pairing status to qr code widget
  - plugins page:
    - visual improvements to plugin child bridge settings modal
    - allow plugins to disable/enable the save button in custom uis (see below section)
    - allow configuring [multiple accessories on the same child bridge](https://github.com/homebridge/homebridge/wiki/Child-Bridges#multiple-accessories-on-the-same-child-bridge) via the ui
  - accessories page:
    - changed accessory spanner icon to info icon (more descriptive)
    - accessory info modal redesigned and provides more info where possible like the accessory UUID (including a link to remove from the cache)
    - added support modal with some info about rooms and accessories (visible on desktop)
  - json config page:
    - redesigned restore modal to be more consistent with other modals
  - settings page:
    - chevron icons replaced with arrow-right icons
    - removed restore modal from settings page and is accessible from the backup modal
    - backup modal redesigned to be more consistent with other modals
    - added new display -> menu mode setting which allows keeping the side menu from expanding out on desktop
    - redesigned and improved accessories and bridges sections and modals
  - users page:
    - add user and edit user modals redesigned to be more consistent with other modals
    - user card updated with icon buttons for edit/delete rather than text buttons

### Plugin Custom UI Changes

The UI has recently been updated with `@homebridge/plugin-ui-utils` @ `v2.0.0`, which includes a new feature to allow plugin developers to dynamically enable and disable the `Save` button in the custom UI modal.
Two new methods have been added for this purpose:

- `homebridge.disableSaveButton()`
- `homebridge.enableSaveButton()`

Developers: to maintain compatibility with older versions of the Homebridge UI, it is recommended to check if the methods exist before calling them in your custom UIs:

- `homebridge.disableSaveButton?.()`
- `homebridge.enableSaveButton?.()`

### Other Changes

- auto-fix ui theme setting property if existing value is not valid
- do not allow `armv6l` users to update to UI `v5`

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v2.0.5`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.11.14`
- `@homebridge/plugin-ui-utils` @ `v2.0.0`

## v4.67.0 (2024-12-28)

### UI Changes

- add explanation of deleting child bridges when un-toggling
- add filtering to search to improve results (#2286) (@justjam2013) (fixes [#2266](https://github.com/homebridge/homebridge-config-ui-x/issues/2266))
- fix spacing issue with hidden accessories
- make margins consistent of un/lock buttons on status screen
- fix ui not restarting properly after updating the ui
- use broom icon in remove bridge accessories (to match similar modal from plugin menu)

### Other Changes

- improve and finish up previous angular migration
- update `hap-client` + `plugin-ui-utils` hb dependencies
- update dependencies
- improve lint sorting of imports

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v2.0.5`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.11.14`
- `@homebridge/plugin-ui-utils` @ `v2.0.0`

## v4.66.0 (2024-12-25)

### UI Changes

- fix verified plugins link in support module (fixes [#2295](https://github.com/homebridge/homebridge-config-ui-x/issues/2295))
- add missing modal footer `<div>`s to accessory control modals
- fix radio button groups in certain accessory control modals (fixes [#2294](https://github.com/homebridge/homebridge-config-ui-x/issues/2294))

### Other Changes

- format svg files nicely as part of lint
- upgrade angular from `v18` to `v19`
- delete unpaired bridges when toggling bridges off (#2284) (@justjam2013) (fixes [#2257](https://github.com/homebridge/homebridge-config-ui-x/issues/2257))

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v1.10.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.11.14`
- `@homebridge/plugin-ui-utils` @ `v1.0.3`

## v4.65.2 (2024-12-15)

### UI Changes

- Rollback recent changes to plugin search (#2289) (@justjam2013)

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v1.10.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.11.14`
- `@homebridge/plugin-ui-utils` @ `v1.0.3`

## v4.65.1 (2024-12-13)

### UI Changes

- updates to the `th.json` language file (#2271) (@tomzt)
- updates to the `de.json` language file (#2250) (@Staubgeborener)
- Remove unrelated plugins from search (#2272) (@justjam2013)

### Other Changes

- fix types + update dependencies
- fix attach artifacts to release workflow

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v1.10.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.11.14`
- `@homebridge/plugin-ui-utils` @ `v1.0.3`

## v4.65.0 (2024-12-08)

### UI Changes

- updates to the `uk.json` language file (#2262) (@xrust83)
- logo and `homebridge` text should link to status page
- Add icons for shower head and water faucet valve types (#2267) (@justjam2013)
- Removed conditional for displaying search exit component (#2269) (@justjam2013)

### Other Changes

- Fix typo in console message (#2264) (@markholland)
- updated dependencies

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v1.10.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.11.14`
- `@homebridge/plugin-ui-utils` @ `v1.0.3`

## v4.64.0 (2024-11-30)

### UI Changes

- updates to the `de.json` language file (#2249) (@Staubgeborener)
- updates to the `ko.json` language file (#2251) (@alphaorderly)
- updates to the `uk.json` language file (#2255) (@xrust83)
- add reload menu item when using as a PWA

### Other Changes

- dependency updates
- fix npm search max character limit

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v1.10.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.11.14`
- `@homebridge/plugin-ui-utils` @ `v1.0.3`

## v4.63.0 (2024-11-17)

### UI Changes

- updates to the `th.json` language file (#2211) (@tomzt)
- updates to the `nl.json` language file (#2213) (@tooh)
- updates to the `es.json` language file (#2235) (@AxelDreemurr)
- updates to the `fi.json` language file (#2218, #2229) (@l1500s)
- fix widget config saving on dashboard
- use native language for validation messages where available
  - currently available for `de` `en` `es` `fr` `it` `pt` `zh`
- switch from a top menu to a sidebar menu
- show pairing status for bridges around the ui
- consistent labels for sensor-type accessories
- update default dashboard layout
- remove pnpm warning modal
- use smoke detector icon for carbon monoxide and dioxide sensors

### Other Changes

- migrate `@zajsf/*` to `@ng-formworks/*` for plugin schema forms
- check for service mode when querying child bridge status
- perform a full restart when updating `homebridge`

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v1.10.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.11.14`
- `@homebridge/plugin-ui-utils` @ `v1.0.3`

## v4.62.0 (2024-10-19)

### UI Changes

- Create fi.json (#2205) (@l1500s)
  - The Homebridge UI is now available in 28 different languages!
- updates to `fi.json` language file (#2206) (@l1500s)
- updates to `ru.json` language file (#2207) (@SeregaTarasov)
- add plugin list modal for updating to hb v2.0
- change placement of page header tooltips to bottom
- single modal for showing/hiding widgets
- option to delete a scheduled backup file
- option to restore a scheduled backup file
  - without the need to download and upload it
- backup modal - move generate now button to list
- add finnish to available languages and settings

### Other Changes

- relocate `disable-plugin` component to `core/plugins` module

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v1.10.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.11.14`
- `@homebridge/plugin-ui-utils` @ `v1.0.3`

## v4.61.0 (2024-10-11)

### UI Changes

- fix login wallpaper setting field should in safari
  - it should not be offering to populate with a username/password from credentials manager
- move docker startup script to settings
  - this was in the power options module, and is now at the bottom of the 'startup & environment' section in the settings module
- consistent designs for power options modules
  - in particular, the `restart`, `docker-restart`, `linux-restart` and `linux-shutdown` modules
- fix checkboxes widget in plugin config screens (fixes [#2200](https://github.com/homebridge/homebridge-config-ui-x/issues/2200))
- fix json block switching in manual plugin config

### Other Changes

- update angular build tool to `application`

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v1.10.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.11.14`
- `@homebridge/plugin-ui-utils` @ `v1.0.3`

## v4.60.1 (2024-10-06)

### UI Changes

- fix gsh plugin custom ui
- network widget - explain why ni list is empty

### Other Changes

- update some repo screenshots

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v1.10.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.11.14`
- `@homebridge/plugin-ui-utils` @ `v1.0.3`

## v4.60.0 (2024-10-05)

- ⚠️ After updating to this release, you may find that your UI theme resets to the default. This reset will only occur once. You can visit the settings section to change it back to your preferred theme.
- ⚠️ If you use the `/api/auth/settings` endpoint (e.g. in a custom application), please note that this endpoint now returns less information for an unauthenticated user.
  It will return a full payload when a valid access token is provided.

### UI Changes

- added more notification messages to translation files
- settings option to clear accessory cache for a specific bridge
  - only available when running in service mode
- enable child bridge by default when installing a plugin
- change icon of plugin manage version feature
- add a reset accessories feature to the plugin card
  - only available when running a plugin in a child bridge and in service mode
- add warning for older homebridge apt package users still running `pnpm`
- split light/dark mode from themes, auto-change with browser changes
- move login wallpaper from advanced settings to main settings
- updates to `pl` language file (#2194, #2197) (@mkz212)
- use new child bridge restart modal for after plugin config changes
- open plugin config screen automatically after install plugin
- open plugin logs screen automatically after update plugin
  - this will only pop up when the plugin is running in a child bridge, and Homebridge does not need to be restarted
  - if this turns out to be an unpopular addition then it can be reverted in a future release!
- ui small tweaks to when buttons are loading/disabled
- another attempt to fix tooltips appearing in front of modals
- re-add 'lost' deep purple theme colour

## Other Changes

- upgrade `angular` from `v15` to `v16`
- upgrade `angular` from `v16` to `v17`
- upgrade `angular` from `v17` to `v18`
- upgrade and re-patch `@zajsf/` dependencies
- upgrade some ui dependencies
  - upgraded `ng2-charts` and `ngx-md` to most recent major versions
  - move from `ngx-monaco-editor` to `ngx-monaco-editor-v2`
- add `css` linting to ui, fixed existing issues
- add `html` linting to ui, fixed existing issues
- upgrade `@ng-bootstrap/ng-bootstrap` and fix accordions

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v1.10.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.11.14`
- `@homebridge/plugin-ui-utils` @ `v1.0.3`

## v4.59.1 (2024-09-30)

### UI Changes

- fix some log settings are not visible in service mode (#2196) (@NorthernMan54)
- fix restart not appearing on first plugin save
- fix tooltips appearing over modals

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v1.10.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.11.14`
- `@homebridge/plugin-ui-utils` @ `v1.0.3`

## v4.59.0 (2024-09-27)

### UI Changes

- The following change only applies when running Homebridge 2.0-beta
  - allow a `Debug Mode` setting per child bridge:
    - this can be configured in the child bridge modal
    - the general `Homebridge Debug Mode` now only applies to the main Homebridge bridge
- increase width of notifications to `100%` on mobile devices
- fix some styles on smaller screeners
- hide settings section description on collapse
- improve visibility of restart button in settings
- allow translation for incorrect system date/time notification
- consistent modal titles and remove unused lang strings
- move lang, theme, temp units + port to main settings
  - relabelled the UI settings screen as 'UI Advanced Settings'
- offer to unpair child bridges when uninstalling plugins
- offer to set up a child bridge immediately after configuring a new plugin
- lang: clarify cached is removed when unpairing bridge
- make input placeholder colour lighter in light mode
- updates to `pl` language file (#2181, #2189) (@mkz212)
- updates to `th` language file (#2182) (@tomzt)

### Other Changes

- consistent code lint across the server and ui components
- use `vitest` for testing
- no longer use `webpack`
  - the final size of the `npm` package is actually higher with `webpack` than without
- update dependencies, overrides, updated lint
- `.toPromise()` is deprecated, change to `firstValueFrom()`
- fix deprecated `.subscribe()` signature
- HB2 plugins: also check for `>=2` from `engines.homebridge`
- update dependencies - tackle dependabot alerts
- move script files to own folder, improve error catching in `sh` scripts
- use params for text replacements of backup size modal
- variable naming consistency, reduce language string lengths
- pack only necessary `monaco-editor` files
  - this has reduced the unpacked size of the unpacked `npm` package from `~16.6MB` to `~11.0MB`
- fix console errors in some settings modals, update `nestjs` dependencies

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v1.10.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.11.14`
- `@homebridge/plugin-ui-utils` @ `v1.0.3`

## v4.58.0 (2024-09-08)

- ⚠️ The minimum version of Homebridge needed for the "child bridge extra configuration" functionality is `v1.8.0`. The UI will continue to work with Homebridge `v1.6.0` or later, however it is always recommended to run the latest version of Homebridge anyway.

### UI Changes

- added warning messages for backup files too large to be restored (@NorthernMan54)
- hide node update available icon for synology users
- various updates to widgets:
  - hide the add widget button when the layout is locked
  - only show the settings cog and draggable cursor on bigger screens and when layout is unlocked
  - add config options for:
    - CPU widget: added refresh interval and number of data points to show in the graph
    - Homebridge widget: don't show plugins as up to date until the check has been completed
    - Memory widget: added refresh interval and number of data points to show in the graph
    - Network widget: added refresh interval and number of data points to show in the graph
- updates to `zh-TW` language file (@tasict)
- updates to `de` language file (@Staubgeborener)
- updates to `th` language file (@tomzt)
- updates to `sv` language file (@emilof)
- updates to `pl` language file (@mkz212 + @grzegorz914)
- updates to `uk` language file (@xrust83)
- add `log.maxSize`/`log.truncateSize` options (#2161) (@tjenkinson)
- fix missing translation string in setup wizard
- various ui improvements and code consistency, including:
  - new design for the 'manage version' plugin modal
  - updated language strings in some of the settings modals
  - renamed settings sections to be more descriptive (same functionality)
    - `Remove Single Cached Accessory` → `Remove Single Accessory`
    - `Remove All Cached Accessories` → `Remove All Accessories`
    - `Unpair Bridges / Cameras / TVs / External Accessories` → `Unpair Single Bridge`
    - `Reset Homebridge Accessory` → `Unpair All Bridges`
  - restart Homebridge modal will now appear when closing the unpair single bridge modal (only if at least one bridge is unpaired)
- offer more info about behaviour when disabling a plugin (on disable plugin modal)
- change the 'power options' screen from a modal to a page
- allow child bridge extra configuration in the child bridge modal (requires Homebridge 1.8.0 or above)
- minor adjustments to settings page, add expands
- improve plugin compatibility checker
  - this will now compare your Homebridge and node versions against a version of a plugin you are going to install, rather than the version you currently have installed
  - the check will be run when you are installing a plugin, updating a plugin and installing an alternate version of a plugin

### UI Fixes

- fix html parts in `ca`, `fr` + `sl` language files
- update name of `mobile-web-app-capable` meta tag (from `apple-mobile-web-app-capable`)
- support plugins with dots in their @scope (#2171) (@gtalusan)

### Other Changes

- remove unused language strings from i18n files
- rename instances of `BatteryService` to `Battery`
- update `@ngx-translate/core` and `angular-gridster2`
- make use of `overrides` in the `package.json` files to patch dependency vulnerabilities
- support node 22

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v1.10.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.11.14`
- `@homebridge/plugin-ui-utils` @ `v1.0.3`

## v4.57.1 (2024-08-26)

### UI Changes

- hide and show config editor action buttons based on current action

### UI Fixes

- fix edge case of hiding child bridge setup (when plugin update is available)
- fix pkg engines, take from installed version not npm

### Other Changes

- remove useless angular `OnInit`s
- created shared global defaults pattern to allow sharing defaults between server and ui (@NorthernMan54)

## v4.57.0 (2024-08-26)

### UI Changes

- show UI messages when node 22 updates available
  - note that Homebridge, the UI, and plugins do not yet need to support Node.js 22
  - update notifications for Node.js 22 will only be shown if you are **already** running Node.js 22
- add a Homebridge v2.0 readiness badge to each installed plugin card with a modal explaining what it means
  - a tick will show if you are running Homebridge v1 and the plugin has been marked as supported v2
  - a cross will show if you are running Homebridge v1 and the plugin has not been marked as supported v2
  - no icon will be shown if you are already running a Homebridge v2 beta version

### Other Changes

- EventEmitter memory leak warnings when you have a significant number of child bridges. (#2087) (@hjdhjd)
- run improved linter on non-typescript files
- remove unused `.prettierrc` file
- updated dependencies
- obtain verified plugin tarballs from `homebridge/verified` repo
- ignore `.cache` folder when creating backup files (@paulk4633)
- add `xterm-addon-web-links` to angular allowed cjs
- fixes for angular build, fix for readiness icon

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v1.10.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.11.14`
- `@homebridge/plugin-ui-utils` @ `v1.0.3`

## v4.56.4 (2024-06-25)

### Other Changes

- Temporarily add maintainers to package.json to handle NPM schema change (#2080) (@PatrickStankard)

## v4.56.3 (2024-06-22)

### Other Changes

- Check that `pkg.maintainers` is defined before checking its length (#2069) (@PatrickStankard)

## v4.56.2 (2024-04-27)

### Fixed

- shared use of `commander` between homebridge and UI

### Other Changes

- Prepare for tags with prefix of `v`
- Update Discord Webhook
- Update Pre Release Process
- calculate GitHub release name, may differ with v or not

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v1.10.0`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.11.12`
- `@homebridge/plugin-ui-utils` @ `v1.0.2`

## v4.56.1 (2024-04-03)

### Bug Fixes

- drop `@homebridge/node-pty-prebuilt-multiarch` to `v0.11.12` (resolves `git` requirement)

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v1.10.0`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.11.12`
- `@homebridge/plugin-ui-utils` @ `v1.0.2`

## v4.56.0 (2024-04-02)

### UI Changes

- improve power options button display (#1961) (@mkz212)
- update credits modal with supporters
- add warning to remove-single-cached-accessory (#1985) (@mkz212)
- refactor backup and restore modals, separate items on settings page
- standardise modal sizes
- standardise warning sections on settings modals
- minor adjustments to settings page
- update icons on settings page (#1990) (@mkz212)
- break-word in plugin config (#1993) (@mkz212)
- Fix crash with missing homepage package.json property (#2013) (@regaw-leinad)
- improve ui of settings page (#2016) (@mkz212)
- improve ui of settings page (#2026) (@mkz212)
- remove mdns interface tooltips
- network interface widget: custom interface
- fix status widget graphs
- add 'report an issue' link to plugin menu
- configurable action button class on confirm component
- refactor widget settings view with styled checkboxes
- refactor accessory info view with styled checkboxes
- remove NPM/GitHub icons from plugin modals
- refactor user add/edit with styled checkboxes
- hide plugin logs menu item when plugin is disabled
- refactor add room button and modal

### Translation Changes

- updates to uk.json language file (#1978) (#1979) (@xrust83)
- updates to th.json language file (#1982) (@tomzt)
- updates to fr.json language file (#1991) (@SonnyT72)
- updates to ja.json language file (@yima0913)
- Correct slow restart message (#2006) (@jamieburchell)
- updates to es.json language file (#2020) (@AxelDreemurr)

### Other Changes

- improve GitHub actions
- fixed Environment Info selection on bug and support templates
- add wiki change request issue template
- removed force of earlier version of `bonjour-service` as a fix has been implemented in latest version
- updated release drafter template so releases do not start with a `v`
- updated special plugin lists
- check local dir for homebridge when running dev
- dependency updates
- update `@homebridge/` dependencies
- standardise CHANGELOG to same as `homebridge`
- standardise README to same as other hb repos

## v4.55.1 (2024-01-07)

### Bug Fixes

- Force earlier version of `bonjour-service` to resolve [#1973](https://github.com/homebridge/homebridge-config-ui-x/issues/1973) and [#1975](https://github.com/homebridge/homebridge-config-ui-x/issues/1975)
  - **If you experienced this issue, we would recommend you go into Homebridge Setting and turn off Homebridge 'Insecure' Mode (Enable Accessory Control) before upgrading**, after you upgrade you can re-enable.

### Translation Changes

- updates to fr.json language file (#1974) (@SonnyT72)

### Other Changes

- attach artifacts to workflows
- update issue templates

## v4.55.0 (2024-01-06)

### UI Changes

- Add plugin log download button
- Improve plugin card hyperlinks (#1918) (@jsiegenthaler)
- Download logs option for when a plugin install/update/uninstall fails
- revise system information icons (os/node)
- accessory title fix (lights + windows) (#1933) (@mkz212)
- improve spacing in plugin card
- more items in homebridge settings
- confirm restart after updating Homebridge instead of automatically restarting
- improve child bridge sing/plu in dropdown
- move backup/restore + users to hb settings
- move hb/ui settings to main menu
- create standard settings page + link at top
- small changes to plugin card (based on feedback)
- fix overflow in markdown changelog
- plugin card updates
- added credits link in status footer and modal for credits
- added more `aria-label` attributes to buttons to improve accessibility
- add link to homebridge wiki in logs on plugin action error
- allow fan/fanv2 rotation speed to be a different unit than percentage
- improve plugin sorting, with actionable plugins at the top
- fix footer paddings for mobile and desktop (#1956) (@mkz212)
- no need to restart if updating disabled plugin
- standardise update modal header

### Translation Changes

- updates to pl.json language file (#1929) (@mkz212)
- updates to de.json language file (@Staubgeborener)
- updates to fr.json language file (@SonnyT72)
- updates to de.json language file (#1953) (@Staubgeborener)
- updates to pl.json language file (#1954) (@mkz212)

### Other Changes

- add `passport` as dependency to BE
- revert ngx-monaco-editor dependency update
- ui: update to angular v15
- improve GitHub actions
- Fix for backup service including npm's cache (#1949) (@sapireli)
- updated dependencies
- ignore `.venv` in hb backup files
- updated Discord Webhooks so notifications are seperated for `release` and `pre-release`
- update maximum file upload size to 25mb

## v4.54.2 (2024-01-02)

### Bug Fixes

- Missing "passport" package from Synology builds - https://github.com/homebridge/homebridge-syno-spk/issues/141

## v4.54.1 (2023-12-08)

### Bug Fixes

- Restore missing 'set up child bridge' option on plugin card when system doesn't automatically recommend it
- Fix artifact attachment GitHub workflow

### Other Changes

- Do not attach artifacts to GitHub releases if the tarball is smaller than 10MB

## v4.54.0 (2023-12-05)

Merry Christmas and Happy Holidays to all our users celebrating later this month! :christmas_tree:

### Notable Changes

- Homebridge UI removed from the plugins page
  - Status and update notifications moved to the status page (next to / under Homebridge itself)
  - UI settings is accessible from the main menu
- Various changes to the plugin cards
  - Plugin settings now accessible from the plugin card menu, called 'Config'
  - Icons: plugin devs can request an icon for their verified plugin at:
    - https://github.com/homebridge/plugins/issues/new/choose

### UI Changes

- add power options modal (#1820)
- remove hb-ui card from plugins page (#1830)
- add some support links (#1833)
- add plugin logs feature (#1834)
- update module headers (#1836)
- add plugin homepage link to UI settings screen
- add icons to main menu
- Add All Config Options to UI Settings (#1838)
- add spanner settings icons to hb+ui on status
- add modal to explain unverified plugin status
- refactor main page sub-icons
- add new concept for plugin card with icons
- always show 'Accessories' tab to show issue in UI if insecure mode is not enabled
- for plugins that don't have a GitHub domain homepage, try parsing the bugs URL to be able to obtain release information

_Thanks to @mkz212 for his contributions to the UI_

### Translation Changes

- Add missing DE translations for child bridges (#1825) (@jsiegenthaler)

_Also thanks to @mkz212 and @Staubgeborener for their contributions to the translation files_

### Other Changes

- update GitHub release workflow (#1818)
- add generic restart hb modal, future use (#1821)
- Add Raspberry Pi 5 to list of Pi devices in bug-report template (#1824) (@jsiegenthaler)
- add api work for plugin icons
- update dependencies
- save bugs link as part of `IPackageJson` type

## v4.53.0 (2023-11-24)

Happy Thanksgiving to our American friends! :turkey:

- ⚠️ The minimum version of Homebridge needed for this version of UI is `v1.6.0`. If you are running a lower version of Homebridge, you should consider updating before installing this UI update.

### UI Changes

- Add Child Bridge Pin Code (#1739)
- standardise modal footers (#1753)
- Fix table width, avoid overflow (#1758) (@jsiegenthaler)
- add UI details to status widget (#1789)
- modal pics + node update modal (#1806)

### Translation Changes

- **i18n:** Update fr.json (#1705) (@SonnyT72)

### Other Changes

- Add Alpha Releases (#1740)
- update dependencies (#1745)
- update GitHub release workflow (#1746)
- ui lint sort imports and exports (#1750)
- update lang sync - remove old translations (#1751)
- various code improvements + simplifications (#1754)
- remove node 11 polyfill from self-check (#1777)
- remove old hb checks, import functions directly (#1780)
- stricter lint rules in api and ui (#1783)
- graceful fail when issue with node dist list response (#1800)
- Update node-pty-prebuilt-multiarch to 0.11.12

## v4.52.3 (2023-11-14)

### Bug Fixes

- Fixes for #1698, update-node failing with npm not found

## v4.52.2 (2023-11-11)

### Notable Changes

- Prevent the UI from updating when running an unsupported version of Node.js
  - This mimics the behaviour of updating Homebridge itself
  - The option of 'Update Anyway' will still appear for other plugins when running an unsupported version of Node.js
  - GLIBC Version is now cached
- When uninstalling a plugin, it will also be removed from the disabled plugin list if it was previously disabled

### UI Changes

#### General

- Fixed icon widths throughout UI
- Updated menu (thanks [@mkz212](https://github.com/mkz212)!)
  - Added links to main dropdown menu: 'Logs' and 'Restart Homebridge' + reordered list
  - Changed the menu layout order
  - Made the dropdown darker in dark mode ([#1660](https://github.com/homebridge/homebridge-config-ui-x/pull/1660))
  - Username is now displayed by logout Menu option

#### Status Page

- Updated default layout
- **System Information Widget**
  - Update ordering of rows
  - Added `Node.js Path` and `Plugin Path` rows
  - Added alert icon and modal when running an older OS that cannot update to Node.js 18/20
  - Added alert icon and modal when not running in service mode
- **Homebridge Widget**
  - Added ability to scroll Homebridge widget ([#1651](https://github.com/homebridge/homebridge-config-ui-x/pull/1651))
  - 'Update available' icons are now up-arrows to match plugins page

#### Plugins Page

- Enhanced the 'Restart Homebridge Now' modal to now Show 'Restart Child Bridges' modal after any plugin update if that plugin is set up as a child bridge
- Change plugin options dropdown icon to vertical ellipsis for consistency with restart Homebridge icon in top menu
- Move plugin homepage link to plugin options dropdown
- Move Homebridge UI API link to plugin options dropdown
- Hide 'Donate' and 'Verified' text (on plugin tiles) on small screens
- 'Verified' text on plugin tile now opens a modal rather than linking to Homebridge wiki
- When `Update Availble`/`Beta Update Available` are available an arrow icon is now displayed by Plugin menu icon
- Added icons to plugin statuses: 'Installed' and 'Not Installed'

### i18n Changes

- The following new language strings have been added to each language file - calling on all our translators to continue your hard work!
  - ADDED:
    - `child_bridge.label_child_start`
    - `child_bridge.label_child_stop`
    - `menu.hbrestart.confirm_button`
    - `menu.hbrestart.confirmation`
    - `menu.hbrestart.title`
    - `menu.linux.label_logs`
    - `plugins.button_api_documentation`
    - `plugins.button_homepage`
    - `plugins.manage.child_bridge_button_restart_now`
    - `plugins.manage.child_bridge_button_restart_now_one`
    - `plugins.manage.child_bridge_restart_success`
    - `plugins.manage.child_bridge_restart_failed`
    - `plugins.manage.message_thanks_for_updating_restart_child_bridges`
    - `plugins.manage.modal_verified_cta`
    - `plugins.manage.modal_verified_message`
    - `plugins.manage.modal_verified_title`
    - `plugins.node_update_homebridge_ui_upgrade_and_try_again`
    - `status.widget.systeminfo.label_disabled`
    - `status.widget.systeminfo.label_enabled`
    - `status.widget.systeminfo.label_glibc_warning`
    - `status.widget.systeminfo.label_no`
    - `status.widget.systeminfo.label_nodejs_path`
    - `status.widget.systeminfo.label_yes`
    - `status.widget.systeminfo.modal_glibc_cta`
    - `status.widget.systeminfo.modal_glibc_message`
    - `status.widget.systeminfo.modal_glibc_title`
    - `status.widget.systeminfo.modal_servicemode_cta`
    - `status.widget.systeminfo.modal_servicemode_message`
    - `status.widget.systeminfo.modal_servicemode_title`
  - UPDATED:
    - `plugins.manage.message_thanks_for_updating_restart`
    - `plugins.donate.message_learn_more`
    - `status.message_code_scan_instructions`
- **i18n:** Update pl.json ([#1633](https://github.com/homebridge/homebridge-config-ui-x/pull/1633))
- **i18n:** Update fr.json ([#1629](https://github.com/homebridge/homebridge-config-ui-x/pull/1629))
- **i18n:** Update es.json (Improves Spanish localization) ([#1632](https://github.com/homebridge/homebridge-config-ui-x/pull/1632))

### Other Changes

- Updated dependencies, including `@homebridge/node-pty-prebuilt-multiarch` to `0.11.10` (thanks [@NorthernMan54](https://github.com/NorthernMan54)!)

## v4.52.1 (2023-11-04)

### Other Changes

- **i18n:** Update de.json ([#1627](https://github.com/homebridge/homebridge-config-ui-x/pull/1627))

### Bug Fixes

- Fix text in post-plugin-update modal which wasn't showing translated strings properly
- Revert HomeKit code formatting change

## v4.52.0 (2023-11-04)

### Notable Changes

- Show UI and plugin updates for newer beta versions when already running a beta version of the plugin
  - Note: this only works when a plugin uses a `beta` NPM tag for beta releases
- Show 'Restart Homebridge Now' modal (with additional messaging for child bridges) after any plugin update, not just the UI
- Update HomeKit Setup Code Format: 1234-5678, making it more consistent with the Home App [#1612](https://github.com/homebridge/homebridge-config-ui-x/issues/1612)

### i18n Changes

- The following new language strings have been added/updated to each language file - calling on all our translators to continue your hard work!
  - ADDED:
    - `plugins.manage.label_release_notes`
    - `plugins.manage.label_release_notes_beta`
    - `plugins.manage.message_thanks_for_updating_restart`
    - `plugins.status_update_beta_available`
  - UPDATED:
    - `plugins.manage.message_thanks_for_updating`

### Other Changes

- `hb-service` will now refuse to install `node` versions less than `16.18.0`
- Plugin node warning screen will appear when running a version of `node` lower than `18.15.0` (bumped up from `14.15.0`)
- UI node warning screen will appear when running a version of `node` lower than `18.15.0` (bumped up from `10.17.0`)
- Obtain correct beta branch name for Homebridge (and UI) ([#212b3eb](https://github.com/homebridge/homebridge-config-ui-x/commit/212b3eb1d5cb3ccda01fe2c3be711b80af4d5bf6))
- Rename pre-release npm tag from `test` to `beta` for consistency with other Homebridge repositories ([#86ea73f](https://github.com/homebridge/homebridge-config-ui-x/commit/86ea73ffd0b35f372a164ee42e17a996905cffb6))
- Updated dependencies
- Update `@homebridge/node-pty-prebuilt-multiarch` to version v0.11.8 (updated build process and back-level support for Synology DSM devices)

## v4.51.2 (2023-10-27)

### Bug Fixes

- Improved guard rails around the Node.js 20 update for environments that can not support Node.js 20 (#1604)
- Include commentary in the release notes about the possibility of needing to run `sudo hb-service rebuild` after updating, and how to determine if your system is compatible with Node.js 20.

## v4.51.1 (2023-10-25)

### Bug Fixes

- Blocks update-node from updating to version 20 on versions of Linux that don't support it and prevents this issue `node: /usr/lib/arm-linux-gnueabihf/libstdc++.so.6: version 'GLIBCXX_3.4.26' not found (required by node)` ([#3453](https://github.com/homebridge/homebridge/issues/3453))
- Fix for unable to update NodeSource based Node.js version ([#1603](https://github.com/homebridge/homebridge-config-ui-x/pull/1603))
- Colon Markdown emojis are not parsed as they are on GitHub ([#1601](https://github.com/homebridge/homebridge-config-ui-x/pull/1601))
- Prevent tooltip from displaying after Node.js modal ([#1600](https://github.com/homebridge/homebridge-config-ui-x/pull/1600))

## v4.51.0 (2023-10-23)

### Notable Changes

- **Node Support**

  - ⚠️ Node 16 has reached end-of-life and is no longer supported by the Homebridge UI.
    - Starting with v4.51.0, the Homebridge UI will no longer work with Node 16, only Node 18 and 20
    - Homebridge UI follows the same Node support schedule as Homebridge. See the [How-To-Update-Node.js](https://github.com/homebridge/homebridge/wiki/How-To-Update-Node.js) page in the Homebridge wiki for more information

- **Plugins**
  - Use plugin display name if available (#1582)

### Other Changes

- **System:**
  - Fixes for `Script https://deb.nodesource.com/setup_X is now deprecated` ( #1586 #1560 #1589 )
  - Updated backend dependencies (#1571 and #1569)
  - Updated frontend dependencies (#1572)
  - Update @homebridge/node-pty-prebuilt-multiarch to version v0.11.7 ( Node 20 Support and upstream refresh )

## v4.50.6 (2023-09-28)

### Bug Fixes

- **System:** Update comparison to timing safe ([1535](https://github.com/homebridge/homebridge-config-ui-x/pull/1535))

### Other Changes

- **i18n:** Update pt.json ([1503](https://github.com/homebridge/homebridge-config-ui-x/pull/1520))
- **i18n:** Use verb form for buttons and menu items ([1533](https://github.com/homebridge/homebridge-config-ui-x/pull/1533))
- **i18n:** Wait for custom UI ([1526](https://github.com/homebridge/homebridge-config-ui-x/pull/1526))
- Updated npm dependencies

## v4.50.5 (2023-08-19)

### Notable Changes

- **Plugins:** Add singular plug-in label ([1458](https://github.com/homebridge/homebridge-config-ui-x/pull/1477))

### Bug Fixes

- **System:** Fixed nested arrays settings ([1511](https://github.com/homebridge/homebridge-config-ui-x/pull/1511))
- **Plugins:** Homebridge UI now Waits for custom UI ([1523](https://github.com/homebridge/homebridge-config-ui-x/pull/1523))

### Other Changes

- **i18n:** Document the default port/address that you can access the UI in your web browser
- **i18n:** Improve translations ([1459](https://github.com/homebridge/homebridge-config-ui-x/pull/1459))
- **i18n:** Update zh-CN.json ([1503](https://github.com/homebridge/homebridge-config-ui-x/pull/1503))

## v4.50.4 (2023-05-12)

### Notable Changes

- **System:** Updates to workflow release process

## v4.50.3 (2023-05-12)

### Notable Changes

- **System:** Transfer of homebridge-config-ui-x support to the homebridge community. Tks Oznu for your efforts on this package.

### Bug Fixes

- **Backups:** Restore never starts on version 4.50.2 ([#1457](https://github.com/homebridge/homebridge-config-ui-x/issues/1457))
- **System:** hb-service update-node issue: Stops homebridge from starting ([#106](https://github.com/homebridge/homebridge-raspbian-image/issues/106))

### Other Changes

- **i18n:** No apostrophe in possessive "its" ([1450](https://github.com/homebridge/homebridge-config-ui-x/pull/1450))
- **i18n:** Update de.json ([1477](https://github.com/homebridge/homebridge-config-ui-x/pull/1477))

## v4.50.2 (2022-11-10)

### Notable Changes

- **Homebridge:** Add systemd-resolved Advertiser to UI ([#1430](https://github.com/oznu/homebridge-config-ui-x/pull/1430))

### Bug Fixes

- **Backups:** Backups now ignore symlinks, sockets, pipes etc.

## v4.50.1 (2022-08-09)

### Bug Fixes

- **Dashboard**: Fix an issue displaying the log viewer and terminal widgets on Chrome > 104 ([#1400](https://github.com/oznu/homebridge-config-ui-x/issues/1400))
- **Backups:** Fixed an issue restoring backups when the Homebridge storage directory is a symbolic link
- **Backups:** All symbolic links are de-referenced when performing a backup (the raw symlink is backed up, not what it pointed to)

### Other Changes

- **i18n:** Improvements to Ukrainian language translations ([#1390](https://github.com/oznu/homebridge-config-ui-x/pull/1390))
- **i18n:** Improvements to French language translations ([#1393](https://github.com/oznu/homebridge-config-ui-x/pull/1393))
- **i18n:** Improvements to Spanish language translations ([#1396](https://github.com/oznu/homebridge-config-ui-x/pull/1396))
- **i18n:** Improvements to German language translations ([#1399](https://github.com/oznu/homebridge-config-ui-x/pull/1399))

## v4.50.0 (2022-07-16)

### Breaking Changes

- Node.js v14.15.0 or later is **REQUIRED** - See [How To Update Node.js](https://homebridge.io/w/JTKEF)
- Dropped support for Node.js versions prior to v14. Do not update to this version if you are not running v14.15.0 or later

### Other Changes

- **i18n:** Improvements to Swedish language translations ([#1380](https://github.com/oznu/homebridge-config-ui-x/pull/1380))
- **i18n:** Improvements to Polish language translations ([#1389](https://github.com/oznu/homebridge-config-ui-x/pull/1389))
- Updated npm dependencies

### Bug Fixes

- **Backups:** Exclude `.npmrc` files from backups
- **Plugins:** A plugin with a [custom user interfaces](https://github.com/homebridge/plugin-ui-utils) will have it's optional `customUiPath` property re-evaluated when the package version changes ([#1379](https://github.com/oznu/homebridge-config-ui-x/issues/1379))
- **Plugins:** Prevent a plugin using symlink to define a `customUiPath` outside it's root directory
- **Plugins:** Changed "install previous version" to "Install Alternate Version" ([#1385](https://github.com/oznu/homebridge-config-ui-x/issues/1385))
- **Auth:** Fixed form validation for autofilled username and password ([#1388](https://github.com/oznu/homebridge-config-ui-x/issues/1388))

## v4.49.0 (2022-07-08)

### Notable Changes

- **Plugins** Faster, and hopefully more reliable, updater and installer for [Verified Homebridge Plugins](https://homebridge.io/w/Verified-Plugins) exclusively on the following platforms:
  - Debian-based Linux (via apt package): requires apt package update (=>1.0.27)
  - Docker: requires image update (=>2022-07-08)
  - Synology DSM 7: requires package update via DSM Package Center (=>3.0.7)
  - If the new install / update process fails, it will automatically fall back to using the standard `npm` update method

### Other Changes

- **i18n:** Improvements to Italian language translations ([#1373](https://github.com/oznu/homebridge-config-ui-x/pull/1373))
- **i18n:** Improvements to Korean language translations ([#1374](https://github.com/oznu/homebridge-config-ui-x/pull/1374))
- **i18n:** Improvements to Korean language translations ([#1375](https://github.com/oznu/homebridge-config-ui-x/pull/1375))

### Bug Fixes

- **Backups:** Fixed an issue that could prevent backups being created on Synology DSM due to not being able to read the `#recycle` directory
- **System:** Set a 60-second timeout on the pre-start job to clean up stale temporary npm directories on Linux running via `hb-service`; this should fix the errors some users were seeing when the task took more than the 90 seconds systemd allows by default ([#1371](https://github.com/oznu/homebridge-config-ui-x/issue