Yet Another Philips Hue API Library for Python
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.
Find a file
2023-07-23 10:38:50 +02:00
yahuelib Added support for setting/getting the white color temperature and a utility function to convert from Kelvin to MIRED 2023-07-23 10:38:50 +02:00
.gitignore Added first working version of the library; updated README, .gitignore and LICENSE 2023-07-21 20:40:19 +02:00
DOCUMENTATION.md Added support for setting/getting the white color temperature and a utility function to convert from Kelvin to MIRED 2023-07-23 10:38:50 +02:00
LICENSE Added first working version of the library; updated README, .gitignore and LICENSE 2023-07-21 20:40:19 +02:00
pydoc-markdown.yml Created a documentation and updated the README 2023-07-21 22:35:31 +02:00
README.md Added support for setting/getting the white color temperature and a utility function to convert from Kelvin to MIRED 2023-07-23 10:38:50 +02:00

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
    • white color temperature
    • alert
    • alert_long
  • 🏠 Groups (Zones and Rooms)
    • any_on
    • all_on
    • brightness
    • hue
    • saturation
    • white color temperature
    • alert
    • alert_long

Documentation

see DOCUMENTATION.md

Example

#!/usr/bin/env python3

# from yahuelib.controller import LightController
from yahuelib.controller import 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()