5 releases (3 breaking)

0.4.0 Jan 31, 2023
0.3.1 Feb 9, 2022
0.3.0 Feb 9, 2022
0.2.0 Sep 11, 2018
0.1.0 Sep 1, 2018

#20 in #lan

Download history 10/week @ 2024-01-01 18/week @ 2024-01-08 9/week @ 2024-01-15 14/week @ 2024-01-22 5/week @ 2024-01-29 21/week @ 2024-02-19 25/week @ 2024-02-26 9/week @ 2024-03-04 31/week @ 2024-03-11 15/week @ 2024-03-18 103/week @ 2024-04-01

150 downloads per month



github crates.io docs.rs


LIFX bulbs are wifi-controlled RGBW light bulbs. The bulbs can be controlled directly by sending packets to them over the LAN, or they can be controlled over the internet via an HTTP API.

This library provides functionality for inspecting and controlling the bulbs over the LAN only.

The LIFX protocol docs can be found here.


This library implements all the data structures and utilities for inspecting and constructing the low-level control packets. It does not deal with the actual sending or receiving of bytes from the network.

Supported LIFX products:

  • Light bulbs
  • Multizone devices (LIFX Z and Beam)
  • Relay devices (LIFX Switch)
  • Tile devices

Note: While this library has support for several different LIFX products, some of them are not tested. Feedback in the form of a github issue would be appreciated, if you find that type of device isn't working correctly.

Higher level library

Eventually this library will also include a higher-level library that will take care of talking with the network, maintaining bulb state, etc. But this isn't ready yet.

License and terms

This library code is licensed under either of:

at your option.

Much of the documentation in this library is taken from the LIFX protocol docs. Using this library to communicate with LIFX bulbs likely binds you to the LIFX Developer Terms.


~21K SLoC