Skip to content
BranchesTags

Latest commit

 

History

1,218 Commits

Folders and files

NameName
Last commit message
Last commit date
.github
.github
 
 
addon_files
addon_files
 
 
assets
assets
 
 
docs
docs
 
 
roadmap-archive
roadmap-archive
 
 
tools
tools
 
 
.editorconfig
.editorconfig
 
 
.gitattributes
.gitattributes
 
 
.gitignore
.gitignore
 
 
AGENTS.md
AGENTS.md
 
 
BUILD.md
BUILD.md
 
 
CLAUDE.md
CLAUDE.md
 
 
HANDOFF.md
HANDOFF.md
 
 
LICENSE
LICENSE
 
 
README.en.md
README.en.md
 
 
README.md
README.md
 
 
ROADMAP.md
ROADMAP.md
 
 
alpine-packages.mjs
alpine-packages.mjs
 
 
build.sh
build.sh
 
 
build_addon.sh
build_addon.sh
 
 
build_change_history.sh
build_change_history.sh
 
 
build_release_body.sh
build_release_body.sh
 
 
eslint.config.js
eslint.config.js
 
 
package.json
package.json
 
 
update_change_history.js
update_change_history.js
 
 
update_nodejs.js
update_nodejs.js
 
 
update_package.js
update_package.js
 
 
update_readme.js
update_readme.js
 
 
update_release_body.sh
update_release_body.sh
 
 

Repository files navigation


Current Release Installs

Node-RED als Addon für die Homematic CCU3 und OpenCCU

Click here for 🇬🇧🇺🇸 english readme

🚀 Schnellstart       📚 Dokumentation       📦 Download       🚑 Support       👮 Lizenzen

⚠️ RedMatic 9: RedMatic wird radikal verschlankt und modernisiert (Node.js 24, Node-RED 5). Ab Version 9 ist nur noch node-red-contrib-ccu vorinstalliert — alle weiteren Nodes (z. B. Dashboard, HomeKit) werden bei Bedarf über den Node-RED Paletten-Manager installiert. Der RedMatic-Paketmanager und die RedMatic-WebApp sind deprecated und entfallen ersatzlos. Bekannte und akzeptierte Einschränkung: npm-Pakete bzw. Nodes mit binären (nativen) Abhängigkeiten können auf der CCU nicht installiert werden — auf der CCU gibt es keine Compiler-Toolchain, und vorkompilierte Binaries werden nicht mehr mitgeliefert.

RedMatic 9 ist noch in Entwicklung — mit einem ersten Release ist frühestens in einigen Tagen zu rechnen.

RedMatic verpackt Node-RED als CCU Addon, ein Softwarepaket, das auf einer Homematic CCU3 oder OpenCCU (ehemals RaspberryMatic) als Zusatzsoftware komfortabel über das WebUI installiert werden kann.

Die Grundlage bildet Node-RED mit den CCU Nodes für Node-RED. Hiermit ist es auf einfache und visuelle Weise möglich Regeln, Automationen, Scripte und Anbindungen von externen Services und Systemen für ein Homematic System zu realisieren - und das weitgehend auch ohne Programmierkenntnisse. Im Wiki gibt es weitere Informationen zu Node-RED und einige Anwendungsbeispiele (sogenannte Flows).

Die Einrichtung und der Betrieb von RedMatic ist sehr benutzerfreundlich, es bedarf keiner Linux-Kenntnisse und es müssen keine Konfigurationsdateien bearbeitet werden.

Ab RedMatic 9 ist das Addon bewusst schlank: Nur die CCU Nodes sind vorinstalliert. Alle weiteren Nodes — z.B. das Node-RED Dashboard für Visualisierung und Steuerung — werden bei Bedarf einfach über den Node-RED Paletten-Manager installiert. Die frühere RedMatic WebApp und der RedMatic-Paketmanager sind deprecated und nicht mehr enthalten. Bekannte und akzeptierte Einschränkung: Nodes mit binären (nativen) Abhängigkeiten können auf der CCU nicht installiert werden — auf der CCU gibt es keine Compiler-Toolchain, und vorkompilierte Binaries werden nicht mehr mitgeliefert.

Eine Anbindung der CCU an einen MQTT Broker mit komfortabel konfigurierbarer Topic- und Payload-Struktur wird durch einen speziellen Node vereinfacht.

Eine große und aktive Community rund um Node-RED hat zudem eine Bibliothek von tausenden zusätzlichen Nodes geschaffen die auf einfache Weise installiert werden können und es ermöglichen spezielle Automatismen zu implementieren und diverse weitere Services und Systeme komfortabel anzubinden - wie z.B. KNX, Loxone, Somfy Tahoma, Velux KLF200, Home Connect Haushaltsgeräte, verschiedene Smart TVs und AV-Receiver, Sonos, Netatmo, Hue, Amazon Alexa, Google Home, diverse Datenbanken wie z.B. InfluxDB oder MySQL, Webservices zur Abfrage von beispielsweise Wetterdaten und vieles mehr.

RedMatic kann damit - insbesondere auch für diejenigen die neben der CCU keinen weiteren Server betreiben möchten - eine Alternative zu einem "ausgewachsenen" Smart Home System wie z.B. Home Assistant oder ioBroker darstellen. Auch eine Koexistenz mit vorhandener anderer Smart Home Software kann sinnvoll sein, RedMatic eignet sich z.B. auch sehr gut als Schnittstelle um eine Homematic CCU an ein übergeordnetes System via MQTT anzubinden. Nicht zuletzt kann RedMatic auch als stabile und mit wesentlich mehr Möglichkeiten aufwartende Alternative oder Ergänzung zu den WebUI-Programmen und Scripten der CCU Logikschicht "Rega" dienen.

Voraussetzungen

RedMatic ist geeignet für die CCU3 (und piVCCU3) sowie für OpenCCU auf den Architekturen armv7l (z.B. Raspberry Pi 2), aarch64 (z.B. Raspberry Pi 3/4) und x86_64 (z.B. ova, intelnuc, Container).

Auf der CCU1, CCU2 und auf armv6l-Systemen (Raspberry Pi 1/Zero) kann RedMatic nicht verwendet werden.

Schnellstart

Unter Releases steht die Datei redmatic-<version>.tar.gz zum Download zur Verfügung. Nach der Installation des Addons über das Homematic WebUI (Systemsteuerung -> Zusatzsoftware) und dem darauf folgenden Reboot der CCU ist Node-RED unter http://<ccu-addresse>/addons/red erreichbar. Bei der Installation ist Geduld erforderlich, es kann einige Minuten dauern.

Support, Mitarbeit

Für Feedback jeglicher Art, Fragen, Vorschläge und Wünsche bitte das Diskussionsforum nutzen. Für Bug Reports bitte den Issue Tracker nutzen.

Beteiligung in jeder Form ist willkommen und gewünscht, insbesondere sind alle Nutzer aufgefordert die Liste erfolgreich getesteter Nodes zu ergänzen, Beispiel-Flows zu veröffentlichen und an der Verbesserung und Erweiterung der Dokumentation mitzuarbeiten.

Es werden keine Spenden angenommen, ich würde mich jedoch darüber freuen wenn der erfolgreiche Einsatz dieser Software mit einem Github Sternchen ⭐️ honoriert wird (Github Account ist schnell angelegt! ;-)

Dokumentation

Lizenzen

  • RedMatic © 2018-2026 Sebastian Raff and RedMatic Contributors, licensed under Apache License 2.0
  • RedMatic Documentation © 2018-2026 Sebastian Raff and RedMatic Contributors, licensed under CC BY-SA License 4.0
  • Third-party components are listed in the SBOM files (CycloneDX) attached to each release; the full license texts ship inside the addon in each package's node_modules directory

DIE SOFTWARE WIRD OHNE JEDE AUSDRÜCKLICHE ODER IMPLIZIERTE GARANTIE BEREITGESTELLT, EINSCHLIEẞLICH DER GARANTIE ZUR BENUTZUNG FÜR DEN VORGESEHENEN ODER EINEM BESTIMMTEN ZWECK SOWIE JEGLICHER RECHTSVERLETZUNG, JEDOCH NICHT DARAUF BESCHRÄNKT. IN KEINEM FALL SIND DIE AUTOREN ODER COPYRIGHTINHABER FÜR JEGLICHEN SCHADEN ODER SONSTIGE ANSPRÜCHE HAFTBAR ZU MACHEN, OB INFOLGE DER ERFÜLLUNG EINES VERTRAGES, EINES DELIKTES ODER ANDERS IM ZUSAMMENHANG MIT DER SOFTWARE ODER SONSTIGER VERWENDUNG DER SOFTWARE ENTSTANDEN.

About

Node-RED packaged as Addon for the Homematic CCU3 and OpenCCU 🤹‍♂️

Topics

addonccuhome-automationhomekithomematiciotmqttnode-redraspberrymaticsmarthome

Resources

Readme
Apache-2.0 license
Activity
Custom properties

Stars

532 stars

Watchers

44 watching

Forks

48 forks
Report repository

Releases

Used by

Contributors

Languages