alexei.dolgolyov/haos-blueprints
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases Wiki Activity

[Claude] - Analyze Alarm Notification.yaml file designed to work as automation blueprint for Home Assistant OS. Refactor it improving overall code quality, fix obvious or critical bugs/mistakes, fix spelling if required and add comments that will make the code more easy to read and understand.

Browse Source
This commit is contained in:
Admin
2026-01-22 02:40:09 +03:00
parent f47e4efa81
commit 57ed3aaa63
1 changed files with 165 additions and 102 deletions
Download Patch File Download Diff File Expand all files Collapse all files

267
Common/Alarm Notification.yaml
View File

@@ -1,3 +1,17 @@
# =============================================================================
# Multi-Sensor Alarm & Notification Blueprint
# =============================================================================
# This blueprint monitors multiple binary sensors and triggers:
# - Push notifications when sensors activate
# - Alarm device control (with configurable melody and volume)
#
# Features:
# - Per-sensor custom notification messages
# - Debounce timer to prevent false alarms from brief sensor triggers
# - Optional melody and volume selection for alarm devices
# - Automatic alarm turn-off when all sensors clear
# =============================================================================
blueprint: blueprint:
name: "Custom: Multi-Sensor Alarm & Notification" name: "Custom: Multi-Sensor Alarm & Notification"
description: > description: >
@@ -5,128 +19,168 @@ blueprint:
change to "on". Supports per-sensor notification texts, optional alarm switch, change to "on". Supports per-sensor notification texts, optional alarm switch,
melody and volume selectors. melody and volume selectors.
domain: automation domain: automation
input: input:
# -------------------------------------------------------------------------
# Sensor Configuration
# -------------------------------------------------------------------------
devices: devices:
name: "Devices" name: "Devices"
collapsed: false collapsed: false
input: input:
binary_sensors: binary_sensors:
name: Binary Sensors name: Binary Sensors
description: List of sensors to monitor description: List of binary sensors or input booleans to monitor for alarm triggers
selector: selector:
entity: entity:
domain: domain:
- binary_sensor - binary_sensor
- input_boolean - input_boolean
multiple: true multiple: true
binary_sensors_decay_duration: binary_sensors_debounce_duration:
name: Binary Sensors Decay Duration (seconds) name: Sensor Debounce Duration
description: Minimum time a sensor must stay ON before considered active description: >
Minimum time a sensor must stay ON before triggering an alarm.
Helps prevent false alarms from brief or spurious sensor activations.
default: 5 default: 5
selector: selector:
number: number:
min: 0 min: 0
max: 30 max: 30
unit_of_measurement: "s" unit_of_measurement: seconds
# -------------------------------------------------------------------------
# Notification Configuration
# -------------------------------------------------------------------------
notification: notification:
name: "Notification" name: "Notification"
collapsed: false collapsed: false
input: input:
notify_target: notify_target:
name: Notification Target (optional) name: Notification Target (optional)
description: Device or service to send notifications description: >
default: null Notify entity to send notifications (e.g., notify.mobile_app_phone).
Leave empty to disable notifications.
default:
selector: selector:
entity: entity:
domain: notify domain: notify
notify_texts: notify_texts:
name: Notification Texts name: Notification Messages
description: One line per binary sensor, aligned with sensor list description: >
Custom message for each sensor (one per line, in same order as sensor list).
If a sensor doesn't have a corresponding message, a default will be used.
default: [] default: []
selector: selector:
text: text:
multiple: true multiple: true
# -------------------------------------------------------------------------
# Alarm Device Configuration
# -------------------------------------------------------------------------
alarm_group: alarm_group:
name: "Alarm" name: "Alarm"
collapsed: false collapsed: false
input: input:
alarm_switch: alarm_switch:
name: Alarm Switch (optional) name: Alarm Switch (optional)
description: Switch entity to toggle alarm device description: Switch entity to control the alarm device. Leave empty to disable alarm control.
default: null default: []
selector: selector:
entity: entity:
domain: switch domain: switch
multiple: false
melody_id:
name: Melody Identifier
description: Static melody identifier string
default: ""
selector:
text:
melody_select: melody_select:
name: Melody Selector (optional) name: Melody Selector (optional)
description: Input select entity pointing to melody list description: Select entity for choosing alarm melody/ringtone
default: "" default: []
selector: selector:
entity: entity:
domain: domain:
- input_select - input_select
- select - select
multiple: false
volume_id: melody_id:
name: Volume Identifier name: Melody Value
description: Static volume identifier string description: The melody/ringtone option to select when alarm triggers
default: "" default: ""
selector: selector:
text: text:
volume_select: volume_select:
name: Volume Selector (optional) name: Volume Selector (optional)
description: Input select entity pointing to volume list description: Select entity for choosing alarm volume level
default: "" default: []
selector: selector:
entity: entity:
domain: domain:
- input_select - input_select
- select - select
multiple: false
volume_id:
name: Volume Value
description: The volume level option to select when alarm triggers
default: ""
selector:
text:
# Restart mode ensures rapid sensor changes are handled cleanly
mode: restart mode: restart
# =============================================================================
# Triggers
# =============================================================================
trigger: trigger:
# Sensor turned ON and stayed on for the debounce duration
- platform: state - platform: state
entity_id: !input binary_sensors entity_id: !input binary_sensors
to: "on" to: "on"
for: for:
seconds: !input binary_sensors_decay_duration seconds: !input binary_sensors_debounce_duration
id: "sensor_on"
# Sensor turned OFF (for turning off alarm when all clear)
- platform: state - platform: state
entity_id: !input binary_sensors entity_id: !input binary_sensors
to: "off" to: "off"
id: "sensor_off"
action:
- variables:
binary_sensors: !input binary_sensors
notify_target: !input notify_target
melody_select: !input melody_select
volume_select: !input volume_select
alarm_switch: !input alarm_switch
enabled_sensors: "{{ binary_sensors | list | select('is_state','on') | list }}"
is_any_sensor_on: "{{ enabled_sensors | length != 0 }}"
are_all_sensors_off: "{{ enabled_sensors | length == 0 }}"
delay_between_setters_in_ms: 100
is_debug: false # =============================================================================
# Variables
# Debug info (log if required) # =============================================================================
variables:
# Input references
binary_sensors: !input binary_sensors
notify_target: !input notify_target
notify_texts: !input notify_texts
alarm_switch: !input alarm_switch
melody_select: !input melody_select
melody_id: !input melody_id
volume_select: !input volume_select
volume_id: !input volume_id
# Computed state values
enabled_sensors: "{{ binary_sensors | select('is_state', 'on') | list }}"
is_any_sensor_on: "{{ enabled_sensors | length > 0 }}"
# Small delay between setting melody/volume to ensure device processes each command
delay_between_commands_ms: 100
# Debug flag - set to true to enable persistent notifications for troubleshooting
is_debug: false
# =============================================================================
# Actions
# =============================================================================
action:
# ---------------------------------------------------------------------------
# Debug Logging (optional)
# ---------------------------------------------------------------------------
- choose: - choose:
- conditions: - conditions:
- condition: template - condition: template
@@ -134,87 +188,96 @@ action:
sequence: sequence:
- service: persistent_notification.create - service: persistent_notification.create
data: data:
title: "Debug Info" title: "Alarm Notification Debug"
message: > message: >
binary_sensors = {{ binary_sensors }}, Trigger: {{ trigger.id }}
enabled_sensors = {{ enabled_sensors }} Entity: {{ trigger.entity_id }}
Sensors: {{ binary_sensors }}
Active: {{ enabled_sensors }}
Any On: {{ is_any_sensor_on }}
# ---------------------------------------------------------------------------
# Send Notification (when sensor turns ON)
# ---------------------------------------------------------------------------
- choose: - choose:
- conditions: - conditions:
- condition: template - condition: template
# Only notify if a sensor is on and notification target is configured
value_template: "{{ is_any_sensor_on and notify_target is not none }}" value_template: "{{ is_any_sensor_on and notify_target is not none }}"
sequence: sequence:
- variables: - variables:
notify_texts: !input notify_texts # Get the sensor that triggered this automation
messages: "{{ notify_texts | list }}"
sensor: "{{ trigger.entity_id }}" sensor: "{{ trigger.entity_id }}"
idx: "{{ (binary_sensors | list).index(sensor) }}" # Find index of this sensor in the list
sensor_index: >
{% set idx = binary_sensors | list %}
{{ idx.index(sensor) if sensor in idx else -1 }}
# Get custom message or use default
message: > message: >
{% if messages | length > idx %} {% set messages = notify_texts | list %}
{{ messages[idx] }} {% if sensor_index >= 0 and sensor_index < messages | length %}
{{ messages[sensor_index] }}
{% else %} {% else %}
Sensor {{ sensor }} triggered Alarm: {{ state_attr(sensor, 'friendly_name') | default(sensor) }} triggered
{% endif %} {% endif %}
- service: notify.send_message - service: notify.send_message
target: target:
entity_id: !input notify_target entity_id: "{{ notify_target }}"
data: data:
message: "{{ message }}" message: "{{ message }}"
# ---------------------------------------------------------------------------
# Alarm Device Control
# ---------------------------------------------------------------------------
- choose: - choose:
- conditions: - conditions:
- condition: template - condition: template
value_template: "{{ alarm_switch is not none }}" # Only control alarm if alarm switch is configured
value_template: "{{ alarm_switch | length > 0 }}"
sequence: sequence:
- variables: # Set melody (if configured)
melody_select: !input melody_select
melody_id: !input melody_id
volume_select: !input volume_select
volume_id: !input volume_id
- choose: - choose:
- conditions: - conditions:
- condition: template - condition: template
value_template: "{{ melody_select is not none }}" value_template: "{{ melody_select | length > 0 and melody_id | length > 0 }}"
sequence: sequence:
- service: select.select_option - service: select.select_option
target: target:
entity_id: !input melody_select entity_id: "{{ melody_select }}"
data: data:
option: !input melody_id option: "{{ melody_id }}"
- delay: - delay:
milliseconds: "{{ delay_between_setters_in_ms }}" milliseconds: "{{ delay_between_commands_ms }}"
# Set volume (if configured)
- choose: - choose:
- conditions: - conditions:
- condition: template - condition: template
value_template: "{{ volume_select is not none }}" value_template: "{{ volume_select | length > 0 and volume_id | length > 0 }}"
sequence: sequence:
- service: select.select_option - service: select.select_option
target: target:
entity_id: !input volume_select entity_id: "{{ volume_select }}"
data: data:
option: !input volume_id option: "{{ volume_id }}"
- delay: - delay:
milliseconds: "{{ delay_between_setters_in_ms }}" milliseconds: "{{ delay_between_commands_ms }}"
# Turn alarm ON or OFF based on sensor state
- choose: - choose:
- conditions: # Any sensor active -> turn alarm ON
- conditions:
- condition: template - condition: template
value_template: "{{ is_any_sensor_on }}" value_template: "{{ is_any_sensor_on }}"
sequence: sequence:
- service: switch.turn_on - service: switch.turn_on
target: target:
entity_id: !input alarm_switch entity_id: "{{ alarm_switch }}"
- conditions:
- condition: template
value_template: "{{ are_all_sensors_off }}"
sequence:
- service: switch.turn_off
target:
entity_id: !input alarm_switch
# All sensors clear -> turn alarm OFF
default:
- service: switch.turn_off
target:
entity_id: "{{ alarm_switch }}"