Skip to content

README.md

Latest commit

 

History

History
37 lines (27 loc) · 1.67 KB

README.md

File metadata and controls

37 lines (27 loc) · 1.67 KB

Imou Integration for Home Assistant

HACS Validation hassfest Validation Lint and Test

A Home Assistant custom integration for Imou cameras via the Imou cloud API.

Features

  • Camera live streaming (HLS, HD and SD)
  • Privacy switch (enable/disable camera)
  • Motion and human detection binary sensors
  • Sleep-aware polling (skips sleeping devices, conserves API quota)
  • API budget management (tracks daily usage, auto-throttles near limits)
  • Webhook event detection (optional push-based event delivery)
  • PTZ control (pan, tilt, zoom for supported cameras)

Installation via HACS

  1. Open HACS in Home Assistant
  2. Go to Integrations > three-dot menu > Custom repositories
  3. Add https://github.com/ol-rac/imou-plugin with category Integration
  4. Search for "Imou" in HACS and click Install
  5. Restart Home Assistant

Configuration

  1. Go to Settings > Devices & Services > Add Integration
  2. Search for "Imou"
  3. Enter your AppId and AppSecret from the Imou Open Platform
  4. Select your region (Singapore, Frankfurt, Oregon, or China)
  5. All cameras bound to your account are automatically discovered

License

MIT