Skip to main content

Python library for interfacing with Xiaomi smart appliances

Project description

PyPI version Build Status Code Health Coverage Status Documentation status

This library (and its accompanying cli tool) is used to interface with devices using Xiaomi’s miIO protocol.

Supported devices

  • Xiaomi Mi Robot Vacuum (miio.vacuum)

  • Xiaomi Mi Home Air Conditioner Companion (miio.airconditioningcompanion)

  • Xiaomi Mi Air Purifier (miio.airpurifier)

  • Xiaomi Mi Smart WiFi Socket (miio.chuangmi_plug)

  • Xiaomi Chuangmi Plug V1 (1 Socket, 1 USB Port) (miio.chuangmi_plug)

  • Xiaomi Chuangmi Plug V3 (1 Socket, 2 USB Ports) (miio.chuangmi_plug)

  • Xiaomi Smart Power Strip V1 and V2 (WiFi, 6 Ports) (miio.powerstrip)

  • Xiaomi Philips Eyecare Smart Lamp 2 (miio.philips_eyecare)

  • Xiaomi Philips LED Ceiling Lamp (miio.ceil)

  • Xiaomi Philips LED Ball Lamp (miio.philips_bulb)

  • Xiaomi Philips Zhirui Smart LED Bulb E14 Candle Lamp (miio.philips_bulb)

  • Xiaomi Philips Zhirui Bedroom Smart Lamp (miio.philips_moonlight)

  • Xiaomi Universal IR Remote Controller (Chuangmi IR) (miio.chuangmi_ir)

  • Xiaomi Mi Smart Pedestal Fan V2, V3, SA1 and ZA1 (miio.fan)

  • Xiaomi Mi Air Humidifier (miio.airhumidifier)

  • Xiaomi Mi Water Purifier (Basic supportmiio.waterpurifier)

  • Xiaomi PM2.5 Air Quality Monitor (miio.airqualitymonitor)

  • Xiaomi Smart WiFi Speaker (miio.wifispeaker) (incomplete, please feel free to help improve the support)

  • Xiaomi Mi WiFi Repeater 2 (miio.wifirepeater)

  • Xiaomi Mi Smart Rice Cooker (miio.cooker)

  • Xiaomi Smartmi Fresh Air System (miio.airfresh)

  • Yeelight light bulbs (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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python-miio-0.4.4.tar.gz (134.0 kB view hashes)

Uploaded Source

Built Distribution

python_miio-0.4.4-py3-none-any.whl (117.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page