Skip to content

torifat/xiaomi-mi-air-purifier

Repository files navigation

verified-by-homebridge

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

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

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

  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.