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/).

## v5.21.0 (2026-03-30)

### Important Notes

- ⚠️ This is a large update with significant changes under the hood. While we have tested, if you are running a mission-critical Homebridge instance, consider waiting a few days after release before updating.
  - You can report any issues you encounter on [GitHub](https://github.com/homebridge/homebridge-config-ui-x/issues), please check first as your issue may have already been reported.
- ⚠️ Homebridge UI now supports the last two versions of Chrome, Edge, Firefox and Safari.
  - This does not necessarily mean that the UI will not work on older browser versions.

### UI Changes

- upgrade `xterm` to `v6` + style improvements
- added option: global terminal/log window settings
- improvements to add/edit/remove accessory ui rooms
- improvements to add/edit/delete user forms and ui
- use new font-awesome `ko-fi` icon for donate modal
- add more entries to the credits modal
- update remove all accessories component
- improvements to matter components
- feat: air quality sensor matter device
- accessory tile + modal improvements/fixes
- improve keyboard loading on terminals
- apply save button to accessory info modal
- bring widget mobile visibility into visibility modal

### Other Changes

- fix: prioritise scoped plugins in plugin search results
- fix: validate `version` parameter type in `triggerUpdate`
- fix: validate backup ID format to prevent path traversal
- fix: validate device ID format to prevent path traversal
- chore: consolidate regex into shared file (backend)
- chore: consolidate regex into shared file (frontend)
- chore: refresh some screenshots in `screenshots` folder
- fix: add `username`/`password` attributes to login form
- angular `v20` to `v21` code migration
- add new component for required field indicator
- improve search term matching on settings page
- lint: apply `angular/template` rules
- prioritise scoped plugins in plugin search results
- `configChanged` events keep `updatePluginConfig`() changes
- fix duplicate restart modals showing + not hiding
- refresh users screenshot in `screenshots` folder
- use state labels for `CurrentMediaState`
- enable `strict` mode in `./ui` tsconfig + code fixes
- fix: plugin config - sync data on array item removal

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v4.0.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.2.3`

## v5.20.0 (2026-03-21)

### UI Changes

- updates to the `th.json` language file (#2742) (@tomzt)

### Other Changes

- plugins: check for default `CHANGELOG` when no releases (#2746) (@dnicolson)
- code improvements for updated lint rules
- dependency updates + fix imports

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v4.0.1`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.2.2`

## v5.19.0 (2026-03-04)

### UI Changes

- info widget - remove margin on small table (#2727) (@dnicolson)
- create the `vi.json` language file (@khanhnd88)
  - 🗺️ The Homebridge UI is now available in 29 different languages!
- dependency + lint updates

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.4.0`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.2.1`

## v5.18.0 (2026-02-22)

### UI Changes

- updates to the `uk.json` language file (#2724) (@xrust83)
- improve loading spinner on backup restore
- promote scheduled cron feature from beta
- promote advertise via mdns feature from beta
- promote inactivity based session from beta
- run angular migrations `ngclass-to-class` + `style`
- a11y: improvements to custom plugins modal (from #2677) (@rfiorentino1)
- add bridge filter dropdown to accessories page
- a11y: improvements to config restore modal (from #2677) (@rfiorentino1)
- a11y: improvements to terminal component (from #2677) (@rfiorentino1)
- merge accessory combos of fan+heater/humidifier (see #2713)

### Other Changes

- fixed installing plugins from backup restore
- update types for github plugin lists
- list angular eslint rules in config for the future
- updated dependencies

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.3.0`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.2.0`

## v5.17.0 (2026-02-14)

### UI Changes

- improvements for homebridge v2
- add a link to unmaintained plugins in dev support

### Other Changes

- fix deprecation github workflow script
- update to use `v2` release plugin bundles
- replace accessories screenshot in readme
- updated dependencies
- use angular eslint rules in ui folder + fix lint

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.3.0`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.2.0`

## v5.16.0 (2026-02-08)

### ⚠️ Update Info Widget Changes

- If you had previously set an update preference for Homebridge or Homebridge UI, you will need to set this preference again.
  Please open the _Manage Version_ modal (by clicking on _Homebridge_ or _Homebridge UI_ in the _Update Info Widget_) and set your preference again in the _Update Preferences_ section.
- The _Hide Node Info_ widget setting on the _Update Info Widget_ has been removed.
  Please open the _Node Info_ modal (by clicking on _Node.js_) and set a preference in the _Update Preferences_ section for the same functionality.

### UI Changes

- adjust settings session timeout input elements (#2716) (@dnicolson)
- fix settings display of mdns advertise option
- refactor homebridge/ui update settings
- show plugin icons on homebridge v2 update modal
- update min version for homebridge v2

### Other Changes

- dependency updates

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.1.3`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.1.3`

## v5.15.2 (2026-01-31)

### UI Changes

- updates to the `uk.json` language file (#2715) (@xrust83)
- fix docker update modal styles in dark mode

### Other Changes

- dependency updates

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.1.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.1.2`

## v5.15.1 (2026-01-23)

### ⚠️ 2FA Updates

If you have two-factor authentication (2FA) enabled and set it up with an older version of the UI,
you may see a notification asking you to upgrade your 2FA secret for improved security.

Your current 2FA should continue to work, but we recommend following the prompt to disable
and re-enable 2FA to upgrade to a more secure secret format. This is a one-time process
and only affects users who initially set up 2FA before the recent security library update.

If you do not use 2FA, or you do not see any prompts, no action is needed.

### UI Changes

- i18n: add missing 'clear' language string (#2700) (@rfiorentino1)
- fix support legacy otp secrets after `otplib` upgrade

### Other Changes

- dependency updates

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.1.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.1.2`

## v5.15.0 (2026-01-17)

### UI Changes

- feat: node update preferences + dev docs improvements (#2685) (@seidnerj)
- fix disable plugin showing incorrect `keepOrphans` (#2692) (@copilot)
- feat: add separate beta preferences for plugins (#2687) (@seidnerj)
- further tweaks for node + plugin update preferences
- fix manage plugin show back btn after plugin install
- open accessory info on tile loading icon click
- a11y: improvements to plugin markdown directive (from #2677) (@rfiorentino1)
- first step of improvements to https settings (@donavanbecker)
- a11y: improvements to plugin json schema forms (from #2677) (@rfiorentino1)

### Other Changes

- update `@antfu/eslint-config` lint package to `v7`
- upgrade `otplib` to `v13` + migrate code
- weather widget: put text into strings for i18n

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.1.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.1.2`

## v5.14.0 (2026-01-02)

Wishing all our users a very happy and fulfilling 2026! 🎉

### UI Changes

- fix lock accessory info with no linked services
- accessory info + icon for access code service
- use back btn from release notes to manage version
- a11y: button label improvements on manage version

### Other Changes

- remove unused import from security system component
- optimise api calls on opening uninstall component
- dependency updates

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.1.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.1.2`

## v5.13.1 (2025-12-27)

### UI Changes

- apply patch to `@ng-formworks/core` to fix condition issue

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.1.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.1.2`

## v5.13.0 (2025-12-27)

### UI Changes

- add `NFCAccess` as hidden accessory service
- add status to security system modal
- move reset status layout button into row
- expose unique id on accessory info modal + copy icon (@NorthernMan54)
- add support for plugin ui i18n (from #2597) (@justjam2013)
- add cpu temperature to widget on mac systems
- don't show `pointer: cursor;` on pending accessory tiles
- a11y: improvements to accessory info/tile + add room (from #2677) (@rfiorentino1)

### Other Changes

- fix discord notifications on publish new version
- add node/glib version references in `linux.ts` (@NorthernMan54)
- use `curly': ['error', 'all']` eslint rule
- dependency updates

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.1.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.1.2`

## v5.12.0 (2025-12-15)

### UI Changes

- updates to the `it.json` language file (#2664) (@g-flex)
- updates to the `de.json` language file (#2665) (@michi-onl)
- move control list setting to under insecure mode setting
- never hide the search button on the plugins page
- added log search facility on main logs page
- convert main spinner animation from `svg` to `css`
- use transitions when changing between light and dark backgrounds
- add a couple more post-update messages
- show spinner when backing up before updating hb/ui
- restore required field indicators in plugin config forms
- make loading spinners consistent across the ui

### Other Changes

- update npm publish process for `oidc` auth
- update npm publish process for `oidc` auth (fix)
- fix: adjusted timeout for npm requests to 30 seconds (@NorthernMan54) (#2655, #2656)
- recommend update to node 24 when available
- dependency updates

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.1.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.1.2`

## v5.11.2 (2025-12-06)

### UI Changes

- updates to the `th.json` language file (#2659) (@tomzt)

### Other Changes

- dependency updates

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.1.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.1.2`

## v5.11.1 (2025-11-27)

### Other Changes

- fix required csp for monaco web workers

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.1.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.1.2`

## v5.11.0 (2025-11-25)

### UI Changes

- fix: plugins/accessories not displaying
- fix: show all child bridge details, not just first
- fix: fix removing listeners events from sidebar
- update `monaco-editor` to `v0.55.1` + more deps

### Other Changes

- replace badges in readme, use `shields.io`
- run angular migration - use self-closing tags

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.1.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.1.2`

## v5.10.0 (2025-11-16)

### UI Changes

- updates to the `uk.json` language file (#2618) (@xrust83)
- updates to the `th.json` language file (#2628) (@tomzt)
- fix german welcome translation typo
- add spinners for loading data widget values
- hide ssl settings when on hb raspbian image
- hide accessory widget if insecure mode disabled
- rename insecure option to accessory control
- improve json schema for ui settings section
- avoid refreshing after changing widget setting
- avoid refresh after plugin install/setting change
- shorten arrow button for same row height
- monospace input font for relevant options
- scheduled restart option for (child) bridges

### Other Changes

- add method to determine if running on raspbian image
- fix node deprecation `DEP0190` (shell option)
- config editor - fix restart case of no child bridges
- code styling chore - consistent code spacing
- extract 'extract' string to language files
- lift from beta - custom types, betas, terminal
- convert repo to esm modules
- enable nestjs logging when in dev mode
- add api endpoint for updating a package

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.1.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.1.1`

## v5.9.0 (2025-11-01)

### UI Changes

- updates to the `th.json` language file (#2592) (@tomzt)
- updates to the `zh-cn.json` language file (#2594) (@honue)
- consistent sizing of input fields and select fields
- status qr code widget - show pin in monospace
- bridges widget - show bridges as restarting on full restart
- do not hide search button when no search results found
- close settings restart toast if any restart button clicked
- change session timeout from seconds to days, hours, minutes
- updated various dependencies
- support `dynamicDefaults` in config schema forms
- use homebridge icon for child bridges
- refactor child bridge screen with config alerts
- hide widgets that do not exist in const list

### Other Changes

- implement simple feature flags system dependent on hb version
- fix type import in config editor test file
- improve schemas and types for bridges
- get available port function should adhere to configured range
- update versions of actions, remove `macos-13`

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.1.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.1.0`

## v5.8.0 (2025-09-27)

### UI Changes

- remove accessory focus style (#2582) (@dnicolson)
- updates to the `uk.json` language file (#2584) (@xrust83)
- updates to the `th.json` language file (#2590) (@tomzt)
- detect full restart needed after config (editor) update
- fix microphone active state on accessory tile
- fix air purifier off switch in control modal
- fix infinite loading spinner on authentication expiry (@copilot)
- added config option to advertise the ui over mdns
- added config option to for inactivity-based session timeout

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.1.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.1.0`

## v5.7.0 (2025-09-20)

### UI Changes

- fix sidebar scrollbars (#2574) (@dnicolson)
- refreshed icons: heater, cooler, de/humidifier + thermostat
- put services types into translatable strings
- prevent url-based settings from being changed from a pwa
- add search bar on settings page for filtering options
- implement html page titles on section pages (#2579)
- fix for custom uis showing schema form

### Other Changes

- remove logging of every `MessageEvent` (#2575) (@dnicolson)
- preserve custom service info for undiscovered accessories
- improvements to backend types and organisation
- add GET endpoint for disabled update notifications API (#2580)

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.1.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.1.0`

## v5.6.1 (2025-09-13)

### UI Changes

- updates to the `th.json` language file (#2564) (@tomzt)
- updates to the `ja.json` language file (#2570) (@FreeWiFi7749)
- add node 24 info to node modal + prevent node 24 upgrades on 32-bit systems

### Other Changes

- add pull request targeting guidelines to copilot instructions (#2563) (@NorthernMan54)
- include `homebridge` check with prefer betas settings
- hide updates for the ui when running in dev mode
- temporary fix for `@ng-formworks/core` for schemas

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.1.2`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.1.0`

## v5.6.0 (2025-09-06)

### UI Changes

- refreshed icons: lightbulb, switch, outlet + unknown
- update `monaco-editor` from `v0.21.3` to `v0.52.2`
- allow user to choose config comparison view type
  - the default view is the **new inline view**, which shows the differences together
  - a new button allows switching between the inline view and the **existing side-by-side view**
- improvements to frontend route auth, guards and auth services
- improvements to schema and translations in config editor
- add schema info and validation to manual plugin config editor
- show plugin schema header and footer in plugin json editor
- hide search button when no plugins installed
- show help on accessories when no plugins installed
- add config option to always show beta versions of plugins
- fix ios safari burger menu viewport issue
- update to use font-awesome v7
- fix: no `TouchEvent` in safari to fix toggles
- fix floating-point precision issues in temperature display

### Other Changes

- minor performance updates
- added copilot instructions file (#2544) (copilot)

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.1.1`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.1.0`

## v5.5.0 (2025-08-28)

### UI Changes

- updates to the `th.json` language file (#2528) (@tomzt)
- updates to the `uk.json` language file (#2532) (@xrust83)
- refreshed icons: security system
- refreshed icons: lock mechanism
- refreshed icons: irrigation system + valves
- refreshed icons: light, leak, motion, occ., hum. sensor
- expand/collapse state saving for update information - docker information (#2529) (@NorthernMan54)
- updates to the credits modal
- recommend child bridges for accessory-based plugins
- fix for accessory control issue on android-edge/chrome
- page loading spinner should not block access to menus
- fix link to swagger docs in development mode
- fix host and reverse proxy host settings not showing current value
- fix instructions on login page for recovering admin account
- show system info table rows when data is ready per row
- allow show/hide widgets and widget config on mobile

### Other Changes

- ignore some host settings in dev mode for compatibility
- refactor function to detect changes to json config on save

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.1.1`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.1.0`

## v5.4.1 (2025-08-05)

### UI Changes

- updates to the `pl.json` language file (#2522, #2523) (@mkz212)
- reduce font size in accessory label by 1px
- updates to the credits modal
- make red restart child bridge button on plugin log modal
- refreshed icons: stateless programmable switch

### Other Changes

- fix custom uis which use ui translation strings

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.1.1`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.1.0`

## v5.4.0 (2025-08-02)

### UI Changes

- updates to the `th.json` language file (#2520) (@tomzt)
- json config editor to offer child bridge restarts where possible
- improvements to the restore config file modal
- terminal session persistence and macos shell optimization (#2493) (@seidnerj)
  - big thank you to @seidnerj for this contribution!
  - to read more info about these changes, see the [pull request](https://github.com/homebridge/homebridge-config-ui-x/pull/2493#issue-3226899065)
- small tweaks to persistent terminal integration
- show/copy user qr code secrets when setting up 2fa
- fix json schema icons from font awesome update
- disable plugin notes now based on keep orphans setting
- text clarification in users support modal
- remove glibc checks as node 18 is now unsupported
- add restart child bridges option to plugin log modal
- node version modal: show hb/ui/plugin compatibility
- air purifier tile: update icon to match new style
- robot vacuum tile: use css to use a single svg file
- custom types: expose a switch/outlet as a garage door and vice versa
- garage door tile: show when obstruction detected
- air quality sensor tile: update icon to match new style
- show in sys info widget if arch is 32-bit or 64-bit
- fix for custom ui colouring in dark mode
- updated icons: co, co2, smoke, contact, garage
- thermostat accessory: show target slider when available
- updated icon for door, window and window covering services
- accessory info: show props on characteristic click
- credits modal: added new section for translations
- custom types: expose a switch/outlet as a washing machine
- refreshed icons for fan, television, speaker + filter
- added confirmation modal for shutting down

### Other Changes

- added `arm` runners to the ui workflows for testing
- make 'keep orphans' setting available in ui settings service
- improve types for widgets
- upgrade `@ngx-translate/core` from `v16` to `v17`
- fix get pairings, ignore `.json.bak` files

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.1.1`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.1.0`

## v5.3.0 (2025-07-23)

### UI Changes

- update 'on' colour for sliding checkbox in dark grey theme
- custom types: expose a switch/outlet as a lock and vice versa
- update `monaco-editor` from `0.18.1` to `0.21.3`
- fix new users created are always created as admins
- disable edit user form if no changes are made
- hide terminal widget for non-admin users
- hide bridge restart buttons in widget for non-admin users
- hide unauthorised controls on accessories page for non-admin users
- re-enable logs for non-admin users, but hide unauthorised controls
- hide power options page for non-admin users
- allow non-admin users read-only access to the plugins page
- validate login redirect route for non-admin users
- hide unauthorised controls on status page for non-admin users
- add text on show/hide widget modal to explain layout is shared across all users
- grammar: replace 'unchargeable' with 'not chargeable' on battery tile
- show admin/non-admin icon on user cards for easier identification
- added support icon and modal on users page
- use a new component for support modal footers for suggestions

### Other Changes

- set the minimum wanted version of node to `v20.19.0`
- fix undefined `error.error` instances in various places
- revert to using angular http `withInterceptorsFromDi`
- fix type of ngbtooltip `openDelay` in angular templates
- updated dependencies

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.1.1`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.1.0`

## v5.2.0 (2025-07-17)

### Node.js Version

- ️⚠️ The `hb-service` backend now has a stricter Node.js version requirement:
  - if you are running Node.js `v20`, then you must be running at least `v20.19.0`
  - if you are running Node.js `v22`, then you must be running at least `v22.12.0`
  - if you are running Node.js `v24`, then you must be running at least `v24.0.0`
    - although remember that `v24` is not officially supported yet
- The UI will not allow you to update to UI `v5.2.0` if you are running an unsupported version of Node.js
- Check the [Homebridge Wiki](https://github.com/homebridge/homebridge/wiki/How-To-Update-Node.js) for instructions on how to update Node.js on your system

### Other Changes

- update node engines to `^20.19.0 || ^22.12.0 || ^24.0.0`

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.0.0`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.1.0`

## v5.1.0 (2025-07-17)

### UI Changes

- only show hbv2 readiness icon when ready to show
- migrate to use `fetch()` for http requests
- Fix alignment of Plugin Updates in Horizontal Mode (#2495) (@NorthernMan54)
- offer to download a backup before updating homebridge/ui
- updates to the `he.json` language file (@seidnerj)
- pass through plugin display name to logs after update
- fix accidental hiding of startup settings section

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.0.0`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.1.0`

## v5.0.0 (2025-07-13)

### ⚠️ Breaking Changes

- This version of the Homebridge UI:
  - Is compatible with Homebridge `v1` and `v2-beta`, with no plans to drop support for Homebridge `v1` in the near future.
  - Drops 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)
  - Drops support for Raspberry Pi devices running on the `armv6` architecture (like the Pi 1 and Pi Zero) - please update your hardware
  - Drops 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)

### UI Changes

- updates to the `fi.json` language file (#2253) (@l1500s)
- update default dashboard layout
- add support for dark mode switching with custom plugin uis (@NorthernMan54)
- Display Docker Version Details in the Update Information Box (#2488) (@NorthernMan54)
- allow to reinstall installed versions of plugins

### Other Changes

- improvements to the deprecate versions workflow
- retire use of `pnpm` and code references
- bump the default node version from 20 to 22
- make terminal enabled by default on new macOS hb-service installs
- set service mode as default, remove standalone
- Initial support for NodeJS 24 in preparation for LTS in Fall of 2025 (#2451) (@NorthernMan54)
- update `fastify` and `nestjs` dependencies

### Homebridge Dependencies

- `@homebridge/hap-client` @ `v3.0.0`
- `@homebridge/node-pty-prebuilt-multiarch` @ `v0.13.1`
- `@homebridge/plugin-ui-utils` @ `v2.1.0`

## v4.80.0 (2025-07-12)

- This version of Homebridge UI is likely to be the **last minor version** on the `v4.x` branch.
- The `4.x` branch will continue to receive security updates and bug fixes for the foreseeable future.

### Other Changes

- update github url for plugin bundle downloads
- allow displaying some accessories with a robot vacuum icon in the ui
- do not return deprecated versions of npm packages across the ui
- add workflow for deprecating old versions of Homebridge UI

### Homebridge Dependencies

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

## v4.79.0 (2025-07-09)

### UI Changes

- updates to the `th.json` language file (#2482) (@tomzt)
- updates to the `th.json` language file (#2483) (@tomzt)
- updates to the `nl.json` language file (#2487) (@hendriksen-mark)
- various updates to the backup/restore modal
- fix list of selected network adapters in modal
- battery - style as green when charging
- thermostat - open control modal on long click
- show release notes when npm and gh release match
- add control modal for filter to reset filter life
- show bool characteristic descriptions in info modals
- show colour temp values in mired and kelvin
- add saturation control to lightbulb control modal
- add transparency to slider handles in accessory control modals
- obtain hb/ui changelog from the most recent github tag
- add plugin support button and modal
- add plugin search button, hide bar by default
- add tab in plugins showing plugin analytics in `iframe`
- allow applying a custom service to an accessory's service
  - change between `Switch`, `Outlet`, `Lightbulb`, `Fan`, `Television`, `Valve`, `AirPurifier`, `Heater`, `Cooler`, `Humidifier`, `Dehumidifier` for these accessory types
  - change between `Door`, `Window`, `WindowCovering` for these accessory types
  - change between `Doorbell`, `Microphone`, `Speaker`, `SmartSpeaker` for these accessory types
  - this can be set in the accessory info modal, more options to come in the future
- custom service changing - add more to group one
- add option to show `npm` version with node version
  - this can be enabled in the update info widget settings by clicking the spanner icon in the top right corner of the widget on hover (from a desktop, when in unlocked mode)
- add control modal for smart speaker accessories
- prevent accessory control modal open when loading
- add control modal for doorbell accessories
- add control modal for microphone accessories
- allow custom type changing - doorbell, microphone, speaker

### Other Changes

- code cleanup inside angular module files
- refactor ui types into interface files
- rename hap icon files for consistency
- rename accessory type component files for consistency
- angular-wide code refactoring and cleanup

### Homebridge Dependencies

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

## v4.78.1 (2025-07-03)

### Other Changes

- when updating plugin, obtain latest changelog from github

### Homebridge Dependencies

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

## v4.78.0 (2025-07-03)

### UI Changes

- fix accessory control modals closing on clicking outside the modal
- small tweaks to various accessory status tiles
- revert display of triggered state in security control modal
- show spinner on settings page until all settings are loaded
- show both version notes and full changelog beforehand on plugin update

### Other Changes

- remove bridge id from control blacklist when removing a bridge
- fix regex for blacklist in config schema file
- bring runner list for actions up-to-date with github availability

### Homebridge Dependencies

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

## v4.77.0 (2025-06-29)

### ⚠️ Default Theme Change:

- The default theme for Homebridge UI has been changed from `orange` to `deep-purple`.
  - If you want to change the theme back to `orange`, you can do so in the settings page.

### UI Changes

- updates to the `th.json` language file (#2472) (@tomzt)
- auto restart after version change of hb or ui
- redesigned setup wizard page
- style HBv2/UIv5 icons on status page based on readiness
- security system modal only show valid modes
- refactor settings page with immediate saving
- add support for `uiSchema` within plugin configurations
- add option to hide update notifications for specific plugins
- improve plugin search and result ordering (@justjam2013)
- add icon and tile for filter maintenance accessory

### Other Changes

- Removed redundant Google Smart Home components (@NorthernMan54)

### Homebridge Dependencies

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

## v4.76.0 (2025-06-07)

### ⚠️ Config Property Change:

- The `loginWallpaper` UI config property has been renamed to `wallpaper`
- This was detected after the release of v4.76.0, and is being documented here post-release.

### UI Changes

- updates to the `th.json` language file (#2443) (@tomzt)
- improvements to various accessory tiles and modals
- fix occasional issue in backup/restore, revert recent change
- improvements to plugin config validation
  - use `ajv-keywords` to allow validation of unique properties in arrays
- fix form field error state font colour (make it red)
- redesigned login page
- improve wallpaper selection with new modal to upload a file
- refactor HBv2 and UIv5 readiness modals
- move backup settings from ui advanced settings to backup/restore modal
- show lock management service info on lock mechanism info modal
- show characteristic descriptions in info modal when available

### Other Changes

- upgrade to angular `v20`
- bump `plugin-ui-utils` for new theme method

### Homebridge Dependencies

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

## v4.75.0 (2025-05-25)

### UI Changes

- updates to the uk.json language file (#2436) (@xrust83)
- updates to the th.json language file (#2437) (@tomzt)
- updates to the `manual_update_command` language string
- show restart modal after installing an already configured plugin
- add long click modal for lock mechanism + management
- improvements to heater/humidifier/thermostat icon+modal
- improvements to battery icon

### Homebridge Dependencies

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

## v4.74.0 (2025-05-18)

### UI Changes

- improve plugin manage version ui (#2424) (@apexskier)
- capitalise time zone in system info widget
- add architecture to system info widget
- add checks on system for updating to ui v5
- added screen for ui v5 readiness check
- add color temperature to lightbulb screen (@justjam2013)
- add temperature units to heatercooler (@justjam2013)
- add valve control modal (@justjam2013)
- update speaker tile + control modal (@justjam2013)

### Homebridge Dependencies

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

## v4.73.0 (2025-04-19)

### UI Changes

- updates to the `en.json` language file (#2389) (@HenryGelderbloem)
- updates to the `de.json` language file (#2403) (@Staubgeborener)
- updates to the `de.json` language file (#2404) (@Staubgeborener)
- improve icons in bridges widget
- fix individual accessory deselect on remove modal
- improve accessory icons for CO and CO2 sensors
- make secondary blue colour in light mode more distinct

### Other Changes

- fix do not include `--omit=dev` flag in `pnpm` commands
- add lint job for checking all pull requests
- allow package mode users to disable the terminal
- various copilot improvements for file paths
- updated dependencies
- remove `ubuntu-20.04` from actions as unsupported

### Homebridge Dependencies

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

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

### 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