Installation

The OpenHue CLI is available for macOS, Linux and Windows and can be installed via different package managers or even with Docker.

Homebrew

To install the OpenHue CLI via Homebrew, you first need to add the tap the formula repository:

brew tap openhue/cli

You won't need to type this command again

Once you have tapped the repository, you can now install the openhue-cli executable:

brew install openhue-cli

And that's it you can now use OpenHue CLI:

openhue help

When a new version of OpenHue CLI has been released, simply run the following commands to upgrade:

brew update
brew upgrade openhue-cli

Docker

The OpenHue CLI is also available from the DockerHub. To run it as a container, you first need to pull the image using the following command:

docker pull openhue/cli

Then you can run it using:

# setup command example
docker run -v "${HOME}/.openhue:/.openhue" --rm --name=openhue -it openhue/cli setup -b 192.168.1.x -k xxxxx
# list lights
docker run -v "${HOME}/.openhue:/.openhue" --rm --name=openhue -it openhue/cli get lights