[](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)
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](https://homebridge.io/)
## Installation
Install using `npm`:
```bash
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](https://hoobs.com/)) in order to find it among the plethora of similarly named plugins.
## Configuration
Configure the plugin in the GUI / [Homebridge Config UI X](https://github.com/oznu/homebridge-config-ui-x) (highly recommended), otherwise head over to [Manual Config](#manual-config)
### Getting a Token
Use [Xiaomi Cloud Tokens Extractor](https://github.com/PiotrMachowski/Xiaomi-cloud-tokens-extractor) to get a token for your device.
### Manual Config
Add this to your homebridge config.json file.
```json
{
"accessories": [
{
"name": "Air Purifier",
"address": "",
"token": "",
"enableAirQuality": true,
"enableTemperature": true,
"enableHumidity": true,
"filterChangeThreshold": 5,
"enableFanSpeedControl": true,
"enableChildLockControl": true,
"accessory": "XiaomiMiAirPurifier"
}
]
}
```
## HomeKit pairing
1. Open the Home 
app on your device.
2. Tap the Home tab, then tap 
.
3. Tap _Add Accessory_, and select _I Don't Have a Code or Cannot Scan_.