From ec6ead1fd58cc4b98cb1d02340cdf51e1b6dd768 Mon Sep 17 00:00:00 2001 From: Andrew Williams Date: Sun, 8 Jan 2017 21:33:39 +0000 Subject: [PATCH] Added README --- README.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..296618f --- /dev/null +++ b/README.md @@ -0,0 +1,32 @@ +Philips Hue Munin Plugin +======================== + +A Munin plugin to take advantage of sensor data provided by Philips Hue motion sensors. The sensors provide Temperature (in degrees celcius) and Light Level (in lux). + +Requirements +------------ + +* Requests +* [python-munin](https://github.com/samuel/python-munin) + +Modes +----- + +* ```hue_temperature``` returns graphs showing all temperature sensors. +* ```hue_lightlevel``` returns the light level. +* ```hue_all``` shows a combination graph of all values. + +Munin Configuration +------------------- + +These values will be set in your ```plugin-conf.d/munin-node``` file. + +* ```hub_address``` - IP address of the Philips Hue hub +* ```api_key``` - API Key/User ID to access the Hue API. + +Example Config +-------------- + + [hue_*] + env.hub_address 10.1.1.2 + env.api_key test1234 \ No newline at end of file