Skip to content

Supernotify

Supernotify

Rhizomatics Open Source hacs

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

HACSに追加


Home Assistant向け統合通知システム

Home Assistantの組み込みnotifyプラットフォームの上に構築された統合通知インターフェースで、複数の通知チャネルや複雑なシナリオを大幅に簡素化します。マルチチャネル通知、条件付き通知、モバイルアクション、カメラスナップショット、チャイム、テンプレートベースのHTMLメールに対応しています。

Supernotifyの目標はひとつ——コードなし、最小限の設定で、できる限りシンプルな通知から必要なだけ多くの通知を送ること

これにより、オートメーション、スクリプト、AppDaemonアプリがシンプルで保守しやすくなります。最小の通知——メッセージだけ——で必要なすべてを動かすことができます。メールアドレスを一箇所で変更するだけで、Supernotifyがどのモバイルアプリを使うか判断します。

たった2行のシンプルなYAMLで、モバイルアプリ名を設定することなく、家全員へのモバイルプッシュ通知を開始できます。

配布

SupernotifyはHACS(Home Assistant Community Shop)経由で利用可能なカスタムコンポーネントです。Apache 2.0ライセンスのもと、無料・オープンソースで提供されています。

ドキュメント

はじめにコアコンセプトの解説、利用可能なトランスポートアダプターをご覧ください。通知の送信では、オートメーションや開発者ツールからSupernotifyを呼び出す方法を説明しています。

サンプル設定を含む多くのレシピもあります。タグで絞り込むこともできます。

機能

  • 1つのアクション -> 複数の通知
    • オートメーションから繰り返しの設定とコードを削除
    • アダプターが各インテグレーション向けに通知データを自動調整
    • 例:Frigate Blueprintと組み合わせてカメラスナップショットをメールで受信
  • 自動セットアップ
    • モバイルプッシュ、メール(SMTP)、通知エンティティの配信設定が自動的に構成
    • モバイルアプリが自動検出(メーカー・機種情報含む)
    • チャイム用のAlexaデバイスが自動検出
  • notifyインテグレーションを超えた機能
    • チャイム、サイレン、SMS、TTS、Alexaアナウンス・サウンド、APIコール、MQTTデバイス
    • 標準的なnotifynotify.group実装すべてに対応
    • iPhoneなどのモバイルプッシュ通知を大幅に簡素化
  • 条件付き通知
    • Home Assistantの標準conditionsを使用
    • メッセージや優先度を含む追加の条件変数
    • 在室検知と組み合わせ、誰がいるか・メッセージの優先度・内容に基づいて通知を最適化
  • シンプルな設定のためのシナリオ機能
    • 共通の設定と条件ロジックをパッケージ化
    • オンデマンド(red_alertnerdy)または条件に基づいて自動適用
  • 統合人物モデル
    • メール、SMS番号、またはモバイルデバイスを定義し、通知アクションでpersonエンティティを使用
    • 人物はモバイルアプリと合わせて自動設定
  • 簡単なHTMLメールテンプレート
    • YAML設定・アクションコール・スタンドアロンファイルで定義できる標準Jinja2
    • デフォルト汎用テンプレート付属
  • モバイルアクション
    • 複数の通知に対して一貫したモバイルアクションのセットを設定
    • 条件に基づいてミュートするスヌーズアクションを含む
  • 柔軟な画像スナップショット
    • カメラ、MQTT画像、画像URLに対応
    • スナップショット前後にカメラをPTZプリセットに移動
  • 設定レベルの選択
    • トランスポート、配信、アクションの各レベルでデフォルトを設定可能
  • 重複通知の抑制
    • 再許可するまでの待機時間を調整
  • 通知のアーカイブデバッグサポート
    • ファイルシステムやMQTTトピックへのオプションのアーカイブ
    • 完全なデバッグ情報を含む
    • 配信、トランスポート、受信者、シナリオをHome Assistant UIのエンティティとして公開

YAMLが少し必要

Supernotifyは現在YAMLベースの設定のみをサポートしています。コピー&ペーストの2行の設定だけで多くのことができます:

デフォルトの2行のYAML
  - action: notify.supernotify
    data:
        message: こんにちは!全員のモバイルアプリに送信するSupernotifyのテストです

Home Assistant向けRhizomatics Open Source

HACS

  • AutoArm - 物理ボタン、在室状況、カレンダー等を使ってHome Assistantの警報コントロールパネルを自動的に設定/解除
  • Remote Logger - Home Assistant用OpenTelemetry(OTLP)およびSyslogイベントキャプチャ

Python / Docker

  • Anpr2MQTT - ファイルシステム経由でANPR/ALPRナンバープレートカメラとMQTTを連携
  • Updates2MQTT - DockerイメージのアップデートをMQTT経由で自動通知