v4.68.0 (2025-01-08)
Happy 2025 to all our users! 🎉
⚠️ Upcoming Deprecations:
- The next major version
v5
of the Homebridge UI will drop support for:
- Node.js
v16
and earlier, so please update to v18
or v20
or v22
- more info on updating - Raspberry Pi devices running on the
armv6
architecture (like the Pi 1 and Pi Zero) - please update your hardware - 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.68.0
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:
- 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