homebridge-switch-button
v1.0.3
Published
Homebridge button and light switches for simple automations in Homekit. https://github.com/sant3001/homebridge-switch-button
Downloads
27
Maintainers
Readme
Homebridge Switch Button
With this plugin you can create simple automations in Homekit for a light connected with a physical button. It creates two fake switches that can be linked to your physical button and your physical light correspondingly.
The button switch will start a timer when turned ON
. When the delay time is reached the switch will automatically turn OFF
and it will flip the state of the light switch from ON
to OFF
, and from OFF
to ON
accordingly.
By adding this plugin you can avoid converting your automation to Shorcuts and doing if conditions that are not always reliable.
Configuration
{
"name": "My Switch Light",
"delay": 500,
"switchName": "Button Switch",
"lightName": "Light Switch",
"accessory": "HomebridgeSwitchButton"
}
Homekit automations
- Link the
Single Press
action of your physical button to turn the button switch toON
. - Create an automation to turn
ON
your physical light when the light switch is turnedON
. - Create a second automation to turn
OFF
your physical light when the light switch is turnedOFF
.
Vualá! You're all set.
PRO tips - Recommended Home Configuration
If you regularly use the Home app or Siri to turn on your lights, it's also best to replace the physical light with the virtual light so that the ON/OFF
state is always managed by the virtual light. You can do so following these steps:
- In the Home app, go to the light switch configuration and add it to the same room as the physical light.
- Open to the room you added the light switch to.
- Go to your physical light configuration. Toggle
OFF
"Add to Home View", and toggleOFF
"Include in Favorites". Rename this light to something different from the original name, i.e. "Physical Guest Room Light" - Go to your light switch configuration and click in "Show as Separate Tiles" and close it. Now the virtual light and virtual switch should be displayed as separate tiles.
- Go to the virtual light configuration. Toggle
ON
"Add to Home View" and (optionally) toggleON
"Include in Favorites". Rename this light to the original name of your physical light, i.e. "Guest Room Light".
You should now see the virtual light in the Home dashboard.