/phuey

Primary LanguagePython

phuey

Wrapper around Philips Hue REST API

...a work in progress...

Only does the things I currently need it to do.

Library

from phuey.hue_bridge import HueBridge

# Create a HueBridge instance
host = "http://localhost"
## See the `phuey` CLI for creating a username: `phuey create-username -h`
username = "0xdeadbeef"
bridge = HueBridge(host, username)

# Get a Light
light = bridge.get_light("MyLight")

## Turn the light on
light.on(True)

## Get the light's on state
is_on = light.on()

## Set the light's color using RGB
light.color((50,255,128))

## Get the light's color in RGB
color = light.color()

## Set the light's brightness 0 to 100%
light.brightness(75)

## Get the light's brightness as percent
bri = light.brightness()

## Blink the light RED 5 times
light.blink((255,0,0), 5)

CLI

phuey -h

Getting Started

phuey requires a config file to store your preferences such as the URL of your Philips Hue Bridge and a Username to use when executing API calls.

You can use the phuey config init command to initialize the config file. See phuey config init -h for details.

You'll also need to create a username to use with the CLI. This username will be supplied as part of the phuey config init command. A username can be created by running the phuey admin create-username command.

Philips Hue API Notes

Get Username for App

  1. Push link button
  2. POST /api {"devicetype":"<APP_NAME>#<DEVICE_NAME>"} 
    [
    {
        "success": {
            "username": "faKekjh6deadBeefDc42h688007duMmYk134hvl9"

        }
    }
]
  3. To delete a username you must use the Permissions Manager for your Philips Hue account

Making Requests

http://<bridge_addr>/api//...

Misc

Python