I build open-source software for the smart home: Homematic and Homematic IP, Matter, and local device bridges to MQTT.
| You want to … | Start here |
|---|---|
| 🏠 Use Homematic in Home Assistant with the integration | homematicip_local |
| 🧵 Use Homematic through MQTT, REST, Matter or Node-RED, with or without Home Assistant | openccu-loom |
| 🔗 Embed or run Matter in Go | go-fabric |
| 🧑💻 Talk to Homematic from your own Python code | aiohomematic |
| 🔌 Bring a single device to MQTT | one of the bridges |
With the integration installed, please report everything in homematicip_local, whichever connection you use. If the cause is elsewhere, I move the issue.
Homematic in Home Assistant homematicip_local · homematicip-local-frontend (cards and panel)
Homematic libraries aiohomematic · aiohomematic-config
openccu-loom openccu-loom · openccu-loom-client · node-red-contrib-openccu-loom
Homematic data and testing openccu-data · go-openccu-data · godevccu
Matter go-fabric · go-fabric-server · go-fabric-ui · go-ha2fabric · go-hamapping
Bridges (independent, each with its own issues) go-mtec2mqtt · go-keba2mqtt · go-zendure2mqtt · go-unifi2mqtt · go-homeconnect2mqtt · go-daikin2mqtt · go-raumfeld-connect
Shared Go libraries go-mqtt · go-hamqtt · go-ha-catalog · go-modbus · go-bridgeui
Simplified. Solid arrows are package dependencies, dashed arrows are runtime or data relations.
flowchart LR
subgraph HAI["Home Assistant"]
HL["homematicip_local"]:::hub
end
subgraph PY["Python libraries"]
AH["aiohomematic"]:::hub
AHC["aiohomematic-config"] --> AH
OLC["openccu-loom-client"] --> AH
end
HL --> AH
HL --> AHC
HL --> OLC
HL --> OD["openccu-data"]
OLC -. REST/WebSocket .-> OL
subgraph LOOM["openccu-loom"]
OL["openccu-loom"]:::hub
end
OD -. data .-> GOD["go-openccu-data"]
OL --> GOD
OL --> DEV["godevccu"]
subgraph MATTER["Matter"]
GF["go-fabric"]:::hub
GFS["go-fabric-server"] --> GF
GFS --> GFU
GFU["go-fabric-ui"] --> GF
HA2["go-ha2fabric"] --> GF
HA2 --> GFU
HA2 --> HAM
HAM["go-hamapping"] --> GF
end
OL --> GF
OL --> GFU
subgraph BASE["Shared Go libraries"]
HQ["go-hamqtt"] --> MQ["go-mqtt"]
HQ --> CAT["go-ha-catalog"]
UI["go-bridgeui"]
MB["go-modbus"]
end
OL --> HQ
HA2 --> HQ
HAM --> HQ
BR["go-*2mqtt bridges"] --> HQ
BR --> UI
BR -. only mtec, keba .-> MB
classDef hub stroke-width:3px