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

Uploaded Source

Built Distribution

aiohue-2.2.0-py3-none-any.whl (14.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: aiohue-2.2.0.tar.gz
  • Upload date:
  • Size: 8.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.8.3

File hashes

Hashes for aiohue-2.2.0.tar.gz
Algorithm Hash digest
SHA256 35696d04d6eb0328b7031ea3c0a3cfe5d83dfcf62f920522e4767d165c6bc529
MD5 2c73438b762ff14f53cf953f9dea3315
BLAKE2b-256 fc3e0aae30c22d6859700077c543c460366712d8dc72d1ed054776697cd1cddc

See more details on using hashes here.

File details

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

File metadata

  • Download URL: aiohue-2.2.0-py3-none-any.whl
  • Upload date:
  • Size: 14.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.8.3

File hashes

Hashes for aiohue-2.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6b5bd131e06570d4122716fd195abf5bdf7a2730f1934d6bd811ff0e1601f986
MD5 454ba19cee3968458d4234d2ee8be1b7
BLAKE2b-256 beebb1c9883336b293a6417cc162b8c92639be08ec6dccab75bcdfc97cb1b862

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