pymyq 1.2.1

Python package for controlling MyQ-Enabled Garage Door

Introduction

This is a Python 3.5+ module aiming to interact with the Chamberlain MyQ API.

Code is licensed under the MIT license.

Getting Started

Installation

pip install pymyq

Usage

pymyq starts within an aiohttp ClientSession:

import asyncio

from aiohttp import ClientSession


async def main() -> None:
    """Create the aiohttp session and run."""
    async with ClientSession() as websession:
      # YOUR CODE HERE


asyncio.get_event_loop().run_until_complete(main())

To get all MyQ devices associated with an account:

import asyncio

from aiohttp import ClientSession

import pymyq


async def main() -> None:
    """Create the aiohttp session and run."""
    async with ClientSession() as websession:
      # Valid Brands: 'chamberlain', 'craftsman', 'liftmaster', 'merlin'
      myq = await pymyq.login('<EMAIL>', '<PASSWORD>', '<BRAND>', websession)

      # Return only cover devices:
      devices = await myq.get_devices()

      # Return *all* devices:
      devices = await myq.get_devices(covers_only=False)


asyncio.get_event_loop().run_until_complete(main())

Device Properties

• brand: the brand of the device
• device_id: the device's MyQ ID
• parent_id: the device's parent device's MyQ ID
• name: the name of the device
• available: if device is online
• serial: the serial number of the device
• state: the device's current state
• type: the type of MyQ device
• open_allowed: if device can be opened unattended
• close_allowed: if device can be closed unattended

Methods

All of the routines on the MyQDevice class are coroutines and need to be awaited.

• close: close the device
• open: open the device
• update: get the latest device state (which can then be accessed via the state property). Retrieval of state from cloud is will only be done if more then 5 seconds has elapsed since last request. State for all devices is retrieved through (1) request.
• close_connection: close web session connection, will only close the web session if none was provided initially

Disclaimer

The code here is based off of an unsupported API from Chamberlain and is subject to change without notice. The authors claim no responsibility for damages to your garage door or property by use of the code within.