This repository has been archived on 2025-09-28. You can view files and clone it, but you cannot make any changes to it's state, such as pushing and creating new issues, pull requests or comments.
YaHueLib/README.md

1.1 KiB

YaHue Lib

Yet Another Philips Hue API Library for Python. This project only implements home subset of the API.

Getting Started

Before you can use the API of your Hue Bridge, you have to create an API user for it.
See https://developers.meethue.com/develop/get-started-2/

Supported Features

  • 💡 Lights
    • reachable
    • on
    • brightness
    • hue
    • saturation
    • alert
    • alert_long
  • 🏠 Groups (Zones and Rooms)
    • any_on
    • all_on
    • brightness
    • hue
    • saturation
    • alert
    • alert_long

Documentation

see DOCUMENTATION.md

Example

#!/usr/bin/env python3

from yahuelib.controller import LightController, GroupController
from yahuelib.utils import rgb_to_hsv

if __name__ == "__main__":
    home = GroupController.from_name("Home", "192.168.0.120", "XXXXXXXXXXXXXXXXXXX-XXXXXXXXXXXXXXXXXXXX")
    if not home.all_on:
        home.all_on = True
    color = rgb_to_hsv(255, 220, 100)
    home.hue = color[0]
    home.saturation = color[1]
    home.brightness = 1.0
    home.alert()