Zigbee2MQTT Manager 1.0.3 – Zigbee2MQTT komplett in einer HA-Dashboard-Karte verwalten (HACS)

Hallo zusammen,

ich habe eine neue Home-Assistant-Integration veröffentlicht: den Zigbee2MQTT Manager. Mit Version 1.0.3 gibt es jetzt die erste offizielle Version, und ich würde mich sehr über Tester und Feedback freuen.

Worum geht es?

Zigbee2MQTT verwalten, ohne Home Assistant zu verlassen. Geräte, Batterien, Firmware-Updates, Gruppen, Bindings und Bridge stecken in einer Dashboard-Karte. Die Installation läuft über HACS, die Karte trägt sich selbst als Lovelace-Ressource ein.

Was kann sie?

Die Karte hat sechs Kategorien, die sich einzeln ein- und ausblenden lassen:

  • Geräte – Erreichbarkeit, Modell, Signal, Batterie, „zuletzt gesehen“; Filter (Offline / Batterie niedrig / Updates), Suche und Sortierung
  • Batterie – niedrigster Stand zuerst, Farben nach Schwellwerten
  • Updates – installierte vs. verfügbare Firmware, „Alle prüfen“ und „Alle nacheinander installieren“ als Hintergrundauftrag mit Fortschritt und Abbruch
  • Gruppen – anlegen, umbenennen, löschen, Mitglieder verwalten
  • Bindings – Übersicht, lösen, neu verknüpfen
  • Bridge – App-Version, Status, Pairing, Bridge-Optionen, Neustart, Ereignisprotokoll

Im Geräte-Popup gibt es Informationen, Umbenennen (mit Liste der betroffenen HA-Entitäten), Geräteoptionen, Firmware, Bindings, Gruppen und Entfernen. Riskante Aktionen verlangen eine Zwei-Klick-Bestätigung.

Außerdem dabei:

  • grafischer Karten-Editor (kein YAML nötig) und frei einstellbare Farben
  • Modus „Nur lesen“, zum Beispiel für Wandtablets
  • Zwischenspeicher: Batterie, Signal und OTA-Status überleben einen HA-Neustart
  • Services (permit_join, check_updates), Ereignisse für Automationen (offline/online, Batterie niedrig, Update verfügbar, Gerät beigetreten/entfernt) und Sensoren
  • Deutsch und Englisch, Diagnose-Download mit anonymisierten Namen und IEEE-Adressen
  • Hinweis auf neue Versionen direkt in den Einstellungen

Alle schreibenden Aktionen sind auf Administratoren beschränkt.

Voraussetzungen

  • Home Assistant 2025.6 oder neuer
  • eingerichtete MQTT-Integration
  • Zigbee2MQTT 2.x (1.x wird erkannt und als nicht unterstützt gemeldet)
  • empfohlen: availability: true in Zigbee2MQTT, für „zuletzt gesehen“ zusätzlich advanced.last_seen: ISO_8601

Installation

  1. HACS → ⋮ → Benutzerdefinierte Repositories → GitHub - Meine-smarte-Welt/zigbee2mqtt_manager · GitHub , Kategorie Integration
  2. „Zigbee2MQTT Manager“ installieren und Home Assistant neu starten
  3. Einstellungen → Geräte & Dienste → Integration hinzufügen → Zigbee2MQTT Manager
  4. Base-Topic eintragen (Standard zigbee2mqtt) und Schwelle für „Batterie niedrig“ wählen
  5. Dashboard bearbeiten → Karte hinzufügen → Zigbee2MQTT Manager

Direkt-Link zu HACS: Repository in HACS öffnen

Bitte testen!

Das ist die erste offizielle Version, und nicht jede Zigbee2MQTT-Konstellation konnte ich selbst nachstellen. Besonders interessiert mich:

  • Funktionieren Geräteoptionen, Bindings und Bridge-Optionen bei euch mit eurer Z2M-2.x-Version?
  • Passt die Anzeige bei vielen Geräten?
  • Wie verhält sich das Ganze mit mehreren Z2M-Instanzen (entry_id)?
  • Was fehlt euch noch?

Links

Wenn euch das Projekt gefällt, freue ich mich über einen :star: auf GitHub.

Viele Grüße
Thorsten
(Meine smarte Welt – meinesmartewelt.de)

Ich werde es testen, Dankeschön :folded_hands:t2:

Danke. Featurewünsche herzlich willkommen

Klingt Interessant werde ich mir auf jeden Fall auch ansehen.

Ich nutze zwar ZHA habe aber auch Z2M Installiert zu Testzwecken
mit einigen Geräten und Sensoren.

Soeben installiert und was ich bisher sehe gefällt es mir sehr gut! Vielen dank :slight_smile:

–EDIT–

Geräteoptionen geht bei mir nicht:

too many values to unpack (expected 2, got 3)

Bridge ist ein SONOFF Zigbee 3.0 USB Dongle Plus (ZStack3x0 - 20221226)

–EDIT 2–

In der manager.py habe ich dieses:

matches = any(
                domain == "mqtt" and str(ident).endswith(ieee)
                for domain, ident in device.identifiers
            )

ersetzt durch:

matches = any(
                len(ident) >= 2
                and ident[0] == "mqtt"
                and any(str(part).endswith(ieee) for part in ident[1:])
                for ident in device.identifiers
            )

Danach ging es dann, aber die bereits eingestellten Werte werden noch nicht angezeigt. Aber es kommt zumindest schon mal kein Fehler mehr…

Ich habs auch mal runtergeladen. Sieht echt gut aus. Alles in einem. Gute leistung.

Hallo zusammen,

die Version 1.0.4 vom Zigbee2MQTT Manager (HACS-Integration mit Dashboard-Karte) ist draußen. Danke für das Feedback hier im Forum, das meiste davon ist direkt eingeflossen!

Neu

  • Im Geräte-Popup gibt es einen neuen Akkordeon-Abschnitt „Funktionen (Expose)“. Er zeigt alle Funktionen, die Zigbee2MQTT für das Gerät bereitstellt, mit aktuellem Wert samt Einheit, Zugriff (Lesen/Schreiben/Abfragen), Wertebereich bzw. Auswahlwerten und Beschreibung. Bei offenem Abschnitt aktualisieren sich die Werte live. Die Anzeige ist rein lesend.
  • Mehrere Instanzen (z. B. drei Sticks): Jeder Stick wird als eigener Eintrag mit eigenem Base-Topic eingerichtet. In der Karte erscheint dann oben ein Umschalter. Alternativ lässt sich eine Karte fest an einen Stick binden, im Editor unter „Instanz (Stick)“ oder per YAML:

yaml

type: custom:zigbee2mqtt-manager-card
base_topic: zigbee2mqtt2

Behoben

  • Geräteoptionen: „too many values to unpack (expected 2, got 3)“, aufgetreten z. B. mit dem SONOFF Zigbee 3.0 USB Dongle Plus. Danke an den Forumsnutzer für den Hinweis samt Lösungsvorschlag!

Bitte testen und melden

  • Ich konnte die neuen Funktionen nur mit Testdaten prüfen, nicht mit mehreren echten Sticks. Rückmeldungen dazu sind sehr willkommen.
  • Wenn die bereits eingestellten Werte in den Geräteoptionen weiterhin fehlen, hilft mir ein Auszug aus zigbee2mqtt/bridge/info (Abschnitt config.devices) und die Z2M-Version.

Update: über HACS aktualisieren, Home Assistant neu starten, danach den Browser neu laden (Strg+F5).

Repository und Release Note: Releases · Meine-smarte-Welt/zigbee2mqtt_manager · GitHub

Viele Grüße
Thorsten

Zigbee2MQTT Manager 1.0.5: Geräte, Batterien, Firmware und Gruppen in einer HA-Karte

Kurz: Der Zigbee2MQTT Manager ist eine HACS-Integration mit Dashboard-Karte, mit der du Zigbee2MQTT aus Home Assistant heraus verwaltest. Alles läuft lokal über deine MQTT-Integration, kostenlos unter MIT-Lizenz. Version 1.0.5 behebt die Bedienprobleme im Geräte-Popup aus 1.0.4.

Ausführlicher Blogbeitrag mit Installation und Beispielen: HIER-LINK-EINFÜGEN

Was kann es?

  • Geräteliste mit Erreichbarkeit, Signal, Batterie, „zuletzt gesehen“, Suche und Sortierung
  • Batterie-Übersicht mit Schwellen für „niedrig“ und „kritisch“
  • Firmware-Updates (OTA): prüfen, einzeln oder nacheinander installieren
  • Gruppen und Bindings verwalten, Geräte umbenennen (inkl. Anpassung der HA-Entitäten)
  • Alle Expose-Funktionen eines Geräts mit aktuellem Wert (nur Anzeige)
  • Mehrere Zigbee2MQTT-Instanzen (mehrere Sticks), jeweils mit eigenem Base-Topic
  • Sensoren und Events für Automationen (offline, Batterie niedrig, Update verfügbar, Gerät beigetreten/gegangen)
  • Versionsanzeige mit Hinweis, wenn auf GitHub eine neuere Version liegt
  • Sprachen: Deutsch, Englisch, Niederländisch

Neu in 1.0.5

  • Popup und Abschnitt „Funktionen (Expose)“ lassen sich wieder bedienen. Ursache war eine Endlosschleife beim Neuzeichnen (jeder offene Abschnitt löste das Nachladen erneut aus).
  • Offline-Anzeige abgesichert: Hat ein Gerät nach einer Offline-Meldung von Zigbee2MQTT live gesendet, wird es als erreichbar angezeigt.
  • Niederländisch, MIT-Lizenz und Beispiele im Repo ergänzt.
  • Danke an @pr0xyzer für Pull Request #2 (Zuordnung der HA-Entitäten über MQTT-Identifier).

Voraussetzungen

  • Home Assistant ab 2025.6
  • MQTT-Integration eingerichtet
  • Zigbee2MQTT 2.x (1.x wird nicht unterstützt)
  • Empfohlen: availability: true in Zigbee2MQTT, für „zuletzt gesehen“ advanced.last_seen: ISO_8601

Installation

  1. HACS → ⋮ → Benutzerdefinierte Repositories → https://github.com/meine-smarte-welt/zigbee2mqtt_manager → Kategorie Integration
  2. „Zigbee2MQTT Manager“ installieren und Home Assistant neu starten
  3. Einstellungen → Geräte & Dienste → Integration hinzufügen → Zigbee2MQTT Manager, Base-Topic eintragen (Standard zigbee2mqtt)
  4. Karte hinzufügen: Dashboard bearbeiten → Karte hinzufügen → „Zigbee2MQTT Manager“. Die Karte trägt sich als Lovelace-Ressource automatisch ein (im YAML-Modus manuell: /zigbee2mqtt_manager_files/zigbee2mqtt-manager-card.js, Typ module)
  5. Nach einem Update: Browser-Cache leeren (Strg+F5), in der Companion-App die App neu laden

Datenschutz

Die Steuerung läuft lokal. Zwei optionale Zugriffe ins Internet: die Versionsabfrage bei GitHub (alle 12 Stunden) und die Gerätebilder, die dein Browser von zigbee2mqtt.io lädt. Mit show_images: false in der Karte laden keine Bilder.

Teststand und bekannte Einschränkungen

  • Die Korrekturen in 1.0.5 sind nicht an echter Hardware geprüft, nur gegen simulierte Daten und per Code-Prüfung. Im Browser und in der Companion-App habe ich sie noch nicht getestet.
  • In 1.0.4 wurden bei einem Nutzer 6 Geräte (5 Sensoren eines Typs, 1 Steckdose von 8 baugleichen) fälschlich als offline angezeigt. Die Ursache konnte ich ohne Logs nicht bestätigen. 1.0.5 sichert gegen veraltete Offline-Meldungen ab, ob das dein Problem löst, ist offen.
  • Zigbee2MQTT setzt Batteriegeräte erst nach Stunden ohne Nachricht auf „offline“. Der Status kommt von dort (<base_topic>/<Gerät>/availability).
  • Geräteoptionen unterstützen einfache Typen, keine verschachtelten Optionen. Weitere Punkte stehen in der README.

Fehlersuche

Setze custom_components.zigbee2mqtt_manager auf debug und prüfe die Logs. Hilfreich für Meldungen: Gerätemodell, Z2M-Version, die Z2M-Einstellung availability und der Diagnose-Download der Integration (Namen und Adressen sind anonymisiert).

Feedback

Ich freue mich über Fehlermeldungen und Ideen – gern hier oder als Issue auf GitHub: Issues · Meine-smarte-Welt/zigbee2mqtt_manager · GitHub

Ich entwickle den Zigbee2MQTT Manager, eine kostenlose Home-Assistant-Integration (über HACS) mit Dashboard-Karte: Geräte, Batterien, Firmware-Updates, Gruppen und Bindings von Zigbee2MQTT an einem Ort, lokal über MQTT.

Neu in Version 1.1.0: Geräte nach Hersteller oder Geräteklasse gruppieren, Filter (online/offline u. a.), Schalter im Popup umlegen und Entitäts-Namen kopieren. Ehrlich dazu: bisher mit simulierten Daten getestet, noch nicht an echter Hardware. Feedback ist deshalb besonders willkommen.

Mich interessiert eure Meinung: Welche Funktion fehlt euch, wenn ihr Zigbee2MQTT in Home Assistant nutzt?

Schreibt eure Idee in die Kommentare, gern mit einem Satz, wofür ihr sie braucht.
Gebt Ideen, die ihr auch wollt, einen Daumen hoch. So sehe ich, was am meisten gebraucht wird.

GitHub: GitHub - Meine-smarte-Welt/zigbee2mqtt_manager · GitHub

Hallo @MeinesmarteWelt ,

ich habe Deine Integration gerade installiert. Nach einem Neustart entsprechend Deiner Schritte 1-3 durchführen können.

Jedoch wird mir die Karte in der Liste nicht angezeigt:

In den Ressourcen ist die Karte aufgeführt (Link nicht 1:1 gleich zu Deinem Text hier):

Solltest Du für eine Fehlerbeseitigung noch weitere Infos benötigen, lass es mich gerne wissen.

Grüße Thomas

Bitte die Seite neu laden über F5. Sollte es nicht helfen, bitte ich den Browser Cache zu leeren (Strg + Umschalttaste + R). Danach sollte es laufen.

Das hatte ich natürlich gemacht, bevor ich den Beitrag geschrieben hatte - aber ohne Erfolg. Gerade nochmal, jetzt gehts. Komisch. Danke!

Hi.
Habs gestern auch mal installiert, zusammen mit dem Matter Manager. Dieser funktioniert auch, der Zigbee2MQTT Manager zeigt mir allerdings nichts an. Auch eine Neuinstallation hat nichts gebracht. Als Stick nutze ich einen MR5U, falls das eine Rolle spielt.
Ansonsten TOP! Danke.

Moin @MeinesmarteWelt . Ich habe gelegentlich das Problem, dass Offline Geräte nicht korrekt als offline angezeigt werden. Hier als Beispiel ein Shelly, der seit Wochen abgeklemmt in der Schublade liegt.

Edit: Das Problem scheint der HA-Neustart zu sein. Danach werden die Offline Geräte als online angezeigt bis die Integration neu gestartet wird.

Nachdem Neustart der Zigbee2MQTT Manager Integration passt es dann wieder und die Offline Geräte werden richtig erkannt.

Vielen Dank fürs Vorstellen, ist gerade runtergeladen und kann sich jetzt bei mir bewähren.

Hab es gestern installiert und bin begeistert. Tolle Arbeit!! Danke dafür!!

Hab’s auch seit einigen Tagen laufen :slight_smile:

und bin nun bei „Wünsch Dir was“ :smiley:

  • in Z2M kann man Kommentare hinterlegen, wäre toll, wenn sich die optional einblenden ließen.
  • und es wäre noch toller, wenn das zugehörige HA-Gerät (und dessen Raum) auch mit angezeigt würden.

Soeben installiert und getestet, sehr gut und interessant, vielen Dank dafür!

Featurewunsch:
Eine zentrale Sammelentität (z. B. binary_sensor mit device_class: problem), die “an” geht, sobald etwas auffällig ist: Gerät offline, Batterie niedrig/kritisch, Firmware-Update verfügbar. Die einzelnen Zähler als Attribute wären ideal.

Hintergrund:
Die Karte ist mir für meine Dashboard-Leitseite zu groß. Ich hätte sie lieber auf einem eigenen Reiter und auf der Leitseite nur einen kleinen Button mit Farbumschlag, der dorthin verlinkt. Man könnte das mit einem Template-Sensor erreichen, der aus den vorhandenen Zählern eine Entität bildet. Eine fertige Entität wäre aber für alle bequemer.

in meinem „Zigbee Dashboard“ stelle ich die Verfügbarkeit so dar:


die einzelnen Listen lassen sich ausklappen:

die verwendete Karte ist die battery_state_card

Ich schaue es mir an