Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/madchicken/homebridge-zigbee-nt
A standalone ZigBee plugin that works with CC2531 USB dongle or Deconz
https://github.com/madchicken/homebridge-zigbee-nt
cc2531 deconz homebridge homebridge-zigbee ikeatradfri philips-hue xiaomi-smart-home zigbee zigbee-herdsman
Last synced: 11 days ago
JSON representation
A standalone ZigBee plugin that works with CC2531 USB dongle or Deconz
- Host: GitHub
- URL: https://github.com/madchicken/homebridge-zigbee-nt
- Owner: madchicken
- License: apache-2.0
- Created: 2020-06-11T15:44:55.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-09-21T06:28:24.000Z (about 2 months ago)
- Last Synced: 2024-10-17T03:12:07.015Z (27 days ago)
- Topics: cc2531, deconz, homebridge, homebridge-zigbee, ikeatradfri, philips-hue, xiaomi-smart-home, zigbee, zigbee-herdsman
- Language: TypeScript
- Homepage:
- Size: 4.46 MB
- Stars: 75
- Watchers: 9
- Forks: 38
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
![Logo](zigbee-logo.png)
# homebridge-zigbee-nt
ZigBee Platform plugin for [HomeBridge](https://github.com/homebridge/homebridge)
[![verified-by-homebridge](https://badgen.net/badge/homebridge/verified/purple)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)
[![madchicken](https://circleci.com/gh/madchicken/homebridge-zigbee-nt.svg?style=svg)](https://app.circleci.com/pipelines/github/madchicken/homebridge-zigbee-nt)## Description
This Homebridge plugin exposes ZigBee devices connected to TI's [CC253X](http://www.ti.com/wireless-connectivity/simplelink-solutions/zigbee/products.html) wireless SoC to Apple's HomeKit.
It uses [zigbee-herdsman](https://github.com/Koenkk/zigbee-herdsman) and [zigbee-herdsman-converters](https://github.com/Koenkk/zigbee-herdsman-converters) under the hood, so technically all supported devices mapped in zigbee-herdsman-converters should be supported.
To enable a new device you must implement a new HomeKit Device class and regirster it.This project has been heavily inspired by [homebridge-zigbee](https://github.com/itsmepetrov/homebridge-zigbee) plugin by Anton Petrov.
## Supported devices
[See wiki page](https://github.com/madchicken/homebridge-zigbee-nt/wiki/Supported-devices)
## Build from sources
To build and run the plugin from sources, you need to install [yarn](https://yarnpkg.com) first.
Clone the repo:
git clone [email protected]:madchicken/homebridge-zigbee-nt.git
Once you get it, run yarn command:
cd homebridge-zigbee-nt
yarn && yarn buildYou should end up with a new `dist/` folder containing the compiled version of the plugin.
## WEB UI
From version 1.0.8 you can see which device is paired through the [WEB UI exposed on port 9000](http://homebridge.local:9000).
To change the default port, set `httpPort: YOUR_PORT_NUMBER` in the configuration.
To completely disable http UI, set `disableHttpServer: true` in the configuration.## License
Licensed under [Apache 2.0](LICENSE)
## Contribute
Any PR is welcome to this project, so please, fork and open one if you can!
If otherwise, you simply enjoyed using this plugin, and you want to contribute in some way, you can always donate something!
[![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://paypal.me/madchicken74)