woodward / git_hue

Use a Philips Hue light to show the color of the build in GitHub Actions!

GitHue

Description

GitHub Actions CI + Philips Hue Light ⮕ GitHub + Hue ⮕ GitHue

GitHue uses the Elixir HueSDK and the GitHub API to change the color of a Philips Hue light based on the status of a GitHub actions continuous integration build (or CI). The light will be set to green if the build is succsessful, yellow if the build is running, and red if the build fails.

Installation and Usage

There are a number of environment variables to configure; see .envrc for a description. To run:

• git clone [email protected]:woodward/git_hue.git
• cd git_hue
• mix deps.get
• In the Hue app on your phone, you'll need to assign one of your Hue lights a recognizable name (which goes into the environment variable HUE_LIGHT_NAME)
• You'll need to get a GitHub personal access token which will be set in the environment variable GITHUB_PERSONAL_ACCESS_TOKEN
• Configure the rest of the environment variables in .envrc`` by adding private values to .local/envrc`
• IMPORTANT Press the "link" button on top of the Hue Bridge (i.e., the big button on top)
• Run iex -S mix

The light should change based on the status of your GitHub action.