Skip to main content

Python library for interfacing with Xiaomi smart appliances

Project description

PyPI version Build Status Coverage Status Documentation status Black Hound

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

Supported devices

  • Xiaomi Mi Robot Vacuum V1, S5, M1S

  • Xiaomi Mi Home Air Conditioner Companion

  • Xiaomi Mi Air Purifier

  • Xiaomi Aqara Camera

  • Xiaomi Aqara Gateway (basic implementation, alarm, lights)

  • Xiaomi Mijia 360 1080p

  • Xiaomi Mijia STYJ02YM (Viomi)

  • Xiaomi Mi Smart WiFi Socket

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

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

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

  • Xiaomi Philips Eyecare Smart Lamp 2

  • Xiaomi Philips RW Read (philips.light.rwread)

  • Xiaomi Philips LED Ceiling Lamp

  • Xiaomi Philips LED Ball Lamp (philips.light.bulb)

  • Xiaomi Philips LED Ball Lamp White (philips.light.hbulb)

  • Xiaomi Philips Zhirui Smart LED Bulb E14 Candle Lamp

  • Xiaomi Philips Zhirui Bedroom Smart Lamp

  • Xiaomi Universal IR Remote Controller (Chuangmi IR)

  • Xiaomi Mi Smart Pedestal Fan V2, V3, SA1, ZA1, ZA3, ZA4, P5

  • Xiaomi Mi Air Humidifier V1, CA1, CB1, MJJSQ, JSQ001

  • Xiaomi Mi Water Purifier (Basic support: Turn on & off)

  • Xiaomi PM2.5 Air Quality Monitor V1, B1, S1

  • Xiaomi Smart WiFi Speaker

  • Xiaomi Mi WiFi Repeater 2

  • Xiaomi Mi Smart Rice Cooker

  • Xiaomi Smartmi Fresh Air System VA2 (zhimi.airfresh.va2), T2017 (dmaker.airfresh.t2017)

  • Yeelight lights (basic support, we recommend using python-yeelight)

  • Xiaomi Mi Air Dehumidifier

  • Xiaomi Tinymu Smart Toilet Cover

  • Xiaomi 16 Relays Module

  • Xiaomi Xiao AI Smart Alarm Clock

  • Smartmi Radiant Heater Smart Version (ZA1 version)

  • Xiaomi Mi Smart Space Heater

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.

Contributing

We welcome all sorts of contributions from patches to add improvements or fixing bugs to improving the documentation. To ease the process of setting up a development environment we have prepared a short guide for getting you 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.5.0.1.tar.gz (180.2 kB view details)

Uploaded Source

Built Distribution

python_miio-0.5.0.1-py3-none-any.whl (202.3 kB view details)

Uploaded Python 3

File details

Details for the file python-miio-0.5.0.1.tar.gz.

File metadata

  • Download URL: python-miio-0.5.0.1.tar.gz
  • Upload date:
  • Size: 180.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: Python-urllib/3.8

File hashes

Hashes for python-miio-0.5.0.1.tar.gz
Algorithm Hash digest
SHA256 fa9c318256945ad4a8623fdf921ce81c466a7aea18b04a6711efb662f520b195
MD5 e33fc8baf39f56e578fd1fb318252681
BLAKE2b-256 2691b1e15f96296dfc9781c53f1211f55ab4915dd3cfe517c96fa4d9c61b7993

See more details on using hashes here.

File details

Details for the file python_miio-0.5.0.1-py3-none-any.whl.

File metadata

File hashes

Hashes for python_miio-0.5.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 eb2867182eebe8d3b72fbe97382bab6422b0b0f178a4550861bee0ca6c8a1ca5
MD5 ad894a3d9330feafa487ba339eb87381
BLAKE2b-256 08ed492fc83986135c00815a1b08a1a9c50a8250cfb7a2429767f5d848fcd7eb

See more details on using hashes here.

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