// readme

aiohomematic

A modern, async Python library for controlling and monitoring Homematic and HomematicIP devices. Powers the Home Assistant integration “Homematic(IP) Local”.

This project is the modern successor to pyhomematic, focusing on automatic entity creation, fewer manual device definitions, and faster startups.

Key Features

  • Automatic entity discovery from device/channel parameters
  • Broad backend support: CCU3, OpenCCU, CUxD, CCU-Jack, and godevccu for testing
  • Multiple transport protocols: XML-RPC (standard interfaces) and JSON-RPC (CUxD / CCU-Jack), with MQTT event forwarding via Homematic(IP) Local
  • Extensible via custom entity classes for complex devices (climate, cover, light, lock, siren, valve, …)
  • Hub entities for CCU programs, system variables, inbox messages, install mode, and service messages
  • Event-driven architecture with a unified EventBus for lifecycle, state, and diagnostic events
  • Fast startups through paramset and description caching -…