Skip to main content

Python module to talk to Philips Hue.

Project description

Aiohue

Asynchronous library to control Philips Hue

Requires Python 3.5 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.3.1.tar.gz (12.3 kB view details)

Uploaded Source

Built Distribution

aiohue-2.3.1-py3-none-any.whl (14.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: aiohue-2.3.1.tar.gz
  • Upload date:
  • Size: 12.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.9.5

File hashes

Hashes for aiohue-2.3.1.tar.gz
Algorithm Hash digest
SHA256 d592a9055b56462312fcfccf46601ed4092698db1be5f3fc30c232ea34c6bbe3
MD5 72a984b175e37d3bb676d875550aeb90
BLAKE2b-256 e1787b12b8715dab9758bfc2c10cce0d4b92b0a245dceac3844508473539e4b1

See more details on using hashes here.

File details

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

File metadata

  • Download URL: aiohue-2.3.1-py3-none-any.whl
  • Upload date:
  • Size: 14.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.9.5

File hashes

Hashes for aiohue-2.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c39459fdba7de77455f0c25abbbeeb84a9abdc7633c8d6d7dc8cf0628fe853f3
MD5 dfa8ebcbeda806f33c8cd0d2d1139d25
BLAKE2b-256 e458a7801d2b75519a2168711b26c2c1dac0c7c4a14cf7a21cf563ce37096399

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