commit b7340d582739bbdc66d544683cb70d6d1fde20d6
from: mischa <mischa@rx.high5.nl>
date: Mon Jul 18 14:55:11 2022 UTC

added README.md

commit - 1c97f7cec18adbf97b2c94dc936a1b64585fcb65
commit + b7340d582739bbdc66d544683cb70d6d1fde20d6
blob - /dev/null
blob + a0d383633cd4f47740033c5a311e2b5afaa93ccf (mode 644)
--- /dev/null
+++ README.md
@@ -0,0 +1,42 @@
+### 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](https://git.high5.nl/hue/tree/huectl.pl) together with [hue.conf(https://git.high5.nl/hue/tree/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
+