2.2.6 • Public • Published


    Downloads Version
    verified-by-homebridge Homebridge Discord
    certified-hoobs-plugin hoobs-support

    With this plugin, you can create any number of fake switches that will start a timer when turned ON, when the delay time is reached the switch will automatically turn OFF and trigger a dedicated motion sensor for 3 seconds. This can be very useful for advanced automation with HomeKit scenes - when delayed actions are required.


    This plugin is Homebridge verified and HOOBS certified and can be easily installed and configured through their UI.

    If you don't use Homebridge UI or HOOBS, keep reading:

    • sudo npm install -g homebridge-delay-switch
    • Create an accessory in your config.json file
    • Restart homebridge

    Example config.json:

       "accessories": [
             "accessory": "DelaySwitch",
             "name": "DelaySwitch",
             "delay": 5000,
             "disableSensor": false,
             "startOnReboot": false
    Parameter Description Required Default type
    accessory always "DelaySwitch" - String
    name Name for your accessory - String
    delay Delay/Timer in milliseconds - Integer
    disableSensor Remove the Motion Sensor false Boolean
    startOnReboot When set to true, the switch will be turned ON and start the timer when HomeBridge restarts false Boolean

    Why do we need this plugin?

    The most common use of this plugin is to turn ON/OFF lights based on a motion/door sensor. This can be achieved by setting an automation to turn ON a light and the delay switch when motion is detected and turn OFF the light when the dedicated delay motion sensor is triggered (or delay switch is turned OFF).

    Another great example, when using smart wall switch (to turn ON) and RGB light bulb (to switch color) together on the same scene can cause no action on the bulb since the bulb might not even be ON when the command has been sent from homebridge. For that, we need to set an automation to change the bulb color a few seconds after the wall switch ON command.

    Also it can be use with any device that require a certain delay time from other devices (TV + RPi-Kodi / PC + SSH / etc...)

    How it works

    Basically, all you need to do is:

    1. Set the desired delay time in the config file (in milliseconds).
    2. The plugin will create one switch and one motion sensor for this plugin.
    3. Use this switch in any scene or automation.
    4. Set an automation to trigger when this switch is turned OFF or the motion sensor is triggers - "EVE" app is very recommended to set this automation.

    Why Add a Motion Sensor?

    A Motion sensor is created for each accessory in order to be able to cancel the timer and the attached automations. How does it works? You can set the automation to be triggered from the motion sensor instead of the switch OFF command and therefore you can turn OFF the switch and prevent the motion sensor from being triggered or any attached automations. If you have no use of the sensor you can remove it by adding "disableSensor": true to your config.

    Good to know

    • When manualy turning OFF the switch, the timer will stop and the motion sensor will NOT be triggered.

    • When the delay switch is getting ON command while it's already ON, the timer will restart and the motion sensor trigger will be delayed.

    Support homebridge-delay-switch

    homebridge-delay-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.


    npm i homebridge-delay-switch

    DownloadsWeekly Downloads






    Unpacked Size

    93.9 kB

    Total Files


    Last publish


    • nitaybz