hue/README.md

Hue API Scripts

All the Python scripts are no longer being worked on and has been replaced by a single Perl script.

The script is huectl.pl together with hue.conf.

$ ./huectl.pl                   
Usage: hue/huectl.pl bridge-name [-t type] [-i id] [-s sensor] [-b percent] [-a action] [-v] [-d] [-p]
Options:
bridge-name    as defined in [HOME]./hue.conf or [HOME]./.hue.conf or /etc/hue.conf
-t | --type    [ lights | sensors | groups | all | trigger ] (default: lights)
-i | --id      light-id
-s | --sensor  sensor-id
-b | --battery percent of battery level to report on, only relevant with sensors
-c | --climate show temperature of sensors in C, only relevant with sensors
-a | --action  [ on | off | state | bright | relax | morning | dimmed | evening | nightlight ] (default: state)
-v | --verbose  
-d | --debug   raw JSON output
-p | --pretty  pretty JSON output

Command examples:
hue/huectl.pl bridge1
	Displays all lights of bridge1
hue/huectl.pl bridge1 -i 8
	Check for state of light-id 8
hue/huectl.pl bridge2 -t lights -i 8 -a bright
	Turn on light-id 8 with the scene bright
hue/huectl.pl bridge2 -t trigger -i 8 -s 34 -a evening
	Check for 'dark' state of sensor-id 34, turn on light-id 8 with the scene evening
hue/huectl.pl bridge1 -t sensors -c
	Displays temperature of all sensors in C

Config example:
# huectl,pl config file locations:
# ~/hue.conf, ~/.hue.conf, /etc/hue.conf, ./.hue.conf, ./hue.conf
[bridge1]
ip = 192.168.100.101
token = bridge1token
[bridge2]
ip = 192.168.100.102
token = bridge2token