github KyleBoyer/homebridge-blaq V0.5.0

40 minutes ago

ESPHome Native API support

The plugin can now talk to your GDO blaQ over the ESPHome Native API: one persistent connection for state, device logs, and commands. A Native API connection also stops ESPHome's automatic reboot every 15 minutes, with no heartbeat needed.

What's new

  • Connection method setting, auto by default. Auto uses the Native API when the device allows it, and falls back to the web server API (REST + /events) when it doesn't, for example when the Native API is disabled in your firmware. Choose native or web to force one.
  • Optional per-device Native API Encryption Key, for firmware built with one. Stock GDO blaQ firmware doesn't use one.

What changed

  • Requires Node.js 22.20 or newer. Node.js 20 reached end of life in April 2026, and the Native API client library needs 22.20+. If Homebridge reports an engine mismatch, update Node.js first.
  • The Native API heartbeat settings now only apply when the plugin is connected through the web server API.
  • The Username and Password settings are now labeled as web server credentials, which is what they always were.

Do you need to change anything?

No. Existing setups switch to the Native API automatically when the device allows it, and keep working through the web server API otherwise.

Full Changelog: V0.4.2...V0.5.0

Don't miss a new homebridge-blaq release

NewReleases is sending notifications on new releases.