Homebridge deCONZ Tools


Homebridge deCONZ Tools

Copyright © 2022-2026 Erik Baauw. All rights reserved.

This repository provides a standalone installation of the command-line utilities from Homebridge deCONZ:

- deconz, to discover, monitor, and interact with deCONZ gateways.
See the deconz Command-Line Utility in the Wiki for more info.
- otau, to download and analyse over-the-air-upgrade firmware files for Zigbee devices.
The firmware files are downloaded into the current directory from the
zigbee-OTA repository,
using the files names as expected by the
deCONZ OTAU plugin.

Each command-line tool takes a -h or --help argument to provide a brief overview of its functionality and command-line arguments.

$3

You need a deCONZ gateway to connect the Homebridge deCONZ Tools to your ZigBee devices (lights, plugs, sensors, switches, ...).
For Zigbee communication, the deCONZ gateway requires a ConBee II or Conbee USB stick, or a RaspBee II or RaspBee Raspberry Pi shield.
I recommend to run deCONZ with its GUI enabled, even on a headless system.
When needed, you can access the deCONZ GUI over screen sharing.

The Homebridge deCONZ tools communicate with the deCONZ gateway using the local
REST API,
provided by its
REST API plugin.
These tools run independently from the Phoscon web app, see
deCONZ for Dummies.