Zurück zur Startseite
Open Source · Apache-2.0

Mein Smarthome
spricht endlich
alle Sprachen

Eine Python-Bridge zwischen Homematic IP, Loxone und Shelly – gebaut aus eigener Notwendigkeit, weil kein System von Haus aus mit dem anderen redet.

homematic-bridge

derzico / homematic-bridge

Sprache Python
Lizenz Apache-2.0
Deployment Docker Compose
WebSocket Echtzeit HmIP-Events
Integration Loxone UDP · Shelly · HTTP-API
docker compose up -d --build
Das Problem

Verschiedene Systeme,
die nicht miteinander reden

Wer ein Smarthome betreibt, kennt das Problem: Verschiedene Systeme, verschiedene Hersteller, und irgendwie redet keiner mit dem anderen.

Bei mir zuhause läuft Homematic IP für Heizung, Fenster, Rauchmelder und Licht – und daneben noch Loxone als zentrales Steuerungssystem sowie diverse Shelly-Aktoren für die Gartentechnik und einzelne Steckdosen.

Also habe ich eine eigene Bridge gebaut.

Loxone weiß nicht, ob das Fenster offen ist → gelöst

Shelly-Geräte lassen sich nicht zentral überwachen → gelöst

Für jedes Shelly einzeln ins Web-Interface einloggen → gelöst

Keine Automatisierung über Systemgrenzen hinweg → gelöst

Was kann sie?

Alle Funktionen im Überblick

Loxone-Integration per UDP

Jede Zustandsänderung eines HmIP-Geräts wird automatisch als UDP-Paket an den Loxone Miniserver gesendet. Fensterkontakt offen? Loxone bekommt 1. Temperatur geändert? Loxone bekommt den neuen Wert – in Echtzeit.

HTTP-API zur Steuerung

Loxone kann per einfachen HTTP-Requests Geräte schalten, dimmen, RGB-Farben setzen, Rollläden fahren, Thermostate auf Temperatur setzen oder Bewässerungsventile öffnen – alles über eine einheitliche API mit API-Key-Absicherung.

Shelly-Integration

Automatischer Scan nach Shelly-Geräten (Gen1 & Gen2) im Netzwerk. Alle Geräte werden übersichtlich im Dashboard angezeigt. Ein integrierter Proxy leitet die Shelly-Web-Oberflächen durch – kein einzelnes Einloggen mehr nötig.

Alarmmanagement

Rauchmelder lassen sich als Sirenen nutzen. Alarmtest per Knopfdruck (5 Sekunden, dann automatischer Stopp), aktiven Alarm per Bestätigungsdialog löschen – nichts passiert aus Versehen.

Web-Interface

Ein übersichtliches Dashboard zeigt Wetter, Heizungsübersicht, Gerätestatus und Alarme. Separate Seiten für Gerätedetails, Batterie- und RSSI-Warnungen sowie ein direkter Konfigurationseditor machen die Verwaltung einfach.

Docker-Deployment

Ein einziger Befehl und die Bridge läuft: docker compose up -d --build. Konfiguration über eine einzige YAML-Datei. Läuft auf jedem Raspberry Pi oder Docker-Host.

Für wen ist das interessant?

Für alle mit Homematic IP, die mehr wollen

Homematic IP + Loxone

Beide Systeme endlich miteinander verbunden

Shelly-Nutzer

Zentrale Übersicht statt einzelner Web-Interfaces

Heimautomatisierer

Eigene Automatisierungen per HTTP-API

Überblick behalten

Batterie, RSSI und Erreichbarkeit im Dashboard

Technisch

In wenigen Minuten einsatzbereit

Die Bridge ist in Python geschrieben, läuft als Docker-Container und ist nach einem einzigen Befehl sofort einsatzbereit. Die gesamte Konfiguration erfolgt über eine einzige YAML-Datei.

Schnellstart bash
git clone https://github.com/derzico/homematic-bridge.git
cd homematic-bridge
cp config/config_sample.yaml config/config.yaml
# config/config.yaml anpassen (HCU-Hostname, Token)
docker compose up -d --build

Web-Interface danach erreichbar unter http://<host>:8080

Vollständige Dokumentation, Konfigurationsreferenz und API-Dokumentation im GitHub Wiki.