https://github.com/gumieri/huexe
A bunch of executables to interact with Philips Hue Lamps
https://github.com/gumieri/huexe
executable go golang hue-lights philips-hue
Last synced: 5 months ago
JSON representation
A bunch of executables to interact with Philips Hue Lamps
- Host: GitHub
- URL: https://github.com/gumieri/huexe
- Owner: gumieri
- License: mit
- Created: 2017-06-05T20:04:16.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-11-14T23:57:12.000Z (about 8 years ago)
- Last Synced: 2025-04-30T18:12:00.054Z (10 months ago)
- Topics: executable, go, golang, hue-lights, philips-hue
- Language: Go
- Homepage:
- Size: 25.4 KB
- Stars: 9
- Watchers: 2
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Huexe
A bunch of executables to interact with a specific Philips Hue Lamp:
* `switch`: Turn On / Off the lamp;
* `dimmer`: Dim the lamp;
* `brighter`: Bright the lamp;
* `setup`: Find the Philips Hue Bridge, register Huexe in it and create the `config.yml` file;
* `unregister`: Unregister the Huexe from the Bridge.
## Installation
1. Download the package of your Operating System at [huexe/releases](https://github.com/gumieri/huexe/releases/latest) and extract it where you prefer.
2. Press the Philips Hue Bridge "Push-Link Button" and (by the limit of 30 seconds) execute the `setup`.
The Huexe will be registered and the Key will be stored at `config.yml` file.
It will be configured to use the lamp with `id` `1`. If you want to control other lamps, create a copy of this installation and edit the `id` inside `config.yml` to the desired one.
## Configurations
```yml
id: 1
address: 192.168.1.2
username: 249ba36000029bbe97499c03db5a9001f6b734ec
steps: 25
```
* **id:** Refers to the Lamp ID from the Philips Hue Bridge API.
If you are using the API to find the lamps IDs, it is **not** the `uniqueid`, `modelid` nor `luminaireuniqueid`.
It's the `key` refering the JSON object, with `state`, `type`, etc..
* **address:** The Philips Hue Bridge IP Address.
* **username:** It's a Hash Key / Token generated from the Philips Hue Bridge API when the Huexe is registered.
* **steps:** Refers to how much one execution of `dimmer` / `brighter` will dim / bright.
The Brightness of a Hue lamp goes from 1 to 254, and it just accept integer values. In this way the default value of `steps` is `25`, to a total of 10 executions from minimum to maximum bright.
## Code Status
[](https://goreportcard.com/report/github.com/gumieri/huexe)
[](https://travis-ci.org/gumieri/huexe)
## License
Huexe is released under the [MIT License](http://www.opensource.org/licenses/MIT).