HueBLE

HueBLE Logo
https://img.shields.io/pypi/v/HueBLE.svg Documentation Status Black

Python module for controlling Bluetooth Philips Hue lights

This Python module enables you to control Philips Hue Bluetooth lights directly from your computer, without the need for a Hue bridge or ZigBee dongle. It leverages the Bleak library to interact with Bluetooth Philips Hue lights.

Features

  • 💡 On/Off control

  • 🌗 Brightness control

  • 🌡️ Colour temp control

  • 🌈 XY colour control

  • 🌟 Effect control

  • ❔ Light state (power/brightness/temp/colour)

  • ⚙️ Light configuration (name)

  • 📊 Light metadata (manufacturer/model/zigbee address)

  • 🤜 Supports push & polling models

  • 🔂 Simple structure

  • 📜 Mediocre documentation

  • ✔️ More emojis than strictly necessary

Requirements

  • 🐍 Python 3.11+

  • 📶 Bleak 0.19.0+

  • 📶 bleak-retry-connector

Supported Operating Systems

  • 🐧 Linux (BlueZ)

    • ✔️ Ubuntu Desktop (24.04)

    • ✔️ Arch

    • ✔️ Buildroot (HomeAssistant OS)

  • 🏢 Windows

    • ✔️ Windows 10

  • 💾 Mac OSX

    • ✔️ Sequoia (15.7)

  • 🛜 ESPHome (Bluetooth Proxy)

    • ESP32-C3-Super-Mini

    • ESP32-C5-N4R2

Disclaimer

HueBLE is a software library designed to work with Philips Hue. Philips Hue is a registered trademark of Philips. This project is not affiliated with, endorsed by, or sponsored by Philips (Though I wouldn’t mind being sponsored 😉). All other trademarks cited herein are the property of their respective owners.

Contents