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

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for aiohue-2.6.2.tar.gz
Algorithm Hash digest
SHA256 a8bb3993884a745d330a982f6008b95755574fcac0c33c73945a52d9661ca479
MD5 19d43da78ea9851316eadb9662052248
BLAKE2b-256 4f31fc929511fa1ff4c7da6ea94573886e2ef2e7330682fcdfd8c862356bb3c2

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for aiohue-2.6.2-py3-none-any.whl
Algorithm Hash digest
SHA256 f24bd8da3d085f6f1cae884c36537de4debb711640c95f54baa629f037acf0f6
MD5 85704ad3ec270b2405c52fc1d6b2eed8
BLAKE2b-256 bc462b8cb2ebc266c5119fbaebd81d61638c01e3256c46de5505f375b4bbedd3

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