node package manager


hue-hacking-npm: Hue Control Library

Build Status Coverage Status

hue-hacking is a javascript library designed to control the Philips Hue smart LED bulb system. This version has been modified to be used as a Node module.

For more information on the Philips Hue bulbs and wireless bridge system, visit

Initial concept and startup work inspired by Ross McKillop's post.

Getting Started

Once you've followed the instructions with your Hue starter kit and you have your lamps working through the web interface or smartphone app, it's time to configure your copy of hue.js.

For a full breakdown of what the Philips Hue API/SDK offers, check out the official developer site. Full details about how to register a new 'user' with the wireless bridge can be found at the SDK getting started page.

  1. Generate and save your MD5 hash (any MD5 generator will do). Be sure to save your hash and the passphrase used to generate it in a safe place.

  2. Find the IP address of your Hue wireless bridge. This can be gathered in a number of ways, including the control panel,, by clicking on the "Show me more" link. See screenshot for an example. Alternatively, you can browse to this URL, and use the value displayed in internalipaddress. This module now supports a static search operation, allowing you to find any Hue bridges attached to the local network (using the same UPNP approach as mentioned previously):

import { Hue, HueUPNPResponse } from 'hue-hacking-node';
const foundBridges: HueUPNPResponse[] = await;
const validBridgeIPs: string[] = [];
for (let bridge of foundBridges) {

Or, if you can't use async / await semantics in your module:

import { Hue, HueUPNPResponse } from 'hue-hacking-node';
let validBridgeIPs: string[] = []; => {
  for (let bridge of bridges) {
  1. Quick example configuration:
import { Hue } from 'hue-hacking-node';
const bridgeIP = '192.168.x.x';
const appname = 'myfirsthueapp'; // This is the hash / name / id that you registered with the bridge previously using the official Hue docs
const hue = new Hue({
  ip: bridgeIP, 
  key: appname,
  numberOfLamps: 3,
  retrieveInitialState: false

For the best introduction to using this module, please see the hue-node.spec.ts file.

© 2013 Bryan Johnson; Licensed MIT.