🗄️ Das Projekt hap-homematic ist seit dem 29.05.2026 archiviert (nur noch lesbar, keine Updates). Was das bedeutet

🗄️Status & Alternativen

Das Projekt ist abgeschlossen: Der Autor hat das Repository am 29.05.2026 archiviert. Diese Seite ordnet ein, was das praktisch heißt, welche Versionsnummer welche Bedeutung hat und welche gepflegten Wege es heute gibt. Stand aller Angaben: 01.10.2026.

📊Kennzahlen

29.05.2026

archiviert (nur noch lesbar)

0.0.63

letzte Version des Dienstes (npm „latest“, 22.06.2021)

0.0.14

letzter Installer (GitHub-Release, 06.10.2020)

MIT

Lizenz · Autor: Thomas Kluge (thkl)

219

Sterne auf GitHub

28

Forks

78

offene Issues

63

veröffentlichte npm-Versionen

🔢0.0.14 oder 0.0.63 – welche Version ist die letzte?

Beide. Sie bezeichnen zwei verschiedene Dinge.
WasLetzte VersionDatumWo zu finden
Installer („CCU Addon“), die Datei für „Zusatzsoftware“0.0.1406.10.2020GitHub-Releases (8 Releases), Datei hap-homematic-0.0.14.tar.gz
Dienst (npm-Paket), das eigentliche Programm0.0.6322.06.2021npm-Registry, Tag „latest“; wird vom Installer nachgeladen
Vorabversion des Dienstes2.0.201.10.2022npm-Registry, Tag „beta“ – wird nicht automatisch installiert
Angabe auf homematic-inside.de0.0.1407.10.2020entspricht dem Installer; die Seite wird laut eigenem Hinweis nicht weitergeführt
💡 Der Unterschied in einem Satz
homematic-inside.de nennt mit 0.0.14 die Nummer des Installers; das Programm, das danach tatsächlich läuft, ist 0.0.63 – rund acht Monate jünger. Das Wiki erklärt: Der Installer teilt keinen Code mit dem Dienst und muss deshalb nicht mit jeder Dienst-Version erneuert werden. (GitHub nennt als Veröffentlichungszeitpunkt des Releases den 06.10.2020, homematic-inside.de den 07.10.2020.)

🕰️Zeitleiste

  1. 08.03.2020Repository angelegtGitHub-API: Repository-Daten
  2. 25.03.2020Erstes Release 0.0.1 (Installer) und erste npm-Version 0.0.1GitHub-Releases
  3. 06.10.2020Release 0.0.14 – bis heute der letzte Installer („CCU Addon 0.0.14“)GitHub-Releases
  4. 22.06.2021npm-Version 0.0.63 – bis heute „latest“, also das, was der Installer nachlädtnpm-Registry: hap-homematic
  5. 01.10.2022npm-Version 2.0.2 unter dem Tag „beta“ (andere Abhängigkeiten, u. a. express und hap-nodejs 0.10.4) – wird vom Installer nicht geladennpm-Registry: hap-homematic
  6. 25.04.2024OpenCCU-Maintainer rät vom Einsatz ab (nicht mehr gepflegt)OpenCCU Issue #2724 – Antwort des Mainta
  7. 04.05.2024Letzte Code-Änderungen im RepositoryCommit-Historie (master)
  8. 29.05.2026Repository vom Eigentümer archiviert – nur noch lesbarGitHub-API: Repository-Daten

🧭Was die Archivierung praktisch bedeutet

🔒

Nur noch lesbar

GitHub zeigt den Hinweis „This repository was archived by the owner on May 29, 2026. It is now read-only.“ Neue Issues, Kommentare, Pull Requests und Commits sind nicht mehr möglich. 78 Issues sind offen geblieben.

▶️

Laufende Installationen laufen weiter

Die Archivierung ändert nichts an einer bestehenden Installation. Installer (GitHub-Release 0.0.14) und Dienst (npm 0.0.63) sind am Abrufdatum weiterhin abrufbar – eine Neuinstallation ist technisch also noch möglich.

⛔

Keine Updates mehr

Der Dienst sucht in der npm-Registry nach einer neueren Version, die Zentrale in der Datei VERSION des Repositorys. Beides bleibt stehen: seit dem 22.06.2021 gibt es keine neue „latest“-Version, seit dem 04.05.2024 keine Code-Änderung.

🧩

Abhängigkeiten altern

Das veröffentlichte Paket 0.0.63 verlangt hap-nodejs ^0.5.7. In Issues wird berichtet, dass das Addon mit hap-nodejs 1.1.0 nicht mehr startet; bei einem manuellen Update meldete npm 2023 acht bekannte Schwachstellen in den Abhängigkeiten.

🧯

Niemand behebt Fehler

Neue Gerätetypen, Anpassungen an neue Firmware der Zentrale oder an neue Node.js-Versionen kommen nicht mehr. Hilfe gibt es nur noch aus den vorhandenen Issues und dem Wiki.

🗣️

Einschätzung des OpenCCU-Maintainers

Bereits am 25.04.2024 schrieb der Maintainer von OpenCCU (ehemals RaspberryMatic), das Addon sei nicht mehr gepflegt; er rate davon ab, es noch zu verwenden, weil es die Stabilität der Zentrale gefährden könne.

🛡️Wenn du es (weiter) betreibst

Die folgenden Punkte sind Empfehlungen dieser App – abgeleitet aus dem Stand des Projekts, nicht aus dessen Dokumentation.
  • Regelmäßig die Konfiguration über Backup sichern – sie steckt nicht im Backup der Zentrale.
  • Port 9874 nicht aus dem Internet erreichbar machen; in der Konfigurationsseite HTTPS und CCU-Anmeldung einschalten.
  • Vor jedem Firmware-Update der Zentrale ein vollständiges Backup anlegen und danach prüfen, ob der Dienst noch startet.
  • Keine „Reparaturen“ aus alten Issues ungeprüft übernehmen (z. B. Abhängigkeiten auf „latest“ ziehen).
  • Den Umstieg auf eine gepflegte Lösung planen, bevor ein Update der Zentrale ihn erzwingt.

🔀Alternativen

Aufgenommen sind nur Lösungen, deren Zustand sich am Abrufdatum prüfen ließ. Diese App hat keine davon selbst getestet.

RedMatic-HomeKit

gepflegt

Läuft auf der Zentrale (Node-RED als Addon „RedMatic“) oder in jeder Node-RED-Installation

Node-RED-Nodes auf Basis von HAP-NodeJS, die HomeMatic-Geräte und beliebige Node-RED-Daten als HomeKit-Zubehör bereitstellen. Dem hier erklärten Addon am ähnlichsten, weil ebenfalls ohne zweiten Rechner nutzbar.

Stand 01.10.2026: nicht archiviert; letzter Push im September 2026; laut Projektseite Version 4.0.0 für RedMatic 9; Apache-2.0

ioBroker mit Adapter „yahka“

gepflegt

Läuft auf einem eigenen Rechner mit ioBroker

Der Adapter bildet ioBroker-Datenpunkte auf HomeKit-Characteristics ab; die HomeMatic-Geräte kommen über die HomeMatic-Adapter von ioBroker. Die Zuordnung macht man selbst – flexibel, aber mehr Handarbeit.

Stand 01.10.2026: nicht archiviert; letzter Push im Juni 2026; MIT

Home Assistant mit „HomeKit Bridge“

gepflegt

Läuft auf einem eigenen Rechner mit Home Assistant

Die Integration HomeKit Bridge stellt Home-Assistant-Entitäten in HomeKit bereit. Die Zentrale wird über die Zusatz-Integration „Homematic(IP) Local“ (Custom Component) angebunden. Auch hier gilt die Grenze von 150 Zubehör-Kennungen je Bridge; mehrere Bridges sind möglich.

Stand 01.10.2026: Teil von Home Assistant; die HomeMatic-Integration ist nicht archiviert (letzter Push September 2026, MIT)

Homebridge mit „homebridge-homematic“

archiviert

Läuft auf einem eigenen Rechner mit Homebridge

Der Vorgänger vom selben Autor – das README von hap-homematic verweist darauf.

Stand 01.10.2026: ebenfalls archiviert (letzter Push 27.09.2022) – also kein Ausweg

Zu ioBroker und Home Assistant gibt es in dieser Sammlung eigene Apps: VisualIoBroker ↗ und VisualHomeAssistant ↗.