Add BIOMETRICS to your Smart Home – Fingerprint Sensor with Home Assistant

In this video we are taking a look how to build a fingerprint sensor or scanner with Home Assistant that you can use to add biometric scanning to your Smart Home. I’ll show you step by step how to build this sensor, how to program it and how to integrate it with Home Assistant, as well as how to remotely add and remove fingerprints.

This fingerprint sensor is built on MQTT meaning you should be able to use it with any platform that supports MQTT, be it OpenHAB, Domoticz, Hubitat etc.

Parts List:
Wemos D1 Mini:

Fingerprint Sensor 1:

Fingerprint Sensor 2:



3D Printed Enclosure:

If you’d like to support me and future projects:

Buy Me a Coffee:

Written Article:

Everything Smart Home Community Discord:

Twitter: (@EverySmartHome)

#homeassistant #smarthome


Some of the links above are affiliate links, where I earn a small commission if you click on the link and purchase an item. You are not obligated to do so, but it does help fund these videos in hopes of bringing value to you!

License: Creative Commons — CC BY-SA 3.0

20 Replies to “Add BIOMETRICS to your Smart Home – Fingerprint Sensor with Home Assistant”

  1. Connor Thompson

    So I add my fingerprint and it works great. I add my friends fingerprint and it also works. I try scanning my finger after adding my friends and it fails, it says it found a match but instead of outputting my name it outputs "Unavailable".

  2. Victor M.

    Amazing project, I just built it following this video and it is amazing how simple it is with the clear instructions, thanks!!
    I just found couple of small improvements, one is you can add this to the fingerprint sensor in Home Assistant so you are aware of the status of the sensor (available/unavailable):
    availability_topic: "fingerprint/available"
    payload_available: "online"
    payload_not_available: "offline"
    I also removed the "/" at the beginning of the topic to follow the standard of other devices

  3. simona tornaghi

    Hi. Good job. I have followed everything but I have a problem with the name that I cannot enter. Always unknown without being able to change it. I saw in the video that you were initially like that too. What did you do? Thank you

  4. Aiyman Khan

    Quick question, is it possible to trigger a GPIO pin on the esp8266 after the fingerprint is recognized by Home assistant? Need this to unlock a 12v solenoid. Also you mentioned that you will do in another video about how to turn the led off when not in use.
    By the way thanks alot for your hard work. My project worked.

  5. William Jacoby

    Don't understand Blueprints, but could this this be turned into a standalone ALARM blueprint. Seems like it would be a good candidate for this, as it could be part of the building blocks of a modular security system.

  6. Eduardo Ramos

    Not related to the fingerprint, but what device do you use to make those intermitents beeps while not authenticated with fingerprint? Is it alexa? If so, how did you do it? Thanks, your videos are awesome.

  7. Leland Clayton

    Just a FYI, you want to learn in at least two or a maximum three finger prints. All it takes is something to disrupt the finger print and becomes useless such as a blister, blood blister, cut, or even the extreme loosing a finger.

  8. Peter Ebenezer

    Great tutorial! The LED control would be a great feature to add.
    For example if it's not expecting a fingerprint, turn off the LED so its not shining up the wall, but enable it when you need to use it.
    (for example, while the system is armed it could be on, off when not)

    I am considering making one for my daughter (shes 2) to play a song for her in the day time, or turn on her lights after sunset (as she cant reach the switch!) – the green light may tick the box for a nightlight for her too!

Leave a Reply

Your email address will not be published. Required fields are marked *