shub39 / fingerprint_attendance

Fingerprint attendance system with Raspberry Pi

Biometric Attendance system with raspberry pi 4

A simple attendance system with raspberry pi 4 and fingerprint scanners. It has the following features

1. Enroll Student data and store details like name, roll, subjects, etc
2. Take attendance and store attendance data in a csv file format
3. Share the data over network with teachers Using Syncthing

QuickStart

1. Download copy of the code or clone it to desired path in the raspberry pi
2. Use Crontab to run "main.py" at startup.
3. Connect the peripherals properly (pinouts can be found easily on the web)
4. Install the below mentioned modules
5. To enroll students disable crontab, connect to the raspberry pi through VNC Viewer or HDMI and run "admin.py". You will require a keyboard to enroll student details.

Current Module Requirements

These two modules need to be installed via pip. I recommend installing them directly using --break-system-packages as setting up a virtual environment leads to problems while trying to autorun the program

1. Pyfingerprint Module

pip install pyfingerprint --break-system-packages

2. Luma Core

pip install luma.core --break-system-packages

How To Autorun?

As mentioned above I am using Crontab to autorun the main.py at startup. I am using a bash script because it just works. Make a new file in the home directory named start.sh and enter the following.

#!/bin/bash
cd PATH/TO/FOLDER # path to the directory where main.py is located
python3 main.py 

grant executable permission to the script

chmod +x start.sh

Open terminal and enter

crontab -e

select your preffered text editor and go to the last line and add

@reboot ~/start.sh

save and exit. Now the program should run automatically from the next boot

Current Devices Used

1. Raspberry Pi 4 Model B
2. R307 fingerprint scanner
3. ttl to USB converter
4. I2C OLED Display module
5. USB C charging cable and power adapter
6. Jumper wires

Showcase