An extensive Philips Hue client library for Go
with an emphasis on simplicity. It is designed to be clean, unbloated and extensible. With Huego
you can interact with any Philips Hue bridge and its resources including Lights
, Groups
, Scenes
, Sensors
, Rules
, Schedules
, Resourcelinks
, Capabilities
and Configuration
.
Get the package
go get github.com/amimof/huego
Include it in your code. You may use New()
if you have already created an user and know the IP address to your bridge.
package main
import (
"github.com/Felixls/huego"
"fmt"
)
func main() {
bridge := huego.New("192.168.1.59", "username")
l, err := bridge.GetLights()
if err != nil {
panic(err)
}
fmt.Printf("Found %d lights", len(l))
}
Discover a bridge on your network with Discover()
and create a new user with CreateUser()
.
func main() {
bridge, _ := huego.Discover()
user, _ := bridge.CreateUser("my awesome hue app") // Link button needs to be pressed
bridge = bridge.Login(user)
light, _ := bridge.GetLight(3)
light.Off()
}
See godoc.org/github.com/amimof/huego for the full package documentation.
The tests requires an accessible Philips Hue Bridge IP address and a pre-configured username for authenticating. Before running the tests, make sure to set the environment variables HUE_HOSTNAME
and HUE_USERNAME
. If you don't have an username, you may create one using CreateUser()
or refer to the official Getting Started Guide.
All help in any form is highly appreciated and your are welcome participate in developing Huego
together. To contribute, clone the master
branch and create a Pull Request
. If you want provide feedback, open up a New Issue
or contact me personally.