Skip to content

OpenCCU-Loom

A standalone Go daemon that bridges Homematic and HomematicIP CCUs to MQTT, a REST + WebSocket API, a web Config UI, and Matter.

OpenCCU-Loom talks to Homematic / HomematicIP CCUs (CCU2, CCU3, RaspberryMatic) over XML-RPC, BIN-RPC, and JSON-RPC, and exposes them on the north side to standard protocols — so you can use your devices from MQTT, REST/WebSocket clients, a browser, or a Matter controller without running Home Assistant.

It is a Go port of the Python library aiohomematic that adds the standalone-daemon surface on top. The two projects coexist: aiohomematic powers the Home Assistant integration Homematic(IP) Local; OpenCCU-Loom serves users who want MQTT / REST / UI / Matter access on their own.


What it gives you

  • MQTT — Home Assistant Discovery and a raw topic plane, in parallel.
  • REST + WebSocket API — full device/parameter control and a live event stream.
  • Config UI — a Svelte SPA for setup, device configuration, and diagnostics.
  • Matter — a native-Go Matter bridge (opt-in) so your CCU devices appear in Apple Home, Google Home, and Alexa.
  • Multi-CCU — one daemon, many CCUs, first-class from day one.

Single static binary

OpenCCU-Loom ships as a single static binary (CGO_ENABLED=0) and as multi-arch Docker images (amd64, arm64, armv7). Persistence is pure-Go SQLite plus the filesystem — no external database, no CGo.


Where to next

Pick the lane that matches what you want to do.

Documentation language

The documentation is built to be multilingual. For now it is published in English only; German pages will be added over time.