Skip to main content

Python module to talk to Philips Hue.

Project description

Aiohue

Asynchronous library to control Philips Hue

Requires Python 3.8+ and uses asyncio and aiohttp.

import asyncio
from pprint import pprint

import aiohttp
from aiohue.discovery import discover_nupnp


async def main():
    async with aiohttp.ClientSession() as session:
        await run(session)


async def run(websession):
    bridges = await discover_nupnp(websession)

    bridge = bridges[0]
    await bridge.create_user('aiophue-example')
    print('Your username is', bridge.username)

    await bridge.initialize()

    print('Name', bridge.config.name)
    print('Mac', bridge.config.mac)

    print()
    print('Lights:')
    for id in bridge.lights:
        light = bridge.lights[id]
        print('{}: {}'.format(light.name, 'on' if light.state['on'] else 'off'))

    # Change state of a light.
    await light.set_state(on=not light.state['on'])

    print()
    print('Groups:')
    for id in bridge.groups:
        group = bridge.groups[id]
        print('{}: {}'.format(group.name, 'on' if group.action['on'] else 'off'))

    # Change state of a group.
    await group.set_action(on=not group.state['on'])


asyncio.run(main())

Timeouts

Aiohue does not specify any timeouts for any requests. You will need to specify them in your own code. We recommend the async_timeout package:

import async_timeout

with async_timeout.timeout(10):
    await bridge.initialize()

Contribution guidelines

Object hierarchy and property/method names should match the Philips Hue API.

Project details


Download files

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

Source Distribution

aiohue-2.6.1.tar.gz (15.1 kB view details)

Uploaded Source

Built Distribution

aiohue-2.6.1-py3-none-any.whl (17.9 kB view details)

Uploaded Python 3

File details

Details for the file aiohue-2.6.1.tar.gz.

File metadata

  • Download URL: aiohue-2.6.1.tar.gz
  • Upload date:
  • Size: 15.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.6.3 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.0 CPython/3.9.6

File hashes

Hashes for aiohue-2.6.1.tar.gz
Algorithm Hash digest
SHA256 1374f7fc50bac46375e18ce7d511515265ce83c9180f312e60a36d63055f0104
MD5 f9baf2d0856c35c75115dec43612d81a
BLAKE2b-256 bf1208647924d37f241f3264c034e0323065ec29f669bda4ef28bdb74c7b4abd

See more details on using hashes here.

File details

Details for the file aiohue-2.6.1-py3-none-any.whl.

File metadata

  • Download URL: aiohue-2.6.1-py3-none-any.whl
  • Upload date:
  • Size: 17.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.6.3 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.0 CPython/3.9.6

File hashes

Hashes for aiohue-2.6.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8d0e309fef891502865dd5663f5806c79e9c19406ad5695ad4669b4608586011
MD5 d08e5234f65ac9468fdf7f3ec425be27
BLAKE2b-256 66eb5f862aa33f821032c4cff87487e451b54df34611814aaa74cc1d21e02f2a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page