Huehue

A Rust wrapper for Hue API v2.

Note that the Hue API v2 is in early access at the time of writing, so an upgrade to it could break applications in unpredictable way.

Features

• Hue Bridge certificate validation.
• Bridge discovery:
  • through mDNS.
  • through discovery.meethue.com.
  • user specified IPv4 address.
• Devices:
  • list devices.
• Light:
  • switch on/off.
  • color in the CIE 1931 color space.
  • color in the sRGB color space.
  • dimming.
• Smart plug:
  • switch on/off.
  • note: smart plug is exposed as a light, since it is also listed as a light by Hue.
• XY to RGB and RGB to XY conversion.

Examples

The examples folder has fully functional sample applications to demonstrate some implemented features. The examples aim to be trivial to understand by focusing on specific functionality, and should be easy to copy and build your own application.

Simply use cargo to run the desired example:

$ cargo run --example scan

Scanning for bridges for 5 seconds.
1 bridges found.

> Bridge #1:
        Identifier: 1231231231231234
        Model: BSB002
        Version: 1948086000
        Address: 192.168.2.124
        Supported: true

Code Style

Code style is enforced. It requires a nightly profile and rustfmt to be installed. Once they are installed, create a Git pre-commit hook, so you don't ever have to worry about it again.

$ ln -sr pre-commit .git/hooks/pre-commit