README
Control and monitor your Xiaomi Mi Air Purifier purifier with HomeKit.
Features
- Air Purifier Accessory
- Turn on/off
- Control Fan Speed
- Toggle Child Lock
- Change Mode (Auto/Manual)
- Filter Live Level
- Filter Change Warning
- Air Quality Sensor
- Air Quality
- PM2.5 Density
- Temperature Sensor
- Relative Humidity Sensor
Prerequisites
- Installation of Homebridge
Installation
Install using npm
:
npm install -g homebridge-xiaomi-mi-air-purifier
Or, search for homebridge-xiaomi-mi-air-purifier
in Plugins.
Note that it might be neccessary to enter the search string inside double quotes i.e. "homebridge-xiaomi-mi-air-purifier"
in some Homebridge UI variants (such as Hoobs) in order to find it among the plethora of similarly named plugins.
Configuration
Configure the plugin in the GUI / Homebridge Config UI X (highly recommended), otherwise head over to Manual Config
![Settings: Xiaomi Mi Air Purifier](https://raw.githubusercontent.com/torifat/xiaomi-mi-air-purifier/assets/media/settings-xiaomi-mi-air-purifier.png)
Getting a Token
Use Xiaomi Cloud Tokens Extractor to get a token for your device.
Manual Config
Add this to your homebridge config.json file.
{
"accessories": [
{
"name": "Air Purifier",
"address": "<YOUR_DEVICE_IP_ADDRESS>",
"token": "<YOUR_DEVICE_TOKEN>",
"enableAirQuality": true,
"enableTemperature": true,
"enableHumidity": true,
"filterChangeThreshold": 5,
"enableFanSpeedControl": true,
"enableChildLockControl": true,
"accessory": "XiaomiMiAirPurifier"
}
]
}
HomeKit pairing
- Open the Home
app on your device.
- Tap the Home tab, then tap
.
- Tap Add Accessory, and select I Don't Have a Code or Cannot Scan.