- Configure presets with colors, assigned resources (Light and/or Groups) and timing.
- Set hue resources with GCODE commands (e.g. Terminal window, OctoPrint GCODE Scripts).
- Control resources per command line or sidebar buttons.
- Discover hue bridge.
- Dialog to create hue user.
Install via the bundled Plugin Manager or manually using this URL:
Hue Bridge Configuration
hueCommands requires 3 settings to function
- The IP Address of you hue bridge selectable from drop down list after discovery.
- A User for OctoPrint to use when contacting your bridge which can be created by pushing the bridge button.
- The numeric ID of your hue resources(lights or groups) which are available from drop down list when you are connected to a hue bridge.
Hue User for OctoPrint
If you have a user name already, enter it and use the asterisk for testing your connection. To find or configure these can be found in How to Develop for Hue - Getting Started
To create a user name, leave the field empty and enter a device name or click the asterisk button to create one. After that press the button of your bridge and than click the asterisk button a second time.
Light and Group ID's
As soon you are connected to your hue bridge, the IDs are available as drop down menu.
To control multiple lights:
If a the lights are not yet grouped, use the Hue app (or API directly if you're feeling hardcore) to create a room or zone consisting of the intended lights.
Once done, the list of available Group ID's can be found at:
Once you have the hue IP, user name, enter these into the appropriate field in hueCommands menu in settings. Use the Light/Group ID for settings
||Switch lamp/group on using preset RED|
||Switch lamp/group off using preset RED|
||Switch lamp 15 off.|
||Transition lamp 15 in 2.5 sec to last state.|
||Transition lamp 15 in 1.5 sec to last state.|
||Switch Lamp 15 Gray (= 50% White).|
||Switch group 15 to 50% White (= Gray).|
||Transition group 15 in 90 sec to 100% Silver (= White).|
hue Command syntax
hue [$preset] [[Ln]/[Gn]] [[on]/[off]] [[Tnnnnn]/[Dnnnn]/[Mhh:mm:ss]] [[#nnnnnn]/[Knnnnnn]] [Bbbb]/[%ppp] [[Sbbb]/[Vppp]]
|preset ID||Preset ID from the list above. Not all values must be set; Zero (0) values are ignored.|
|Ln||Lamp with device number n|
|Gn||Group with device number n|
|Tnnnnn||Transitiontime n in 1/10 seconds between 0 and 65535|
|Dnnnn.n||Duration-/Transitiontime n in seconds between 0 and 6553.5|
|Mhh:mm:ss.h||Transitiontime in time format between 0:00:00 and 1:49:13.5|
|#rrggbb||RGB color Red/Green/Blue|
|Knnnnnn||color temperature n in Kelvin|
|Cnnnnnn||color temperature n between 0 and 65535|
|Bbbb||Brightness b between 1 and 254|
|%ppp.p||Brightness p in percent between 0.0 and 100.0|
|Sbbb||Saturation b between 0 and 254|
|Vppp.p||Saturation value p in percent between 0.0 and 100.0|
|Hnnnnnn||Hue n between 0 and 65535|
|Uppp.p||Hue p in percent between 0.0 and 100.0|
Support My Efforts
I programmed this plugin for fun and do my best effort to support those that have issues with it, please return the favor and support me.