OpenHue CLI is a command-line interface for interacting with Philips Hue smart lighting systems. This tool provides a convenient way to control your Philips Hue lights and perform various tasks using the command line.
- Discover and connect to Philips Hue bridges.
- List available lights and their status.
- Control lights: on, off, brightness, and color.
- Schedule light actions.
For a complete list of features and usage, please refer to the OpenHue CLI online documentation.
To begin developing with Open-Hue's OpenAPI specification, follow these steps:
Before you start, ensure that you have the following prerequisites installed:
- Golang that is used to build and run the project
- GoReleaser (optional) that is used to build and release the binaries
- Docker (optional) that is used to build the CLI Docker Image and run it as a container
Before contributing to OpenHue CLI, it's a good practice to fork the repository to your own GitHub account. This will create a copy of the project that you can work on independently.
- Clone the OpenHue CLI repository to your local machine:
git clone https://github.com/your-username/openhue-cli.git
cd openhue-cli- Run the following command to build OpenHue CLI on your local environment:
make buildRun the following command to generate the OpenHue API Client:
make generateIf there was any OpenAPI specification change, this command will update
the ./openhue/openhue.gen.go file.
Please note that this file must never be manually edited!
Open-Hue is distributed under the Apache License 2.0, making it open and free for anyone to use and contribute to. See the license file for detailed terms.