Skip to content

Latest commit

 

History

History
79 lines (56 loc) · 1.55 KB

README.md

File metadata and controls

79 lines (56 loc) · 1.55 KB
Raw

Philips Hue Rust Library and CLI

This is currently in development stage!

Hue-rs, let there be light!

Hue-rs is a Rust library that can be used for home automation on Philips Hue lights. It offers a basic CLI with which you can control your lights from a terminal instead of looking for your phone and making desired changes from official Philips Hue app.

Progress

Todo

  • Tests
  • Finalize light, group and scene API
  • Let there be light voice recognition

Done

  • Lights
    • Get all lights
    • [x]

Installation and CLI use

$ cat <<EOF > ~/.huerc
debug = false

[hue]
ip = 192.168.0.1
username = <philips-hue-username>
EOF

$ hue help

hue 1.0
Marko Kosmerl <[email protected]>
Philips Hue CLI

USAGE:
    hue [FLAGS] [OPTIONS] <SUBCOMMAND>

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information
    -v               Sets the level of verbosity

OPTIONS:
    -c, --config <FILE>    Sets a custom config file

SUBCOMMANDS:
    group    Controls a group of lights
    help     Prints this message or the help of the given subcommand(s)
    light    Controls a light(s)
    scene    Controls a scene(s)
    
$ hue light on 1
[{"success":{"/lights/1/state/on":true}}]

Library use

extern crate hue-rs;

use hue-rs::*;
use hue-rs::lights::*;

pub fn funhue() {
    let client = Client::new();

    let mut light = Light::get_light(&client, 1).unwrap();
    let &mut light_state = light.state();
    light_state.set_on(true);
    light.update()
}