{"id":18217407,"url":"https://github.com/ebaauw/homebridge-deconz","last_synced_at":"2026-02-11T22:18:20.654Z","repository":{"id":37814273,"uuid":"444432604","full_name":"ebaauw/homebridge-deconz","owner":"ebaauw","description":"Homebridge plugin for deCONZ","archived":false,"fork":false,"pushed_at":"2026-01-10T12:26:35.000Z","size":1252,"stargazers_count":148,"open_issues_count":4,"forks_count":9,"subscribers_count":9,"default_branch":"main","last_synced_at":"2026-01-11T03:50:30.783Z","etag":null,"topics":["conbee","deconz","dresden-elektronik","dresdenelektronik","homebridge-plugin","homekit","phoscon","raspbee"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ebaauw.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["ebaauw"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://www.paypal.me/ebaauw/EUR"]}},"created_at":"2022-01-04T13:38:20.000Z","updated_at":"2026-01-10T12:26:38.000Z","dependencies_parsed_at":"2024-02-08T10:30:03.779Z","dependency_job_id":"6c183ce4-469f-4a5b-9326-d64b8fed4f90","html_url":"https://github.com/ebaauw/homebridge-deconz","commit_stats":{"total_commits":416,"total_committers":3,"mean_commits":"138.66666666666666","dds":0.004807692307692291,"last_synced_commit":"24f97161f5f723882f4de6f1502e9c0682461490"},"previous_names":[],"tags_count":74,"template":false,"template_full_name":null,"purl":"pkg:github/ebaauw/homebridge-deconz","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ebaauw%2Fhomebridge-deconz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ebaauw%2Fhomebridge-deconz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ebaauw%2Fhomebridge-deconz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ebaauw%2Fhomebridge-deconz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ebaauw","download_url":"https://codeload.github.com/ebaauw/homebridge-deconz/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ebaauw%2Fhomebridge-deconz/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29343683,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-11T18:58:20.535Z","status":"ssl_error","status_checked_at":"2026-02-11T18:56:44.814Z","response_time":97,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["conbee","deconz","dresden-elektronik","dresdenelektronik","homebridge-plugin","homekit","phoscon","raspbee"],"created_at":"2024-11-03T17:05:16.904Z","updated_at":"2026-02-11T22:18:20.649Z","avatar_url":"https://github.com/ebaauw.png","language":"JavaScript","funding_links":["https://github.com/sponsors/ebaauw","https://www.paypal.me/ebaauw/EUR"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"homebridge-ui/public/homebridge-deconz.png\" height=\"200px\"\u003e  \n\u003c/p\u003e\n\u003cspan align=\"center\"\u003e\n\n# Homebridge deCONZ\n[![Downloads](https://img.shields.io/npm/dt/homebridge-deconz)](https://www.npmjs.com/package/homebridge-deconz)\n[![Version](https://img.shields.io/npm/v/homebridge-deconz)](https://www.npmjs.com/package/homebridge-deconz)\n[![Homebridge Discord](https://img.shields.io/discord/432663330281226270?color=728ED5\u0026logo=discord\u0026label=discord)](https://discord.gg/zUhSZSNb4P)\n[![verified-by-homebridge](https://badgen.net/badge/homebridge/verified/purple)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)\n\n[![GitHub issues](https://img.shields.io/github/issues/ebaauw/homebridge-deconz)](https://github.com/ebaauw/homebridge-deconz/issues)\n[![GitHub pull requests](https://img.shields.io/github/issues-pr/ebaauw/homebridge-deconz)](https://github.com/ebaauw/homebridge-deconz/pulls)\n[![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen)](https://standardjs.com)\n\n\u003c/span\u003e\n\n## Homebridge plugin for deCONZ\nCopyright © 2022-2026 Erik Baauw. All rights reserved.\n\n### Introduction\nThis [Homebridge](https://github.com/homebridge/homebridge) plugin exposes to Apple's [HomeKit](http://www.apple.com/ios/home/) ZigBee devices (lights, plugs, sensors, switches, ...) and virtual devices on a deCONZ gateway by dresden elektronik.\nHomebridge deCONZ communicates with deCONZ over its [REST API](https://dresden-elektronik.github.io/deconz-rest-doc/), provided by its [REST API plugin](https://github.com/dresden-elektronik/deconz-rest-plugin).\nIt runs independently from the Phoscon web app, see [deCONZ for Dummies](https://github.com/dresden-elektronik/deconz-rest-plugin/wiki/deCONZ-for-Dummies).\n\nHomebridge deCONZ is the successor of Homebridge Hue for exposing Zigbee devices connected to a deCONZ gateway.\nSee [Future Development of Homebridge Hue](https://github.com/ebaauw/homebridge-hue/issues/1070) for more details.\n\n### Prerequisites\nYou need a deCONZ gateway to connect Homebridge deCONZ to your ZigBee devices (lights, plugs, sensors, switches, ...).\nFor Zigbee communication, the deCONZ gateway requires a [ConBee II](https://phoscon.de/en/conbee2) or [Conbee](https://phoscon.de/en/conbee) USB stick, or a [RaspBee II](https://phoscon.de/en/raspbee2) or [RaspBee](https://phoscon.de/en/raspbee) Raspberry Pi shield.  \nI recommend to run deCONZ with its GUI enabled, even on a headless system.\nWhen needed, you can access the deCONZ GUI over screen sharing.\n\nYou need a server to run Homebridge.\nThis can be anything running [Node.js](https://nodejs.org): from a Raspberry Pi, a NAS system, or an always-on PC running Linux, macOS, or Windows.  \nI strongly recommend to use a standard Homebridge installation, see the [Homebridge Wiki](https://github.com/homebridge/homebridge/wiki) for details.\nI recommend to run deCONZ and Homebridge deCONZ on the same server, avoiding any network latency between deCONZ and Homebridge deCONZ, and preventing any potential network issues.\nI strongly recommend to run Homebridge deCONZ in a separate [child bridge](https://github.com/homebridge/homebridge/wiki/Child-Bridges).\n\nTo interact with HomeKit, you need an Apple device with Siri or a HomeKit app.  \nPlease note that Siri and Apple's [Home](https://support.apple.com/en-us/HT204893) app only provide limited HomeKit support.\nTo use the full features of Homebridge deCONZ, you need another HomeKit app, like [Eve](https://www.evehome.com/en/eve-app) (free) or Matthias Hochgatterer's [Home+](https://hochgatterer.me/home/) (paid).  \nAs HomeKit uses mDNS (formally known as Bonjour) to discover Homebridge, the server running Homebridge must be on the same subnet as your Apple devices running HomeKit.\nMost cases of _Not Responding_ accessories are due to mDNS issues.  \nFor remote access and for HomeKit automations (incl. support for wireless switches), you need to setup an Apple TV (4th generation or later), HomePod, or iPad as [home hub](https://support.apple.com/en-us/HT207057).  \nI recommend to use the latest released non-beta version of the Apple device OS: iOS, iPadOS, macOS, ...\nHomeKit doesn't seem to like using different Apple device OS versions.\n\n### Configuration\nMost settings for Homebridge deCONZ, can be changed at run-time, including which devices to expose, how to expose these, and the level of logging.\nThis keeps `config.json` extremely simple.\nTypically, you only need to specify the hostname and port of the deCONZ gateway(s) in `config.json`.\nSee [`Configuration`](https://github.com/ebaauw/homebridge-deconz/wiki/Configuration) in the Wiki for details.\nI strongly recommended to run Homebridge deCONZ in a separate [child bridge](https://github.com/homebridge/homebridge/wiki/Child-Bridges).\n\nHomebridge deCONZ provides a Configuration API to change the run-time settings.\nThese changes take effect immediately, and are persisted across Homebridge restarts.\nSee [`Dynamic Configuration`](https://github.com/ebaauw/homebridge-deconz/wiki/Dynamic-Configuration) in the Wiki for details.\nFor now, these dynamic settings are managed through the `ui` command-line tool.\nEventually, Homebridge deCONZ might provide a configuration user interface to the Homebridge UI, using this configuration API.\n\nWhen it connects to a deCONZ gateway for the first time, Homebridge deCONZ will try to obtain an API key for two minutes, before exposing the gateway accessory.\nUnless Homebridge deCONZ runs on the same server as the deCONZ gateway, you need to unlock the gateway to allow Homebridge deCONZ to obtain an API key.\nIf you don't, Homebridge deCONZ will give up, after two minutes.\nIn this case, you need to set `expose` on the gateway dynamic settings, to retry obtaining an API key.\nHomebridge deCONZ will **not** retry to obtain an API key on Homebridge restart.\n\nOnce it has obtained an API key, Homebridge deCONZ will expose all Zigbee devices connected to the gateway, by default. \nUse the dynamic settings to exclude devices from being exposed, to change how devices are exposed, and to expose virtual devices like groups or CLIP sensors.  \nHomebridge deCONZ exposes a [gateway accessory](https://github.com/ebaauw/homebridge-deconz/wiki/Gateway-Accessory) for each deCONZ gateway.\nIn Apple's Home app, this accessory looks like a wireless switch; you'll need another HomeKit app to use the other features of this accessory.\n\nNote that HomeKit doesn't like configuration changes.\nAfter adding or removing accessories, allow ample time for HomeKit to sync the changed configuration to all Apple devices.\n\n### Command-Line Utilities\nHomebridge deCONZ includes the following command-line utilities:\n- `deconz`, to discover, monitor, and interact with deCONZ gateways.  \nSee the [`deconz` Command-Line Utility](https://github.com/ebaauw/homebridge-deconz/wiki/deconz-Command%E2%80%90Line-Utility) in the Wiki for more info.\n- `otau`, to download and analyse over-the-air-update firmware files for Zigbee devices.\n- `ui` to configure a running instance of Homebridge deCONZ.  \nSee [`Dynamic Configuration`](https://github.com/ebaauw/homebridge-deconz/wiki/Dynamic-Configuration) in the Wiki for more info.\n\nEach command-line tool takes a `-h` or `--help` argument to provide a brief overview of its functionality and command-line arguments.\n\n### Troubleshooting\nPlease check the [FAQ](https://github.com/ebaauw/homebridge-hue/wiki/FAQ) (for now still on Homebridge Hue Wiki).\n\n#### Check Dependencies\nIf you run into Homebridge startup issues, please double-check what versions of Node.js and of Homebridge have been installed.\nHomebridge deCONZ has been developed and tested using the [latest LTS](https://nodejs.org/en/about/releases/) version of Node.js and the [latest](https://www.npmjs.com/package/homebridge) version of Homebridge.\nOther versions might or might not work - I simply don't have the bandwidth to test these.\n\n#### Run Homebridge deCONZ Solo\nIf you run into Homebridge startup issues, please run Homebridge deCONZ in a separate [child bridge](https://github.com/homebridge/homebridge/wiki/Child-Bridges).\n\n#### Debug Log File\nHomebridge deCONZ outputs an info message to the Homebridge log, for each HomeKit characteristic value it sets and for each HomeKit characteristic value change notification it receives.  Make sure that `logLevel` of the corresponding accessory is at least 1, to see these info messages.\n\nHomebridge deCONZ outpits a debug message to the Homebridge log, for each interaction with a deCONZ gateway.\nMake sure to run Homebridge in DEBUG mode, and that `logLevel` of the corresponding accessory is at least 2, to see these debug messages.  Set `logLevel` to 3 to log the payload of the interaction with deCONZ as well.\n\n#### Debug Dump File\nTo aid troubleshooting, on startup, Homebridge deCONZ dumps its environment, including its `config.json` settings, dynamic settings, and the full state of all gateways into a compresed json file, `homebridge-deconz.json.gz`.\nThis file is located in the Homebridge user directory.\n\n#### Getting help\nIf you have a question about Homebridge deCONZ, please post a message to the **#deconz** channel of the Homebridge community on [Discord](https://discord.gg/zUhSZSNb4P).\n\nIf you encounter a problem with Homebridge deCONZ, please open an issue on [GitHub](https://github.com/ebaauw/homebridge-deconz/issues).\nPlease attach a copy of `homebridge-deconz.json.gz` to the issue, see [**Debug Dump File**](#debug-dump-file).\nPlease attach a copy of the (compressed) Homebridge log file to the issue, see [**Debug Log File**](#debug-log-file).\nPlease do **not** copy/paste large amounts of log output.\n\n### Contributing\nSometimes I get the question how people can support my work on Homebridge deCONZ.\nI created Homebridge deCONZ as a hobby project, for my own use.\nI share it on GitHub so others might benefit, and to give back to the open source community, without whom Homebridge Hue wouldn't have been possible.\n\nHaving said that, adding support for new devices, in Homebridge deCONZ, and in the deCONZ REST API plugin, is very hard without having physical access to the device.\nSince this is a hobby project, I cannot afford to spend money on devices I won't be using myself, just to integrate them for the benefit of others.\nI am happy to receive small donations in the form of new devices to integrate, or the money to buy these devices myself.\nI am also happy to return the devices afterwards, if you provide the shipping costs.\nPlease contact me by email or on Discord for shipping details.\n\n### Caveats\nHomebridge deCONZ is a hobby project of mine, provided as-is, with no warranty whatsoever.  I've been running it successfully at my home since May 2023, replacing Homebridge Hue, but your mileage might vary.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Febaauw%2Fhomebridge-deconz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Febaauw%2Fhomebridge-deconz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Febaauw%2Fhomebridge-deconz/lists"}