This Homebridge plugin, together with a Shelly 1, can turn any old-fashioned two-wire doorbell into a HomeKit-compatible digital doorbell.
That means you can get a push notification when someone rings your doorbell and it doesn't matter if you are at home or on the road. You can also turn your doorbell on and off via HomeKit. This enables you to integrate the doorbell into numerous automations, e.g. to turn off the doorbell automatically in the evening. The integrated motion sensor makes it possible to trigger automations when the bell is pressed.
Requirements
- Shelly 1 (12 EUR)
- 12V DC Power Supply (12 EUR)
- Some wires and clamps
- Running Homebridge with this plugin installed
- If you are not qualified and licensed to do electrical work, you will need an electrician to help you.
If your existing doorbell is installed and switched like this, you can make it "smart" with this plugin and a Shelly 1:
Note: Shelly 1 supports a lot of voltages with both AC and DC on the relay, so even if your mechanical gong works with different voltages, there is a high chance that your environment is compatible with this plugin.
The special thing about this setup is that the Shelly 1 is powered by a 12V DC power supply, so we can safely connect it to the doorbell. Under no circumstances should higher voltages be applied to the thin doorbell wires.
The plugin sets the "Button Type" of the Shelly 1 to "Activation Switch". Thereby every short press of the doorbell activates the relay for a certain time so that the gong sounds completely. Under Timer -> AUTO OFF you should set a value in seconds, how long the gong should ring until the relay switches off again. For us, the value "0.3" has turned out to be a reasonable duration.
To trigger a digital gong you have to check "Enabled" on the Shelly under "I/O URL actions" -> "BUTTON SWITCHED ON URL" and set the url to the address of the Homebridge with the port of the plugin:
http://<homebridge-ip>:<shelly-doorbell-http-port>/
e.g. http://192.168.0.99:9053/
Warning: Please also turn off "Settings" -> "FACTORY RESET" -> "Enable factory reset from switch" so that no one can reset your shelly via the doorbell.
{
"name": "Shelly 1-Doorbells",
"doorbells": [
{
"shelly1IP": "192.168.0.100",
"digitalDoorbellWebhookPort": 9053
}
],
"platform": "ShellyDoorbell"
}| Setting | Example | Description |
|---|---|---|
| name | Doorbell | Name of the doorbell |
| shelly1IP* | 192.168.0.100 | IP of Shelly 1 |
| shelly1Username | admin | Username of Shelly 1 if login is restricted |
| shelly1Password | password | Password of Shelly 1 if login is restricted |
| digitalDoorbellWebhookPort* | 9053 | HTTP Port for the digital doorbell trigger server |
| digitalDoorbellName | Digital gong | Name for the digital doorbell |
| mechanicalDoorbellName | Mechanical gong | What is connected to the relay (slots I and O) of your Shelly? |
* Mandatory field.
Please reboot homebridge after setup is completed. Now you should see the doorbell in your default room. On the left side you can enable or disable the "digital gong" (Push Notifications, HomePod ringing, Automations,...). On the right side you can enable and disable your "mechanical gong". Both names can be changed via the configuration.
Note: Both switches work independently from each other.
Note: The authors of this plugin cannot assume any guarantees that the contents of this README are correct.