Frigate 0.10 Notifications

frigate_0.10_notification.yaml

blueprint:
  name: Frigate Notification (0.10.0) (toddrob99)
  description: |
    ## Frigate Mobile App Notification

    This blueprint will send a notification to your device when a Frigate event for the selected camera is fired. The notification will initially include the thumbnail of the detection, but include an actionable notification allowing you to view the clip and snapshot.

    With this blueprint, you may send the notification to multiple devices by leaving "Device" blank and instead use a [notification group][1].

    ### Software Version Requirements
    Minimum Home Assistant Version: 2022.2
    Minimum Frigate Version: 0.10.0 Beta 10
    Minimum Frigate Integration Version: 2.2.0
    Minimum iOS Version: 15.0

    ### Required entities:
      - Frigate Camera Name
      - Mobile App Device **or** the name of a Notification Group

    ### Optional features:
      - You can optionally send the notification as a critical alert.
      - You can choose whether or not to update the notification with new thumbnails as they become available.
      - You can limit notifications to objects entering pre-defined [zones][2] in Frigate.
      - You can specify which [zones][2] to be notified about. This must be a list (e.g.):
        ```yaml
        - backyard
        ```
      - You can specify what type of [objects][3] to be notified about. This must be a list (e.g.):
        ```yaml
        - person
        - car
        ```
      - You can disable notifications if a presence entity or group is "home".
      - You can configure a cooldown for the camera to reduce the number of notifications when back-to-back events occur.
      - You can silence future notifications for a defined amount of time through actionable notifications. This is helpful in situations where you know you will be triggering detections for an extended period of time. i.e. kids playing outside.
      - You can set a loitering timer to notify you of stationary objects that remain for a set period of time.

    [1]: https://companion.home-assistant.io/docs/notifications/notifications-basic#sending-notifications-to-multiple-devices
    [2]: https://blakeblackshear.github.io/frigate/configuration/zones
    [3]: https://blakeblackshear.github.io/frigate/configuration/objects

  domain: automation
  source_url: https://gist.github.com/toddrob99/76e0da35b20caa5dcdcf05b6d6f4bb4a
  input:
    camera:
      name: Frigate Camera
      description: The name of the camera as defined in your frigate configuration.
    critical:
      name: (Optional) Critical Notification
      description: Send as a critical notification to the mobile device.
      default: false
      selector:
        boolean:
    update_thumbnail:
      name: (Optional) Update Thumbnail
      description: Update notification if a new "better" thumbnail is available.
      default: false
      selector:
        boolean:
    zone_filter:
      name: (Optional) Zone Filter
      description: Only notify if object has entered a defined zone.
      default: false
      selector:
        boolean:
    zones:
      name: (Optional) Trigger Zones
      description: A list (-) of zones you wish to recieve notifications for.
      default: []
      selector:
        object:
    labels:
      name: (Optional) Trigger Objects
      description: A list (-) of objects you wish to recieve notifications for.
      default: []
      selector:
        object:
    presence_filter:
      name: (Optional) Presence Filter
      description: Only notify if selected presence entity is not "home".
      default: ""
      selector:
        entity:
    cooldown:
      name: (Optional) Cooldown
      description: Delay before sending another notification for this camera after the last event.
      default: 30
      selector:
        number:
          max: 300
          min: 0
          unit_of_measurement: seconds
    silence_timer:
      name: (Optional) Silence New Object Notifications
      description: >
        How long to silence notifications for this camera when requested as part of the
        actionable notification. Note: This only applies to new objects. Existing tracked
        objects 
      default: 30
      selector:
        number:
          max: 300
          min: 0
          unit_of_measurement: minutes
    loiter_timer:
      name: (Optional) Loitering Notifications
      description: >
        Sends new loitering notification if a stationary object is detected for longer
        than the specified time. 0 is off and will not send notifications.
      default: 0
      selector:
        number:
          max: 300
          min: 0
          unit_of_measurement: minutes

mode: parallel
trigger_variables:
    camera: !input camera
trigger:
  - platform: event
    event_type: mobile_app_notification_action
    event_data:
      action: 'silence-{{ camera }}'
    id: silence
  - platform: mqtt
    topic: frigate/events
    payload: "{{ camera }}/new"
    value_template: "{{ value_json['after']['camera'] }}/{{ value_json['type']}}"
    id: frigate-event
variables:
  camera: !input camera
  critical: !input critical
  update_thumbnail: !input update_thumbnail
  zone_only: !input zone_filter
  input_zones: !input zones
  zones: "{{ input_zones | list }}"
  input_labels: !input labels
  labels: "{{ input_labels | list }}"
  presence_entity: !input presence_filter
  cooldown: !input cooldown
  loiter_timer: !input loiter_timer
  fps_value: "{{ states('sensor.' + camera + '_camera_fps') }}"
  fps: "{{ fps_value|int if is_number(fps_value) else 5 }}"
action:
  - alias: "Silence New Object Notifications"
    if:
      - condition: trigger
        id: silence
    then:
      - service: automation.turn_off
        target:
          entity_id: "{{ this.entity_id }}"
        data:
          stop_actions: false
      - delay:
          minutes: !input silence_timer
      - service: automation.turn_on
        target:
          entity_id: "{{ this.entity_id }}"
  - alias: "Frigate Event"
    if:
      - condition: trigger
        id: "frigate-event"
      - "{{ is_state(this.entity_id, 'on') }}"
      - "{{ not this.attributes.last_triggered or (now() - this.attributes.last_triggered).seconds > cooldown }}"
    then:
      - variables:
          id: "{{ trigger.payload_json['after']['id'] }}"
          label: "{{ trigger.payload_json['after']['label'] }}"
          # Dynamic Variables per event
          initial_entered_zones: "{{ trigger.payload_json['after']['entered_zones'] }}"
      - alias: "Notifications enabled for object label"
        condition: template
        value_template: "{{ not labels|length or label in labels }}"
      - alias: "Notify on new object"
        if:
          - "{{ not zone_only or initial_entered_zones|length > 0 }}"
          - "{{ not zones|length or zones|select('in', initial_entered_zones)|list|length > 0 }}"
        then:
          - service: script.send_frigate_notification
            data:
              camera: "{{ camera }}"
              id: "{{ id }}"
              label: "{{ label }}"
              critical: "{{ critical }}"
      - repeat:
          sequence:
            - wait_for_trigger:
              - platform: mqtt
                topic: frigate/events
                payload: "{{ id }}"
                value_template: "{{ value_json['after']['id'] }}"
              timeout:
                minutes: 2
              continue_on_timeout: false
            - variables:
                event: "{{ wait.trigger.payload_json }}"
                loitering: "{{ loiter_timer and event['before']['motionless_count']/fps/60 < loiter_timer and event['after']['motionless_count']/fps/60 >= loiter_timer }}"
                new_snapshot: "{{ update_thumbnail and event['before']['snapshot_time'] != event['after']['snapshot_time'] }}"
                presence_changed: "{{ presence_entity != '' and as_datetime(event['before']['frame_time']) < states[presence_entity].last_changed }}"
                last_zones: "{{ event['before']['entered_zones'] }}"
                entered_zones: "{{ event['after']['entered_zones'] }}"
                check_zone_filter: "{{ (not zones|length or zones|select('in', entered_zones)|list|length > 0) and (not zone_only or entered_zones|length > 0) }}"
                stationary_moved: "{{ event['after']['position_changes'] > event['before']['position_changes'] }}"
                zone_only_changed: "{{ zone_only and (entered_zones|length > 0 and not last_zones|length) }}"
                entered_zones_changed: "{{ zones|length > 0 and (zones|select('in', entered_zones)|list|length > 0 and not zones|select('in', last_zones)|list|length) }}"
                update: "{{ new_snapshot and not loitering and not presence_changed and not zone_only_changed and not entered_zones_changed }}"
            - alias: "Notify on loitering or significant change"
              if:
                - "{{ ((entered_zones_changed or check_zone_filter) or (check_zone_filter and (new_snapshot or stationary_moved)) or loitering) and update }}"
              then:
                - service: script.send_frigate_notification
                  data:
                    camera: "{{ camera }}"
                    id: "{{ id }}"
                    label: "{{ label }}"
                    loitering: "{{ loitering }}"
                    critical: "{{ critical }}"
                    update: "{{ update }}"
          until: "{{ not wait.trigger or wait.trigger.payload_json['type'] == 'end' }}"