Skip to content

Latest commit

 

History

History
86 lines (71 loc) · 4.36 KB

README.md

File metadata and controls

86 lines (71 loc) · 4.36 KB

Home Assistant Who Used the Door Sensor & Notifications

hacs_badge
Buy Me A Coffee

Who Used the Door app for AppDaemon.

This creates 2 sensors that peel the last opened and last closed timestamp out of a binary_sensor/sensor door. This also will notify users of the following events:

  • Who used the door with a time and date stamp. This includes intruder tracking. e.g. if an unknown person opens the door, a listener will be created and listen for a known person to show up. If the known person shows up within 90 seconds, a message will be sent saying that the person who used the door is {name}.
  • If the door is open for more than {duration}.
  • How many times the door has been opened over the past {quiet_window} period. (to keep the messages down)

I'm reluctant to share this app because it can be very annoying. This is something that I wrote many years ago and never bothered changing the functionality. I am open to suggestions for making this less notification heavy.

Requirements

This requires the People Tracker appdaemon app.

Installation

Download the who_used_the_door directory from inside the apps directory to your local apps directory, then add the configuration to enable the hacs module.

Example App configuration

Basic, No notifications

# Creates 2 sensors sensor.main_door_last_opened, and  sensor.main_door_last_closed
main_door:
  module: who_used_the_door
  class: WhoUsedTheDoor
  sensor: sensor.main_door
  people_tracker: sensor.people_tracker
  message_name: Main Door

Advanced

# Creates all notifications
main_door:
  module: who_used_the_door
  class: WhoUsedTheDoor
  sensor: sensor.main_door
  people_tracker: sensor.people_tracker
  message_name: Main Door
  notify:
    door_ajar:
      timestamp: '%-I:%M:%S %p'
      duration: 120
      notify:
      - notify.petro
    door_open:
      timestamp: '%-I:%M:%S %p'
      quiet_window: 120
      notify:
      - notify.petro

App Configuration

key optional type default description
module False string who_used_the_door The module name of the app.
class False string WhoUsedTheDoor The name of the Class.
sensor False string entity_id of the door sensor.
people_tracker False string entity_id of the people tracker sensor.
message_name True string <sensor.attributes.friendly_name> Name of the door for your notifications.
open_name True string <sensor.attributes.friendly_name> Last Opened Name of the Last Opened sensor.
close_name True string <sensor.attributes.friendly_name> Last Closed Name of the Last Closed sensor.
notify True map door_ajar | door_open open or ajar notification map, see below.
log_level True 'INFO' | 'DEBUG' 'INFO' Switches log level.

Ajar Notification Map Configuration

key optional type default description
notify False list list of notify entity_ids.
title True string Title of the notifications.
timestamp True string Timestamp format for messages. Use '%-I:%M:%S %p' for 12 hr notation and '%-H:%M:%S' for 24 hr notation.
duration True int 30 If the door is open longer than this time, send a message.

Open Notification Map Configuration

key optional type default description
notify False list list of notify entity_ids.
title True string Title of the notifications.
timestamp True string Timestamp format for messages. Use '%-I:%M:%S %p' for 12 hr notation and '%-H:%M:%S' for 24 hr notation.
quiet_window True int 0 After the first door open, a quiet window will activate. During this window, all door open messages will be suppressed. After the window is met, a final message will appear with a count of door opens. 0 = no quiet window. I created this because I found that we would open the door in bursts and we didn't want 900000000 messages.