https://github.com/bluebie/homebridge-miio

Xiaomi Mi Home Plugin for Homebridge
https://github.com/bluebie/homebridge-miio

homebridge homebridge-plugin mi-home mihome

Last synced: 11 months ago
JSON representation

Xiaomi Mi Home Plugin for Homebridge

• Host: GitHub
• URL: https://github.com/bluebie/homebridge-miio
• Owner: Bluebie
• Created: 2017-03-25T17:17:39.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2020-03-16T13:59:19.000Z (about 6 years ago)
• Last Synced: 2025-06-28T22:50:09.420Z (11 months ago)
• Topics: homebridge, homebridge-plugin, mi-home, mihome
• Language: JavaScript
• Homepage:
• Size: 20.5 KB
• Stars: 111
• Watchers: 12
• Forks: 26
• Open Issues: 18
• Metadata Files:
  • Readme: readme.markdown

Awesome Lists containing this project

README

          
**homebridge-miio** is a platform plugin for homebridge which lets you switch

Xiaomi Power Plugs on and off using Homekit apps and Siri.

**Note: this plugin works for me, but i'm not motivated to maintain it's

compatibility with other devices or firmware versions that i'm not using.

If you have problems, please send some pull requests! Opening an issue isn't

enough. I'm not "upgrading" my devices to incompatible firmware versions just

to debug issues for you.**

It seems very reliable now, and should coexist happily with other Xiaomi home

automation ecosystem plugins. Eventually it would be nice to support some other

device types, if people who have those devices want to do pull requests, or

donate hardware, it'd surely be welcomed. You don't need to configure anything,

just install the platform plugin with `npm install -g homebridge-miio`. devices

on the same subnet as your homebridge server will be discovered at launch and

every half hour after that, and supported devices will be polled for changes

occasionally to keep things responsive.

Here's an example homebridge config file, you could use to tweak the default

settings. Numbers are presented in seconds. If you choose to disable

`pollChanges` you may see some inconsistency if you also control your miIO

devices via the Mi Home app (including via Mi Home app timers).

_Note that currently only the WiFi plugs are supported, not the gateway-based

ones operating over Zigbee, though this is likely to change in the future._

```json

{

  "bridge": {

    "name": "TestBridge",

    "username": "CC:22:3D:E3:CE:33",

    "port": 51826,

    "pin": "031-45-154"

  },

  "description": "Test Bridge",

  "accessories": [],

  "platforms": [

    {

      "platform" : "XiaomiMiio",

      "name" : "XiaomiMiio",

      "pollChanges": true,

      "pollInterval": 15,

      "searchInterval": 1800

    }

  ]

}

```