{"id":13397872,"url":"https://github.com/hobbyquaker/node-red-contrib-zigbee","last_synced_at":"2025-03-14T00:32:47.340Z","repository":{"id":45923879,"uuid":"166879513","full_name":"hobbyquaker/node-red-contrib-zigbee","owner":"hobbyquaker","description":"Node-RED Nodes for ZigBee Devices 🐝","archived":true,"fork":false,"pushed_at":"2022-12-28T17:06:21.000Z","size":1411,"stargazers_count":86,"open_issues_count":64,"forks_count":15,"subscribers_count":25,"default_branch":"master","last_synced_at":"2024-08-09T03:10:39.681Z","etag":null,"topics":["aqara","cc2531","home-automation","hue","node-red","smarthome","tradfri","zigbee","zigbee-herdsman","zigbee-shepherd"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hobbyquaker.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-01-21T20:56:21.000Z","updated_at":"2023-12-31T20:58:01.000Z","dependencies_parsed_at":"2023-01-31T07:01:10.125Z","dependency_job_id":null,"html_url":"https://github.com/hobbyquaker/node-red-contrib-zigbee","commit_stats":{"total_commits":299,"total_committers":10,"mean_commits":29.9,"dds":0.03678929765886285,"last_synced_commit":"8da7c2284f857875e03d726ee725f892c5e81276"},"previous_names":[],"tags_count":30,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hobbyquaker%2Fnode-red-contrib-zigbee","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hobbyquaker%2Fnode-red-contrib-zigbee/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hobbyquaker%2Fnode-red-contrib-zigbee/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hobbyquaker%2Fnode-red-contrib-zigbee/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hobbyquaker","download_url":"https://codeload.github.com/hobbyquaker/node-red-contrib-zigbee/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243505086,"owners_count":20301553,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["aqara","cc2531","home-automation","hue","node-red","smarthome","tradfri","zigbee","zigbee-herdsman","zigbee-shepherd"],"created_at":"2024-07-30T18:01:50.136Z","updated_at":"2025-03-14T00:32:45.538Z","avatar_url":"https://github.com/hobbyquaker.png","language":"JavaScript","funding_links":[],"categories":["JavaScript","Nodes"],"sub_categories":["Smarthome"],"readme":"# node-red-contrib-zigbee\n\n[![NPM version](https://badge.fury.io/js/node-red-contrib-zigbee.svg)](http://badge.fury.io/js/node-red-contrib-zigbee)\n[![Build Status](https://travis-ci.org/hobbyquaker/node-red-contrib-zigbee.svg?branch=master)](https://travis-ci.org/hobbyquaker/node-red-contrib-zigbee)\n[![XO code style](https://img.shields.io/badge/code_style-XO-5ed9c7.svg)](https://github.com/sindresorhus/xo)\n[![License][mit-badge]][mit-url]\n\n\u003e Control Zigbee Devices (Xiaomi Aqara, Hue, Lightify, Tradfri, ...) with Node-RED via a CC253x Module. No need for\nproprietary bridges anymore, use devices of different vendors in one Zigbee network.\n\n\n\n## ⚠️ Project abondoned, I'm not using it anymore and therefore I will not work on this anymore. I strongly advice against using it - I recommend using [zigbee2mqtt](https://www.zigbee2mqtt.io/)!\n\n\n\n## Credits\n\nBased on [zigbee-herdsman](https://github.com/Koenkk/zigbee-herdsman), Koenkk's fork of \n[Zigbee Shepherd](https://github.com/zigbeer/zigbee-shepherd). Strongly inspired by his awesome\n[zigbee2mqtt](https://github.com/Koenkk/zigbee2mqtt) project. \n\n## Hardware Prerequisites\n\nsee https://www.zigbee2mqtt.io/getting_started/what_do_i_need.html\nReady to use firmware images are available here: https://github.com/Koenkk/Z-Stack-firmware/tree/master/coordinator\n\n## Getting started\n\nAdd any Zigbee Node, open it's configuration, add a \"herdsman\" node, configure it, close both nodes and deploy. Wait\na few seconds and go to the configuration of the \"herdsman\" node again, now you should be able to pair devices. Keep\nan eye on Node-RED's log output.\n\n\n## Nodes\n\n#### herdman\n\nConfig node that holds the serial port and ZigBee network configuration of zigbee-herdsman. You should change the \n`networkKey` for security reasons before pairing the first devices. I suggest to use a password manager (like e.g. KeyPass) \nto create and store a random key (has to be 16 Byte in uppercase hex representation (32 chars 0-9A-F). \nWith this config node you can also manage your devices (pairing, removing, renaming), reporting, groups and binds.\n\n\n#### converter\n\nThis Node utilizes [Koenkk's zigbee-herdsman-converters](https://github.com/Koenkk/zigbee-shepherd-converters) and \noffers payload formats as known from zigbee2mqtt. In fact most of this nodes code is taken 1:1 from zigbee2mqtt.\n\n\n#### hue\n\nThis node aims to be a drop-in replacement for https://github.com/hobbyquaker/hue2mqtt.js\n\n\n#### offline\n\nThis node outputs the online/offline status of the devices.\n\n\n#### event\n\nThis Node outputs events as received from zigbee-herdsman. \n\n\n#### command\n\nSend a command to a device endpoint or group. \n\n\n#### controller\n\nCall methods of the herdsman controller\n\n\n## Todo\n\n* [x] Converter node: readAfterWrite\n* [ ] Hue node: readAfterWrite\n* [x] Converter node: Determine endpoint\n* [x] Converter node: Group support \n* [x] Converter node: Get command\n* [x] Hue node: Group support\n* [x] Command node: Group support\n* [x] Group bind support\n* [x] remove frontend debug output\n* [x] per-device configurable ping\n* [x] per-device configurable configure\n* [x] Secure shepherd node REST API, use Authentication\n* [ ] Documentation\n* [x] Adapt to Node-RED 1.0 message API\n* [ ] OTA Update\n\n## License\n\nMIT (c) Sebastian Raff\n\n[mit-badge]: https://img.shields.io/badge/License-MIT-blue.svg?style=flat\n[mit-url]: LICENSE\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhobbyquaker%2Fnode-red-contrib-zigbee","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhobbyquaker%2Fnode-red-contrib-zigbee","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhobbyquaker%2Fnode-red-contrib-zigbee/lists"}