Skip to main content

Auto discovery of Hue bridges

Project description

The MIT License

Discovery of hue bridges per the Philips design guide.

Use discoverhue to find the IP addresses of all hue bridges on the LAN. If previously known bridge serial numbers are provided then the returned info will be filtered. Alternatively, serial numbers and last known IP addresses pairs may be provided. In this case, the provided addresses will be checked first and the discovery methods will only be executed if unmatched bridges remain.

Currently, discoverhue implements options one,two, and three of the Hue Bridge Discovery Guide available with registration at MeetHue.

Installation

pip install discoverhue

Examples

Execute discovery and return a dictionary of all found bridges:

import discoverhue
found = discoverhue.find_bridges()
for bridge in found:
    print('    Bridge ID {br} at {ip}'.format(br=bridge, ip=found[bridge]))

Execute discovery and return a filtered list of bridges:

# using a list, matches will be removed from search_id
search_id = ['0017884e7dad', '001788102201']
found = discoverhue.find_bridges(search_id)

# using a set, matches will be removed from search_id
search_id = {'0017884e7dad', '001788102201'}
found = discoverhue.find_bridges(search_id)

# using a tuple, immutable so matches will not be removed
search_id = ('0017884e7dad', '001788102201')
found = discoverhue.find_bridges(search_id)

Execute discovery and return single IP address as string:

>>> found = discoverhue.find_bridges('001788102201')
>>> found.lower()
'http://192.168.0.1:80/'

Validate provided IP’s and execute discovery only if necessary:

>>> discoverhue.find_bridges({'0017884e7dad':'192.168.0.1',
                              '001788102201':'192.168.0.2'})
{'0017884e7dad': 'http://192.168.0.27:80/'}

Contributions

Welcome at https://github.com/Overboard/discoverhue

Status

Released.

SSDP Attribution

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for discoverhue, version 1.0.2
Filename, size File type Python version Upload date Hashes
Filename, size discoverhue-1.0.2-py3-none-any.whl (10.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size discoverhue-1.0.2.tar.gz (13.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page