I rewrote most of this as an app that is far more user friendly. If you just want something that works and has far more features and is easier to use, take a look at http://huelightsapp.com.
With this, you get full control over your Hue light bulbs. You can easily view light status, do complex controls of your lights such as pulsing a color.
Sets let you save a light configuration and then easily restore or turn it off later. You can even use this on simple browsers like a Kindle. No need to find your phone to turn on reading lights, or turn them off after you're done.
The goal is for most of this to work under modern browsers. Any reasonably up to date version of Chrome, Firefox or Safari should work fine. IE9 and up should also work, but isn't guaranteed.
To view screenshots of the app in action, click here
Any Ruby 1.9.3+ version should work, JRuby 1.7.x is optimal for the background worker, but not required. You might be able to use a 1.8.7 version of Ruby, but I've not tested it.
Got Ruby installed? Next:
gem install bundler if you don't have bundler installed (when in doubt, you can just run it safely)
thin -R config.ru -p 9200 -e production start, this starts the web server
ruby worker.rb --cores 2 -e production, this starts the background worker
5) Go to
Pull requests are more than welcome if you want to add new functionality or ways of extending the Hue lightbulbs.
You can find documentation on the API at: http://blog.ef.net/2012/11/02/philips-hue-api.html
All of this uses the standard APIs, but it does give you more granular access to the API than the official apps do.
While you shouldn't be able to break your lights by using this, if you set your lights to pulse every 100ms for 6 hours and they break, it's your own fault.