python-miio
This library (and its accompanying cli tool) is used to interface with devices using Xiaomi's miIO protocol.
Supported devices
- :doc:`Xiaomi Mi Robot Vacuum <vacuum>` (:class:`miio.vacuum`)
- Xiaomi Mi Home Air Conditioner Companion (:class:`miio.airconditioningcompanion`)
- Xiaomi Mi Air Purifier (:class:`miio.airpurifier`)
- Xiaomi Aqara Camera (:class:`miia.aqaracamera`)
- :doc:`Xiaomi Mi Smart WiFi Socket <plug>` (:class:`miio.chuangmi_plug`)
- :doc:`Xiaomi Chuangmi Plug V1 (1 Socket, 1 USB Port) <plug>` (:class:`miio.chuangmi_plug`)
- :doc:`Xiaomi Chuangmi Plug V3 (1 Socket, 2 USB Ports) <plug>` (:class:`miio.chuangmi_plug`)
- Xiaomi Smart Power Strip V1 and V2 (WiFi, 6 Ports) (:class:`miio.powerstrip`)
- :doc:`Xiaomi Philips Eyecare Smart Lamp 2 <eyecare>` (:class:`miio.philips_eyecare`)
- :doc:`Xiaomi Philips LED Ceiling Lamp <ceil>` (:class:`miio.ceil`)
- Xiaomi Philips LED Ball Lamp (:class:`miio.philips_bulb`)
- Xiaomi Philips Zhirui Smart LED Bulb E14 Candle Lamp (:class:`miio.philips_bulb`)
- Xiaomi Philips Zhirui Bedroom Smart Lamp (:class:`miio.philips_moonlight`)
- Xiaomi Universal IR Remote Controller (Chuangmi IR) (:class:`miio.chuangmi_ir`)
- Xiaomi Mi Smart Pedestal Fan V2, V3, SA1 and ZA1 (:class:`miio.fan`)
- Xiaomi Mi Air Humidifier (:class:`miio.airhumidifier`)
- Xiaomi Mi Water Purifier (Basic support: Turn on & off) (:class:`miio.waterpurifier`)
- Xiaomi PM2.5 Air Quality Monitor (:class:`miio.airqualitymonitor`)
- Xiaomi Smart WiFi Speaker (:class:`miio.wifispeaker`)
- Xiaomi Mi WiFi Repeater 2 (:class:`miio.wifirepeater`)
- Xiaomi Mi Smart Rice Cooker (:class:`miio.cooker`)
- Xiaomi Smartmi Fresh Air System (:class:`miio.airfresh`)
- :doc:`Yeelight light bulbs <yeelight>` (:class:`miio.yeelight`) (only a very rudimentary support, use python-yeelight for a more complete support)
Feel free to create a pull request to add support for new devices as well as additional features for supported devices.
Getting started
Refer the manual for getting started.
Home Assistant support
- Xiaomi Mi Robot Vacuum
- Xiaomi Philips Light
- Xiaomi Mi Air Purifier and Air Humidifier
- Xiaomi Smart WiFi Socket and Smart Power Strip
- Xiaomi Universal IR Remote Controller
- Xiaomi Mi Air Quality Monitor (PM2.5)
- Xiaomi Mi Home Air Conditioner Companion
- Xiaomi Mi WiFi Repeater 2
- Xiaomi Mi Smart Pedestal Fan
- Xiaomi Mi Smart Rice Cooker
- Xiaomi Raw Sensor