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.0.tar.gz (15.1 kB view details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

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

File metadata

  • Download URL: aiohue-2.6.0.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.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.61.2 CPython/3.9.6

File hashes

Hashes for aiohue-2.6.0.tar.gz
Algorithm Hash digest
SHA256 e4b781403e7dd891733334b7b5d41053196eaf80809b15421d5b82695580561d
MD5 34070bcc91f065d865d300ec00bc42e8
BLAKE2b-256 d4bb0ba4acb7ffd2cf0d32ba0c594b85a4558bc6dbb00ba1d54f93cd0f2fcc19

See more details on using hashes here.

File details

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

File metadata

  • Download URL: aiohue-2.6.0-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.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.61.2 CPython/3.9.6

File hashes

Hashes for aiohue-2.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5e916d0de6d28248853713e4775bf72fe77fab4339c3b22d3dad9083846ed1d4
MD5 330fa4859bbd20a26174795450f082ad
BLAKE2b-256 b81b581ea616bc99d932bb335907be04c255de0cc4c31f9870f81732c14e5e26

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