README.md

Home Assistant Who Used the Door Sensor & Notifications

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.