• Stars
    star
    159
  • Rank 235,916 (Top 5 %)
  • Language
  • Created over 4 years ago
  • Updated 9 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Video & audio doorbell for Home Assistant: ESP32 Cam, DFPlayer Mini, ESPHome

DIY Video Doorbell with Voice Response

Based on ESP32 Camera & DFPlayer Mini with Home Assistant and ESPHome

This has been a long running project to create a cloudless video doorbell with notifications & voice responses. It was important to me that the doorbell itself looked as professional as possible.

Doorbell & notifications

Features

Click for DOORBELL DEMO VIDEO

  • Plays audible ("ding dong") and visual (blinking LED) feedback when some presses doorbell button
  • Calls service to play doorbell chimes downstairs and upstairs in the house
  • Sends actionable notifications with a camera snapshot to my and my partner's phones. Actions initiate pre-recorded voice responses which are player through the doorbell itself:
    • "Someone is coming to the door."
    • "Sorry. No one can come to the door right now."
    • "Sorry. No one can come to the door right now. Please drop the parcel behind the date at the right of the house."
  • Pop up a live view from the doorbell camera on two wall-mounted tablets in the house, with the same voice response options plus a button to play an alarm sound on a loop until stopped. This same view also opens the Home Assistant Companion App on our phones if we tap the notification.

Click for WALL MOUNTED POP-UP DEMO VIDEO

Building the doorbell

The design of the doorbell is very specific to my need where the doorbell had to fit on the narrow doorframe and be positioned at an angle. On the plus side, it's well protected from rain, so I didn't have to make it waterproof.

If you have the luxury of space, consider designing your own housing that is wider. Internal assembly is very tight in this design.

I've wired a 5V (actually USB) cable through the doorframe so that the doorbell has constant power. The cable is not visible inside the house.

Mechanical parts

Mechanical parts

Electrical/electromechanical parts

The electrical design is straightforward. The difficult bit was to fit everything into the small amount of space I had available.

The reason for a long lead camera module is that the camera image is rotated at 90deg when the ESP32-Cam is in a portrait orientation. Using a long lead camera module and mounting the ESP32-Cam board backwards enables making a gentle 90deg turn in the flex between the board and the module.

You could instead use card-mod to rotate the image on a Lovelace dashboard. (Thanks to @solomos for the tip on the Home Assistant Community forum.) However, the image would still be rotated if you used it in other ways such as sending it in a notification.)

Electrical

Software

The system is based on Home Assistant with ESPHome. It uses a number of automations and scripts. I think that I've included all of the pieces in this repository. If not, please raise an issue.

Dependencies

Doorbell chimes

There are many ways that you could implement doorbell chimes. In past iterations, I've used Sonos speakers, Raspberry Pis with speakers attached and Google Home Minis. I'm finally happy with the current solution which is based on an ESP8266 Wemos D1 Mini paired with a DFPlayer Mini and connected to some amplified PC speakers, all running with ESPHome.

Here's a pic. It's far from elegant looking, but both chimes are hidden from view in the house. And, it can go very loud with the amplified speakers. If you wanted to make something similar but self-contained, you could use a speaker similar to the one in the doorbell itself and put it together in one housing with the electronics.

Chime overview

An ESPHome configuration is in the repository, and here's a wiring diagram with options for amplified speakers via a 3.5mm jack or direct conenction to a speaker.

Chime wiring

Audio files, DFPlayer Mini & the SD card

You can use any MP3 file for the doorbell chime. Orange Free Sounds is a good source.

There are many ways to generate MP3 voice response files for the doorbell if you want to change them. One of the simplest is to use an app such as MyVoice for Android.

Here is a good overview of the DFPlayer Mini that includes tips to prepare the SD card. Note that although the guide shows Linux commands, you can use any OS as long as you can format FAT32.

In short:

  1. Format the SD card as FAT32
  2. Rename the files following the example: 001.mp3, 002.mp3, etc. Keep track of which files are which number so that you can refer to them correctly in the ESPHome code later.
  3. Copy the files to the card in the order of the numbering. So, for example, copy 001.MP3 to the card first.

To do

  • Add video recording and snapshot archiving