Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Auto discovery of Hue bridges

Project Description

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 and two of the Hue Bridge Discovery Guide available with registration at MeetHue.


pip install discoverhue


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()

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

>>> discoverhue.find_bridges({'0017884e7dad':'',
{'0017884e7dad': ''}


Welcome at



SSDP Attribution

Release History

Release History

This version
History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
discoverhue-1.0.1-py3-none-any.whl (9.4 kB) Copy SHA256 Checksum SHA256 py3 Wheel Aug 3, 2017
discoverhue-1.0.1.tar.gz (12.7 kB) Copy SHA256 Checksum SHA256 Source Aug 3, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting