How To Test Upcoming Changes

How To Test Upcoming Changes

How To Test Upcoming Changes

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

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

⚠️ Do not update if:

• you are running Node.js v20, and your version is lower than v20.19.0
• you are running Node.js v22, and your version is lower than v22.12.0

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

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

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

• 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

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

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