Skip to content

Library for controlling Imou devices by interacting with the Imou Life API

License

Notifications You must be signed in to change notification settings

user2684/imouapi

Repository files navigation

imouapi

This python library helps in interacting with Imou Life Open API for remote controlling programmatically your Imou devices, especially those settings such as motion detection, human detection, privacy, etc that can be changed by the Imou Life App only.

Features

  • Provide classes for both low level API interaction as well as device and sensors abastractions
  • Exceptions and error handling
  • Based on asyncio module

Quickstart

  • Install the library with pip install imouapi
  • Register a developer account on Imou Life Open API and get your appId and appSecret
  • Instantiate the Imou API client (from imouapi.api import ImouAPIClient) and initialize it (e.g. api_client = ImouAPIClient(app_id, app_secret, session))
  • Discover registered devices by importing the Discover service (from imouapi.device import ImouDiscoverService), inializing it (e.g. discover_service = ImouDiscoverService(api_client)) and running a discovery (e.g. discovered_devices = await discover_service.async_discover_devices())
  • Either use the high level API by importing the Imou Device class (from imouapi.device import ImouDevice) and initializing it (e.g. device = ImouDevice(api_client, device_id)) or using directly the low level API provided by ImouAPIClient to interact with the device

Full details on the installation process, requirements, usage and classes and methods made available by the library are available at https://user2684.github.io/imouapi

About

Library for controlling Imou devices by interacting with the Imou Life API

Resources

License

Stars

Watchers

Forks

Packages

No packages published