a low level, cross-platform command line client for Yeelight
Switch branches/tags
Nothing to show
Clone or download
Latest commit b266f8b Apr 13, 2018
Failed to load latest commit information.
src add command line args usage Apr 11, 2018
.gitignore add .gitignore Apr 6, 2018
Cargo.lock update lockfile Apr 13, 2018
Cargo.toml v0.2.0 Apr 13, 2018
LICENSE.md add markdown files Apr 4, 2018
README.md fix readme Apr 11, 2018



cargo install yee

This is a cross-platform command line client for Xiaomi's Yeelight. It is a very low-level implementation, and I believe it is possible to build something on top of this, maybe even a GUI. This still needs a lot of work to be full-featured, however, I believe it is usable at this stage.


You can use any method in Yeelight Specification as long as your device supports it, as this program is essentially a wrapper around it.

You need to enable LAN Control using the official Yeelight mobile app before attempting to use this, or any other 3rd party client.

Using with command line arguments

You can also use this program with command line arguments, this is useful for performing simple operations such as turning the light off and on. To use with command line arguments, you need to know your light bulb's assigned name, or if you haven't assigned a name yet, you have to assign it.

For example:

yee mybulb toggle

would look for a lightbulb named "mybulb", and toggle it.


I encountered many difficulties developing this as the only source codes I was able to found was from non-English speaking developers and it made reading comments and grasping difficult parts hard. I believe this can act as a guide for developers who are new to writing programs for this kind of devices, especially Yeelight.