Homebridge-hue-utils NPM

homebridge-hue-utils

Command line utilities for homebridge-hue

This package bundles a number of command line utilities that interact with a Philips Hue bridge and/or a dresden elektronik deCONZ gateway. It is included in homebridge-hue, but might also be used standalone.

Commands

This package provides the following commands:

Command	Description
`dc_eventlog`	Logger for deCONZ websocket notifications.
`json`	JSON formatter.
`ph`	Command line interface to Philips Hue API.
`upnp`	UPnP logger.

Type command -h to see help for the command.

Installation

This package is bundled with homebridge-hue and requires no additional installation when homebridge-hue is already installed on your system.
To install these utilities on a machine without homebridge-hue, follow these steps:

Install the latest v8 LTS version of Node.js. On a Raspberry Pi, use the 8.x Debian package. On other platforms, download the 8.x.x LTS installer. Both installations include the npm package manager;
On macOS, make sure /usr/local/bin is in your $PATH, as node, npm, and, later, homebridge install there. On a Raspberry Pi, these install to /usr/bin;
You might want to update npm through sudo npm -g install npm@latest;
Install the utilities through sudo npm -g install homebridge-hue-utils.

To run dc_eventlog as a system service on a Raspberry Pi, create a service file dc_eventlog.service in /etc/systemd/system:

[Unit]
Description=deCONZ: web socket event logger
After=deconz-gui.service

[Service]
User=pi
ExecStart=/usr/bin/dc_eventlog -s
Restart=on-failure
StartLimitInterval=60

[Install]
WantedBy=multi-user.target

To see the events, issue journalctl -au dc_eventlog.

History

dc_eventlog was previously published as a separate package dc_eventlog.
Earlier versions of ph and json, written in bash, were published in ph.sh.