Skip to content
/ huego Public
forked from amimof/huego

An extensive Philips Hue client library for Go with an emphasis on simplicity

License

Notifications You must be signed in to change notification settings

felixls/huego

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

46 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

huego Go Report Card

Huego

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 .

Installation

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()
}

Documentation

See godoc.org/github.com/amimof/huego for the full package documentation.

Testing

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.

Contributing

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.

About

An extensive Philips Hue client library for Go with an emphasis on simplicity

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 100.0%