canack/huesmith

Huesmith is a Rust library that lets you turn a cheap ESP32 microcontroller board into a real smart light that pairs directly with a Philips Hue Bridge, without going through the cloud or needing a separate hub. Any LED setup you build, whether it is a simple on and off light, a dimmable bulb, a tunable white light, or a full color addressable strip, can be made to show up in the Hue app exactly like a genuine Philips bulb. This works because the Hue Bridge accepts new devices based on the wireless signals they broadcast rather than any secret verification, so a device that speaks the right protocol correctly is treated as trustworthy. To use the library, you write a small Rust program targeting the ESP32-C6 or ESP32-H2 chip, both of which support the Zigbee wireless standard the Hue Bridge uses. The project provides a standard scaffold of configuration files, and the only thing that changes between different light types is a single line calling one of huesmith's builder functions, such as choosing a dimmable light, a color changing strip, or a light with adjustable warm and cool white tones. Building the project the first time downloads the ESP-IDF development toolchain automatically, which can take up to thirty minutes, though later builds are much faster. Once flashed onto the chip, the light broadcasts itself over Zigbee and can be discovered and paired directly from the Hue Bridge, then controlled from the Hue app just like any store bought bulb. The library also offers a builder style API for customizing details such as whether the light starts on or off, its reported manufacturer and model name, its wireless channel, and its unique network address. Developers who have their own custom lighting hardware can also plug it in by implementing a small backend interface. Huesmith requires the Rust nightly toolchain along with a handful of ESP32 flashing tools, and works on both Linux and macOS. It is released under the MIT license, is written in Rust, and currently has 6 stars on GitHub, aimed at hobbyists who want to build their own smart lighting hardware that behaves as a first class citizen in the Philips Hue ecosystem.