Fingerprint Doorbell for Smart/Electronic Locks and Garage Doors

Share your Projects!
1

Hey everyone,

We just wrapped up a new project at SmartHomeGeeks: a fingerprint-powered smart doorbell that runs entirely on ESPHome and integrates natively with Home Assistant.

fingerprint_doorbell_home_assistant_dashboard-3
fingerprint_doorbell_home_assistant_dashboard-31042×726 20.4 KB

Highlights:

  • Unlocks your smart lock with a recognized fingerprint
  • Rings the chime for unknown visitors — or stays silent in Silent Mode
  • Custom modes: Open House, Scheduled Access, 2FA via BLE/Wi-Fi presence
  • Full fingerprint user management from Home Assistant
  • LED feedback animations for ring/access/enrollment
  • Fully local – no cloud, no latency, no privacy concerns

Parts cost ~€25, and we’ve shared wiring, YAML, and mounting options.

:open_book: Full write-up:
:point_right: Fingerprint Doorbell for Smart/Electronic Locks and Garage Doors

Let us know what you think or how you’d improve it!
– Freddie & Jeroen

8 Likes
2

Hi Guys, looks really good. A question, can this be adapted to a wemos d1 mini esp8266 board if you just want the grow 503 part?

3

No, not an ESP8266, but you can use any ESP32 board if you like.

1 Like
4

Cheers, got one and this works much better than previous setup with wemos d1 mini.

2 Likes
5

hello how to program this module?

6

It is based on ESPHome. See https://esphome.io/

7

hi my state sensor.fingerprint_doorbell_state doesnt change if the finger is in state “Fingerprint matched” matched. Then the automation doesnt trigger. How can i change that? Thanks.
I can use another finger who isnt matched and then the right finger but its not so good. I thought that the state change back if the finger is recognized but it doesnt.

8

I’ll be working on a new version in the coming weeks, as I plan to integrate this project across multiple entrances.

9

Can you give me a hint how i can change the yaml code for the esp32 to reset the state “fingerprint matched” automatically. I guess ist will be only one line to change but i didnt know the special yaml commnands to reset the state in HA. I have built a second condition with BLE and the door opened suddenly without the fingerprint because the state desnt reset automaticly. Thank you very much for the hint.

10

Nice job. Im doing some research to see if I can use a PoE ESP32 board (this one) to do the job. I guess I can, but I have no clue how I need to wire them (see picture for board info) and to edit your config to make everything work.

Ps. I dont need the chime and doorbell as I have that already settled.

  # GPIO Pins
  uart_tx_pin: GPIO25        # R503 green (or purple) wire
  uart_rx_pin: GPIO27        # R503 yellow wire
  sensing_pin: GPIO32        # R503 blue wire
  lock_relay_pin: GPIO16
  chime_relay_pin: GPIO17
  door_sensor_pin: GPIO18

Screenshot 2025-11-21 at 21.47.51
Screenshot 2025-11-21 at 21.47.511920×1174 161 KB

@fleeman :slightly_smiling_face:

Happy to see if someone can guide me through :slight_smile: