Homebridge Delay Countdown Switch

A Homebridge accessory that acts as a delay switch with countdown timer functionality. The remaining time is displayed in the Apple Home app via a Fan accessory using the RotationSpeed characteristic as a percentage.

Features

• Switch with configurable delay and units (ms, s, m, h, d)
• Countdown timer updated every second
• Optional sensor (motion/contact/leak/occupancy) triggered at end of delay
• Visual timer display via Fan accessory in HomeKit

Installation

npm install -g homebridge-delay-countdown-switch

Example config.json

   "accessories": [
       {
           "accessory": "DelayCountdownSwitch",
           "name": "Delay Countdown Switch",
           "delay": 30,
           "delayUnit": "s",
           "sensorType": "motion",
           "flipSensorState": false,
           "disableSensor": false,
           "disableTimerDisplay": false,
           "debug": false,
           "startOnReboot": false
       }   
   ]

Parameter	Description	Required	Default	type
accessory	always "DelayCountdownSwitch"	✓	-	String
name	Name for your accessory	✓	-	String
delay	Delay/Timer time. 0 - timer disabled	✓	0	Integer
delayUnit	Delay Time Unit: ms / s / m / h / d	✓	"ms"	String
sensorType	The sensor type that will trigger when the time has ended (null for no sensor)		motion	String
flipSensorState	Flips the trigger sensor state (close/open, detected/not detected)		false	Boolean
disableSensor	Disables the associated sensor		false	Boolean
disableTimerDisplay	Disables the associated countdown fan		false	Boolean
startOnReboot	When set to true, the switch will be turned ON and start the timer when Homebridge restarts		false	Boolean

Support homebridge-delay-countdown-switch

homebridge-delay-countdown-switch is a free plugin under the MIT license. it was developed as a contribution to the homebridge/hoobs community with lots of love and thoughts. Creating and maintaining Homebridge plugins consume a lot of time and effort and if you would like to share your appreciation, feel free to "Star" or donate.

Acknowledgments

This plugin is a derived work based on homebridge-delay-switch by Nitay B, licensed under the MIT License.