v1.3.0 (2021-02-20)

Pre-Update Checklist

Please make sure you have done the following before updating:

• Updated all existing plugins to their latest version.
• Create a backup of your Homebridge instance.
• Review the mDNS Options that you may need to adjust after updating to Homebridge v1.3.0.

Breaking Changes

The "mdns"."interface" option has been removed, please use "bridge"."bind" instead. This new option takes an array of interface names or IP addresses. You can also configure this option using the "Network Interfaces" option under the Homebridge Settings section of the UI.

See https://github.com/homebridge/homebridge/wiki/mDNS-Options for more information.

Compatibility

Homebridge v1.3.0 does not introduce breaking changes for the majority of existing plugins, while you may see Characteristic Warnings in the logs, these are just issues that were already present prior to v1.3.0 - just hidden from view. You should update your plugins before updating Homebridge.

A large number of plugins have been tested during an extensive beta period, the results can be viewed here.

Adaptive Lighting

The new Adaptive Lightning feature introduced with iOS 14 can now be used by plugin developers. Most of the actively maintained plugins already secretly added support for it.

Child Bridges

Child bridges allow any Homebridge platform or accessory to optionally run as its own independent accessory, separate from the main bridge, and in an isolated process. Running certain accessories in a child bridge can improve the general responsiveness and reliability of Homebridge.

Why you might run a child bridge:

• To isolate plugin code from the main bridge - in this mode the plugin will run in its own child process, preventing it from ever crashing the main bridge if a fatal exception occurs.
  • If the child bridge process does crash, Homebridge will automatically restart it, without impacting the main bridge or other plugins.
• To isolate slow plugins, preventing them from slowing down the main bridge or other plugins.
• To gain the ability to restart individual accessories after a config change or plugin update without having to restart the main bridge or other plugins.
• To gain all the benefits of running multiple instances of Homebridge without the management overhead.

Child bridge support is available for all existing plugins. You can enable it via the Homebridge UI on a acessory/platform basis from the "Bridge Settings" menu item:

Learn more about child bridges here: https://github.com/homebridge/homebridge/wiki/Child-Bridges

mDNS Advertiser Selection

Homebridge v1.3.0 ships with two different Bonjour/mDNS advertisers which users can choose from, Ciao and Bonjour HAP.

• Homebridge v1.1.x shipped with Bonjour HAP
• Homebridge v1.2.x shipped with Ciao

The default for new users will be Bonjour HAP, you can swap between the two from the "Homebridge Settings" screen in the Homebridge UI:

See https://github.com/homebridge/homebridge/wiki/mDNS-Options for more information.

Other Notable Changes

• Added the ability to disable individual plugins without having to remove their config from the config.json file.
• Homebridge will no longer crash if a plugin cannot be found for a certain accessory / platform config block.
• Improved stability with malfunctioning plugins or plugins which read/write handlers take too long to respond. You may have been there, where you whole Homebridge instance went down only because one plugin or accessory didn't behave properly. We have invested some time to reduce the possibility of such scenarios; or at least give hints where we can reliably detect that something gone wrong.
• Plugin characteristics are now strictly validated, if an invalid value is passed in the bridge will now force it to a known good value and show a warning in the logs, this should prevent some of the "Not Responding" issues users have faced in the past.

Changes For Developers

• Added the ability to use promise-based characteristic getters and setters. Have a look at characteristic.onGet and characteristic.onSet.
• Added support for Characteristics with Additional Authorization, by using characteristic.setupAdditionalAuthorization.
• For a more detailed list, have a look at the release notes of HAP-NodeJS v0.9.0.
• Added a API.versionGreaterOrEqual
  call to the homebridge API object.
  This will from now on replace the float based API version number property.

Rolling Back

If for any reason Homebridge v1.3.0 is not working for you, you can rollback to a previous version of Homebridge easily using the Homebridge UI.

See https://github.com/homebridge/homebridge/wiki/How-To-Change-Homebridge-Version for more information.

v1.2.5 (2020-12-28)

Bug Fixes

• Updated HAP-NodeJS to v0.8.5 incorporating fixes made to the ciao mDNS library.
  Refer to the release notes of HAP-NodeJS for more technical details.

v1.1.7 (2020-12-16)

Bug Fixes

• mDNS: Minor fixes and improvements, highlighting:
  • Advertisements are now properly removed on shutdown
  • Service Enumeration PTR record is now sent as expected

v1.2.4 (2020-12-05)

Bug Fixes

• Updated the mdns library ciao to v1.1.0 introducing further stability improvements.

Notice: This release is tailored towards people already running 1.2.x. As of now 1.1.6 will remain the latest stable version.

v1.2.3 (2020-09-21)

Bug Fixes

• Updated the mdns library ciao to the latest version
  • Includes general bug fixes and stability improvements
  • Improved compatibility with machines running avahi
  • Fixed handling of updated ip addresses
  • Fixes for Darwin system running in a VM

---

The Homebridge team has released the official Homebridge Raspberry Pi Image.

v1.2.2 (2020-09-16)

Bug Fixes

• Added a warning when a plugin takes too long to load and prevents homebridge from starting.
• Update hap-nodejs to v0.8.2 resolving some advertising issues on some uncommon platforms

For Developers

• Updated the typing of the accessory context to be any again to allow less strict typing. Though we encourage you to write your own Type Definition for better type safety!

---

The Homebridge team has released the official Homebridge Raspberry Pi Image.

v1.2.1 (2020-09-15)

Bug Fixes

• Fixed a bug related to mdns discovery where on some machines (FreeBSD and some containerized installs) the accessory is not correctly advertised on the local network

---

The Homebridge team has released the official Homebridge Raspberry Pi Image.

v1.2.0 (2020-09-14)

Notable Changes

• Updated HAP-Nodejs to v0.8.0 (see HAP-NodeJS release notes).
  This includes the rewritten bonjour/mdns library ciao, which improves Accessory discovery on the local network (#2619).
• Add ability to type an accessory context using generics (#2664)

---

The Homebridge team has released the official Homebridge Raspberry Pi Image.

v1.1.6 (2020-09-07)

Bug Fixes

• Fixed an incompatibility introduced in v1.1.3 with the commander library

---

The Homebridge team has released the official Homebridge Raspberry Pi Image.

v1.1.3 (2020-09-03)

Bug Fixes

• Updated HAP-Nodejs to v0.7.9 (see HAP-NodeJS release notes):
  • IP addresses for camera streaming endpoints are automatically and more reliably set
  • Added latest changes made to iOS 14 beta 4 and 5

---

The Homebridge team has released the official Homebridge Raspberry Pi Image.