jghaanstra / com.xiaomi-miio

Homey app to control Mi Home devices that implement the miIO protocol and Xiaomi gateway child devices
GNU General Public License v3.0
456 stars 85 forks source link
gateway homey homeyapp mi mihome mihomey miio xiaomi zigbee

Homey app for Xiaomi Mi Home devices

Use Homey to control WiFi devices which connect trough the Xiaomi Mi Home app. You can also use this app to control Xiaomi / Aqara Zigbee devices which are connected to a Xiaomi gateway. There are no restrictions to the number of connected Zigbee devices, since you can have multiple Mi Gateway devices and distribute all Zigbee devices between them.

Important

Xiaomi does not officially support controlling devices from outside the Mi Home app. Additional steps are required for pairing these devices with Homey that require some technical knowledge. It also means not all available devices are supported. Also be aware that Xiaomi can make changes to it's eco system at any time resulting in Homey not being able to control these devices anymore.

Adding miIO devices

For Homey to be able to communicate with devices over the miIO protocol a unique device token needs to be obtained. In some cases technical knowledge is needed for retrieving these tokens. See the instructions here on retrieving device tokens.

(Un)supported devices

As mentioned not all available devices are supported. Here is a list of identified devices that should work. If you want support for a specific device please read this.

Support

Github is for bugs and features. If you need support, please use the community support forum and visit the support topic for further details.

Donations

I enjoy creating apps for Homey and try to support them as best as I can. If you enjoy using my apps a donation in return for the time I put into this is much appreciated.