Skip to content

A library for controlling Philips Hue lights via Bluetooth

License

Notifications You must be signed in to change notification settings

alexhorn/libhueble

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

libhueble

A library for controlling your Bluetooth-capable Philips Hue lights directly using Bluetooth Low Energy (BLE) without a bridge.

Pairing

  1. In the Hue BT app, go to Settings > Voice Assistants > Amazon Alexa and tap Make visible
  2. Open the bluetoothctl shell:
    sudo bluetoothctl
    
  3. Start the discovery:
    scan on
    
  4. Write down the MAC address of your light.
  5. Pair to your light:
    pair [MAC address]
    trust [MAC address]
    
  6. Done, you can now pair the light to your phone again.

¹ Thanks to @danieleds.

Usage

lamp = Lamp('00:11:22:33:44:55')
await lamp.connect()
try:
   await lamp.set_power(True)
   await lamp.set_brightness(1.0)
   await lamp.set_color_rgb(1.0, 0.0, 0.0)
finally:
   await lamp.disconnect()

Compatibility

Works on Raspbian Buster.

Sometimes it also works on Windows 10 20H2, but it is very flaky.

Credits

This is pieced together from the reverse engineering efforts of other people on the internet.

Sources:

Releases

No releases published

Packages

No packages published

Languages