Skip to content

Supernotify

Supernotify

Rhizomatics Open Source hacs

Ruff pre-commit.ci status Coverage Tests Github Deploy CodeQL Dependabot Updates

Zu HACS hinzufügen


Einheitliche Benachrichtigungen für Home Assistant

GROSSE ÄNDERUNG v2.0.0

2.0.0 von SuperNotify wechselt zu einer nativen Home Assistant UI-Konfiguration ('ConfigFlow'). Wenn du bereits eine einfache Konfiguration hast, wird alles automatisch für dich migriert und es wird kein YAML mehr benötigt.

Wenn du eine fortgeschrittene Konfiguration hast (Lieferungen, Szenarien, Kameras, Personen, Aktionen usw.), wird eine Reparatur ausgelöst, um diese in eine neue Datei supernotify.yaml zu verschieben und eine include-Anweisung zu deiner configuration.yaml hinzuzufügen. Oder du kannst die Konfiguration manuell aus dem notify-Block verschieben, wie es dir beliebt.

In beiden Fällen wird nichts gelöscht oder auskommentiert, sodass die Änderung leicht rückgängig zu machen ist. Entferne die alte Konfiguration, sobald du sicher bist, dass die neue Version für dich funktioniert.

Eine einheitliche Benachrichtigungsschnittstelle auf Basis der integrierten notify-Plattform von Home Assistant, um mehrere Benachrichtigungskanäle und komplexe Szenarien erheblich zu vereinfachen, einschließlich Mehrkanal-Benachrichtigungen, bedingter Benachrichtigungen, mobiler Aktionen, Kamera-Snapshots, Klingeltöne und vorlagenbasierter HTML-E-Mails.

Supernotify hat ein einziges Ziel: mit der einfachstmöglichen Benachrichtigung so viele Benachrichtigungen wie nötig auszulösen, ohne Code und mit minimaler Konfiguration.

Dies hält Automatisierungen, Skripte und AppDaemon-Apps einfach und wartungsfreundlich, wobei alle Details und Regeln an einem Ort verwaltet werden. Die kleinstmögliche Benachrichtigung — nur eine Nachricht — kann ausreichen, um alles auszulösen. Ändern Sie E-Mail-Adressen an einer Stelle und lassen Sie Supernotify herausfinden, welche mobilen Apps verwendet werden sollen.

Nur mit der UI-Konfiguration beginnen Sie sofort mit mobilen Push-Benachrichtigungen an alle im Haus registrierten Personen, ohne die Namen der mobilen Apps in Benachrichtigungen zu konfigurieren.

Verteilung

Supernotify ist ein benutzerdefiniertes Komponent, das über den Home Assistant Community Shop (HACS) verfügbar ist. Es ist kostenlos und quelloffen unter der Apache 2.0-Lizenz.

Dokumentation

Starten Sie mit Erste Schritte, der Erklärung der Kernkonzepte und den verfügbaren Transport-Adaptern. Benachrichtigen zeigt, wie Sie Supernotify aus Automatisierungen oder der Entwicklertools-Aktionsseite aufrufen.

Es gibt viele Rezepte mit Beispielkonfigurationen oder durchsuchen Sie nach Tags.

Funktionen

  • Eine Aktion -> Mehrere Benachrichtigungen
    • Entfernen Sie repetitive Konfiguration und Code aus Automatisierungen
    • Adapter passen Benachrichtigungsdaten automatisch für jede Integration an
    • Verwenden Sie es z. B. mit einem Frigate Blueprint für Kamera-Snapshots per E-Mail
  • Automatische Einrichtung
    • Lieferungskonfiguration für mobile Push-, E-Mail- (SMTP) und Benachrichtigungsentitäten wird automatisch eingerichtet
    • Mobilen Apps werden automatisch erkannt, einschließlich Hersteller und Modell des Telefons
    • Alexa-Geräte für Klingeltöne werden automatisch erkannt
  • Über notify-Integrationen hinaus
    • Klingeltöne, Sirenen, SMS, TTS, Alexa-Ankündigungen und -Töne, API-Aufrufe, MQTT-Geräte, Gotify, ntfy
    • Alle Standard-notify- und notify.group-Implementierungen verfügbar
    • Stark vereinfachte Nutzung von mobilen Push-Benachrichtigungen, z. B. für iPhone
  • Bedingte Benachrichtigungen
    • Verwendung von Standard Home Assistant conditions
    • Zusätzliche Bedingungsvariablen hinzugefügt, einschließlich Nachricht und Priorität
    • Kombination mit Anwesenheitserkennung für kontextabhängige Benachrichtigungen
  • Szenarien für einfache, prägnante Konfiguration
    • Bündeln Sie häufig verwendete Konfigurationsblöcke und bedingte Logik
    • Auf Abruf anwenden (red_alert, nerdy) oder automatisch basierend auf Bedingungen
  • Einheitliches Personenmodell
    • Definieren Sie eine E-Mail, SMS-Nummer oder ein mobiles Gerät und verwenden Sie dann die person-Entität in Benachrichtigungsaktionen
    • Personen werden automatisch mit ihren mobilen Apps konfiguriert
  • Einfache HTML-E-Mail-Vorlagen
    • Standard Home Assistant Jinja2, definiert in der YAML-Konfiguration, Aktionsaufrufen oder als eigenständige Dateien
    • Standardvorlage mitgeliefert
  • Mobile Aktionen
    • Richten Sie einen einheitlichen Satz mobiler Aktionen für mehrere Benachrichtigungen ein
    • Enthält Schlummern-Aktionen zum Stummschalten nach Kriterien
  • Flexible Bild-Snapshots
    • Unterstützt Kameras, MQTT-Bilder und Bild-URLs
    • Kameras vor und nach einem Snapshot auf PTZ-Voreinstellungen repositionieren
  • Wahl des Konfigurationsniveaus
    • Standardwerte auf Transport-, Liefer- und Aktionsebene festlegen
  • Unterdrückung doppelter Benachrichtigungen
    • Einstellbare Wartezeit vor erneuter Zulassung
  • Benachrichtigungs-Archivierung und Debug-Unterstützung
    • Optionale Archivierung von Benachrichtigungen ins Dateisystem und/oder MQTT-Topic
    • Enthält vollständige Debug-Informationen
    • Lieferungen, Transporte, Empfänger und Szenarien als Entitäten in der Home Assistant-Oberfläche

YAML nur für erweiterte Nutzung

Supernotify unterstützt derzeit die standardmäßige Home Assistant UI-Konfiguration für die Basiseinrichtung sowie YAML-Konfiguration für erweiterte Funktionen. YAML bleibt erhalten, um die Arbeit mit größeren Regelwerken zu erleichtern.

Mit der einfachen Nicht-YAML-Konfiguration lässt sich bereits viel erreichen, einschließlich der automatischen Einrichtung von Mobile Push. Siehe die Rezepte in der Dokumentation, sowie dieses Mobile-Push-Beispiel:

Mit null YAML, alles per UI konfiguriert
  - action: notify.supernotify
    data:
        message: Hallo! Test von Supernotify, das an alle mobilen Apps sendet

Rhizomatics Open Source für Home Assistant

HACS

  • AutoArm - Automatisches Aktivieren und Deaktivieren von Home Assistant Alarmsteuerpanelen mit physischen Tasten, Anwesenheit, Kalendern und mehr
  • Remote Logger - OpenTelemetry (OTLP) und Syslog-Ereigniserfassung für Home Assistant

Python / Docker

  • Anpr2MQTT - Integration mit ANPR/ALPR-Kennzeichenkameras über das Dateisystem zu MQTT
  • Updates2MQTT - Automatische Benachrichtigung über MQTT bei Docker-Image-Updates