v4.69.1-beta.0

v4.69.1-beta.0

How To Test Upcoming Changes

v5.0.0-beta.42

v5.0.0-beta.42

How To Test Upcoming Changes

v5.0.0-beta.41

v5.0.0-beta.41

How To Test Upcoming Changes

v4.69.0

⚠️ 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
  • 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
• Note that these are not requirements for UI v4.69.0

⚠️ 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

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

UI Changes

• add explanation of deleting child bridges when un-toggling
• add filtering to search to improve results (#2286) (@justjam2013) (fixes #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
• import 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

UI Changes

• fix verified plugins link in support module (fixes #2295)
• add missing modal footer <div>s to accessory control modals
• fix radio button groups in certain accessory control modals (fixes #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)

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

Other Changes

• Rollback of recent plugin search changes @justjam2013 [#2290]

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

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

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