Xiaomi Mi Air Purifier
homebridge-xiaomi-mi-air-purifier · v2.0.2
Adds the Xiaomi Mi Air Purifier with fan speed, modes, filter life, air quality and temperature and humidity.
What it says it supports
Brands
- Xiaomi
- Mi
Devices it names
- Xiaomi Mi Air Purifier
Shows up in Apple Home as from its README
What people report
Older Mi Air Purifier models work; newer miot models (3C, 4 Pro) show No Response and are unsupported pending a library change. Purifier 2 series has partial control.
- Partly works1
- Not working1
- Requested2
| Device | Status | What they said | Source |
|---|---|---|---|
| Xiaomi Mi Air Purifier 2 / 2H | Partly works | On/off and sensors work; fan speed and child lock reported not working; 2H no dataSaved copyI use the Mi Air Purifier 2S model. I changed to this plugin from the my previous `homebridge-xiaomi-purifier-eu` (repo) because that was bombarding my log with "Lock Physical Controls" read handler errors. But it does not make anything better: now I get flooded logs again, but this time with an error related to Filter Life Level and Filter Change Indication instead and I don't think any controls work: [code] 😩 Excerpt saved from GitHub on 2026-10-22. | Issue #10 · 2021-01 |
| Xiaomi Mi Air Purifier 3C | Not working | Appears but No Response or cannot power on/off; not in supported listSaved copy… including Homebridge. Is there any progress on this already or can I support with any test? Follow snippets I have found yet: `[3/6/2021, 12:25:23 PM] [Air Purifier] Connected to "Air Purifier" @ 192.168.178.79! [3/6/2021, 12:25:23 PM] [homebridge-xiaomi-mi-air-purifier] This plugin generated a warning from the characteristic 'PM2.5 Density': characteristic was supplied illegal value: null! Home App will reject null for Apple defined characteristics. See https://git.io/JtMGR for more info. [3/6/2021, 12:25:23 PM] [homebridge-xiaomi-mi-air-purifier] This plugin generated a warning from the … Excerpt saved from GitHub on 2026-10-22. | Issue #15 · 2021-01 |
| Xiaomi Air Purifier 3H | Requested | Mentioned as covered by node-mihome migrationSaved copyThis one https://github.com/YinHangCode/homebridge-mi-airpurifier for 2h On 22 Jan 2021, at 23:15, ifeign wrote: Which plugin are you using? I've been using this one and it doesn't seem to work offline https://github.com/YinHangCode/homebridge-mi-airpurifier On Fri, Jan 22, 2021 at 11:41 AM adamrzanek wrote: > They all work without internet :) i have no internet access set on > homebridge and all xiaomi devices and it’s all working good > > > On 22 Jan 2021, at 20:36, ifeign wrote: > > > > > > I don't think any of the mi purifier plugins out there work without > > internet access.. or am … Excerpt saved from GitHub on 2026-10-22. | Issue #19 · 2021-01 |
| Xiaomi Smart Air Purifier 4 Pro | Requested | No connection; several users report sameSaved copyI have same issue for Xiaomi Air Purifier 4 Version: Xiaomi Mi Air Purifier homebridge-xiaomi-mi-air-purifier v2.0.2 Configuration: { "name": "空氣清新機", "address": "192.168.10.24", "token": "6c4ba2a9216b61f86badffcfbb8958f6", "enableAirQuality": true, "enableTemperature": true, "enableHumidity": true, "filterChangeThreshold": 5, "enableFanSpeedControl": true, "enableChildLockControl": false, "accessory": "XiaomiMiAirPurifier" } Error log: [1/30/2022, 5:17:51 PM] [homebridge-xiaomi-mi-air-purifier] This plugin threw an error from the characteristic 'Active': Unhandled error thrown inside read … Excerpt saved from GitHub on 2026-10-22. | Issue #277 · 2022-01 |
Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local
Xiaomi miIO protocol over LAN (assumed)
Compatibility
| Verified by Homebridge | Yes |
|---|---|
| Homebridge versions | >=1.3.0 |
| Homebridge 2.0 | No |
| Node.js | >=10.17.0 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | XiaomiMiAirPurifier |
| License | Apache-2.0 |
Community signals
| Downloads a week | 18 |
|---|---|
| Downloads a month | 63 |
| GitHub stars | 99 |
| Open issues | 34 |
| Closed issues | 19 |
| Last code push | 2023-03-07 |
| Latest version | 2.0.2 (2021-12-03) |
| First published | 2021-01-02 |
| Releases | 8 |
In ReReHome
Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.
Bridges get their own settings page listing the accessories behind them.
Caveats from the README
- Sparse README
