https://github.com/shub39/biometric-attendance

Biometric attendance system with Raspberry Pi
https://github.com/shub39/biometric-attendance

college-project python3 r307 raspberry-pi-4 syncthing

Last synced: 5 months ago
JSON representation

Biometric attendance system with Raspberry Pi

Host: GitHub
URL: https://github.com/shub39/biometric-attendance
Owner: shub39
License: gpl-3.0
Archived: true
Created: 2023-12-28T03:26:21.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2024-09-14T08:26:30.000Z (9 months ago)
Last Synced: 2025-01-12T15:48:33.380Z (5 months ago)
Topics: college-project, python3, r307, raspberry-pi-4, syncthing
Language: Python
Homepage:
Size: 71.3 KB
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# 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
```bash
pip install pyfingerprint --break-system-packages
```
2. Luma Core
```bash
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.
```bash
#!/bin/bash
cd PATH/TO/FOLDER # path to the directory where main.py is located
python3 main.py
```
grant executable permission to the script
```bash
chmod +x start.sh
```
Open terminal and enter
```bash
crontab -e
```
select your preffered text editor and go to the last line and add
```bash
@reboot ~/start.sh
```
save and exit. Now the program should run automatically from the next boot