forked from Koenkk/zigbee2mqtt
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
3 changed files
with
29 additions
and
31 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,49 +1,47 @@ | ||
[](https://api.travis-ci.org/Koenkk/zigbee2mqtt.svg) | ||
|
||
# zigbee2mqtt :bridge_at_night: :honeybee: | ||
 | ||
<img align="right" height="40px" src="https://user-images.githubusercontent.com/7738048/40915536-1993dd32-6805-11e8-9f22-4dfca52133c0.png"> | ||
|
||
Allows you to use your Zigbee devices **without** the vendors (Xiaomi/TRADFRI/Hue) bridge or gateway. | ||
|
||
It bridges events and allows you to control your Zigbee devices via MQTT. In this way you can integrate your Zigbee devices with whatever smart home infrastructure you are using. | ||
|
||
## [Getting started](https://github.com/Koenkk/zigbee2mqtt/wiki/Getting-started) | ||
The [wiki](https://github.com/Koenkk/zigbee2mqtt/wiki) provides you all the information needed to get up and running! Make sure you don't skip sections if this is your first visit, as there might be important details in there for you. | ||
|
||
[The documentation](https://github.com/Koenkk/zigbee2mqtt/wiki) will provide information on how to prepare, configure and start **zigbee2mqtt**, but also on how to customize the setup to fit your needs. | ||
|
||
If you aren't familiar with **zigbee** terminology make sure you [read this](https://github.com/Koenkk/zigbee2mqtt/wiki/ZigBee-network) to help you out. | ||
|
||
## Integrations | ||
<div align="center"> | ||
<a href="https://github.com/koenkk/zigbee2mqtt"> | ||
<img width="150" height="150" src="images/logo.png"> | ||
</a> | ||
<br> | ||
<br> | ||
<img src="https://img.shields.io/travis/Koenkk/zigbee2mqtt.svg"> | ||
<h1>Zigbee2mqtt 🌉 🐝</h1> | ||
<p> | ||
Allows you to use your Zigbee devices <b>without</b> the vendors bridge or gateway. | ||
</p> | ||
<p> | ||
It bridges events and allows you to control your Zigbee devices via MQTT. In this way you can integrate your Zigbee devices with whatever smart home infrastructure you are using. | ||
</p> | ||
</div> | ||
|
||
## [Getting started](https://koenkk.github.io/zigbee2mqtt/#getting-started) | ||
The [documentation](https://koenkk.github.io/zigbee2mqtt/) provides you all the information needed to get up and running! Make sure you don't skip sections if this is your first visit, as there might be important details in there for you. | ||
|
||
If you aren't familiar with **Zigbee** terminology make sure you [read this](https://koenkk.github.io/zigbee2mqtt/information/zigbee_network.html) to help you out. | ||
|
||
## [Integrations](https://koenkk.github.io/zigbee2mqtt/#integration) | ||
Zigbee2mqtt integrates well with (almost) every home automation solution because it uses MQTT. However the following integrations are worth mentioning: | ||
|
||
<img align="left" height="100px" width="100px" src="https://user-images.githubusercontent.com/7738048/40914297-49e6e560-6800-11e8-8904-36cce896e5a8.png"> | ||
|
||
### [Home Assistant](https://www.home-assistant.io/) | ||
- [Hassio](https://www.home-assistant.io/hassio/): Using [the official addon](https://github.com/danielwelch/hassio-zigbee2mqtt) from [danielwelch](https://github.com/danielwelch) | ||
- Generic install or Hassbian: Using instructions [here](https://github.com/Koenkk/zigbee2mqtt/wiki/Integrating-with-Home-Assistant) | ||
- Generic install or Hassbian: Using instructions [here](https://koenkk.github.io/zigbee2mqtt/integration/home_assistant.html) | ||
|
||
<img align="left" height="100px" width="100px" src="https://user-images.githubusercontent.com/2734836/47615848-b8dd8700-dabd-11e8-9d77-175002dd8987.png"> | ||
|
||
### [Domoticz](https://www.domoticz.com/) | ||
- Integration implemented in [domoticz-zigbee2mqtt-plugin](https://github.com/stas-demydiuk/domoticz-zigbee2mqtt-plugin) | ||
|
||
## Architecture | ||
<br> | ||
|
||
## Architecture | ||
 | ||
|
||
## Supported devices | ||
See [Supported devices](https://github.com/Koenkk/zigbee2mqtt/wiki/Supported-devices) to check whether your device is supported. There is quite an extensive list, including devices from vendors like Xiaomi, Ikea, Philips, OSRAM and more. | ||
See [Supported devices](https://koenkk.github.io/zigbee2mqtt/information/supported_devices.html) to check whether your device is supported. There is quite an extensive list, including devices from vendors like Xiaomi, Ikea, Philips, OSRAM and more. | ||
|
||
If it's not listed in [Supported devices](https://github.com/Koenkk/zigbee2mqtt/wiki/Supported-devices), support can be added (fairly) easy, see [How to support new devices](https://github.com/Koenkk/zigbee2mqtt/wiki/How-to-support-new-devices). | ||
If it's not listed in [Supported devices](https://koenkk.github.io/zigbee2mqtt/information/supported_devices.html), support can be added (fairly) easy, see [How to support new devices](https://koenkk.github.io/zigbee2mqtt/how_tos/how_to_support_new_devices.html). | ||
|
||
## Support & help | ||
If you need assistance you can check [opened issues](https://github.com/Koenkk/zigbee2mqtt/issues). Feel free to help with Pull Requests when you were able to fix things or add new devices or just share the love on social media. | ||
|
||
## Contributors | ||
* [AndrewLinden](https://github.com/AndrewLinden) | ||
* [oskarn97](https://github.com/oskarn97) | ||
* [dgomes](https://github.com/dgomes) | ||
* [Koenkk](https://github.com/Koenkk) | ||
* [kirovilya](https://github.com/kirovilya) | ||
* [ciotlosm](https://github.com/ciotlosm) | ||
If you need assistance you can check [opened issues](https://github.com/Koenkk/zigbee2mqtt/issues). Feel free to help with Pull Requests when you were able to fix things or add new devices or just share the love on social media. |
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.