New to Hue Server?
Check out the welcome-guide
and our tutorials
How to send a command?
Hue Server doesn't require a particular programing language.
All commands can be send via OSC, AppleScript or your voice (requires Hue Remote on iOS).
Enter a command by just starting to type into the Mac OS application.
Hue Server will auto-complete your input.
All you enter will be broadcasted in your local network via OSC.
This way you can make your own applications or hardware listen for your custom commands and trigger functions.
See the preferences.plist to hack around with the OSC input / output port and other nifty (advanced) options.
tell application "Hue Server" to run command "say:Hello World"
tell application "Hue Server" to run command "Green"
tell application "Hue Server" to run command "Random Album"
You'll find the Automator plugin at
/Library/Application Support/Hue Server/examples/Automator"
Use Processing, OSC
See the demo processing sketch. Hue Server will send & receive OSC so you can hook up almost anything.
/Library/Application Support/Hue Server/examples/Processing
Serial.print("say:Arduino is online!#");
Be sure to add a "#" after every command. Also enter your Arduino serial port via
replacing the string with your own device.
We recommend the Arduino tutorial
to get started.
Use the "search" field or your voice via Hue Remote on iOS.
What you can read as human you can also simply say via the speech recognition on iOS (via Hue Remote).
Control a single light:
"XXX" should be replaced by your lights or groups name
153 - 500 white color temperature from cold to warm
0 - 65535 hue value, the color
0 - 255 saturation
0 - 255 brightness
NOTICE: 0 brightness is not equal to the "off" command.
XXX: h:0 s:255
XXX: h:0 s:255 b:255
All lights will merge to the same brightness and brighten up.
Same but in the other direction. Dims all.
Control all lights:
h:65535 s:255 b:255
Will be applied to all lights that are on.
Dims the light and triggers a warm white.
Use the name of your light-scene to trigger it
Use the name of your AppleScripts to trigger it.
If an AppleScript an a light-scene have the same name they "merge to one" and will both be triggered.
You can manage your AppleScripts in the folder:
/Library/Application Support/Hue Server
iTunes next track
Good Night iTunes -t:600
Kitchen: h:23000 s:200 b:100 -t:0
Optionally you can override the default transition-time set on iOS by adding "-t:5" to your command.
5 stands for 5 ms; you can set a transition-time between 0ms and 2h.
Change the Mac OS system voice for more fun.
Sends a message to the Mac OS notification center.
You can access the txt files in the folder:
/Library/Application Support/Hue Server/.helper/log
Enables the logging in txt files
Disables the logging in txt files
Advanced option to feed the system a human context.
You'll find that variable in different AppleScripts to create very unique setups.
Trigger the motion system.
When you change your location through this command you'll trigger the "Location switch" AppleScript.
You can also trigger actions after minutes to hours while staying at the location. See the "Location update" AppleScript.
How long am I here?
After setting a location via "Location:XXX" you can ask how long you are at the new location.
Where am I?
The system will tell you about the current location.
Nothing is true, everything is permitted. The direct AI feedback from the inner core.
"Status" and other commands will make the system react via speech.
shows the input window of Hue Server. Put this action into an AppleScript to create a custom shortcut.
tell application "Hue Server" to run command "activate"
Feel free to share your experiments, applications and use cases with us.
You can find Processing, Arduino & AppleScripts demos at:
/Library/Application Support/Hue Server/examples
(the folder is inside the sandbox so just type "Scripts" into Hue Server and press enter to open it)