{"id":15172758,"url":"https://github.com/shub39/biometric-attendance","last_synced_at":"2025-10-01T09:30:35.435Z","repository":{"id":214421376,"uuid":"736485654","full_name":"shub39/biometric-attendance","owner":"shub39","description":"Biometric attendance system with Raspberry Pi","archived":true,"fork":false,"pushed_at":"2024-09-14T08:26:30.000Z","size":73,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-12T15:48:33.380Z","etag":null,"topics":["college-project","python3","r307","raspberry-pi-4","syncthing"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/shub39.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-12-28T03:26:21.000Z","updated_at":"2024-09-14T08:43:51.000Z","dependencies_parsed_at":"2024-08-23T15:38:36.783Z","dependency_job_id":null,"html_url":"https://github.com/shub39/biometric-attendance","commit_stats":null,"previous_names":["shub39/fingerprint_attendance","shub39/biometric-attendance"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shub39%2Fbiometric-attendance","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shub39%2Fbiometric-attendance/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shub39%2Fbiometric-attendance/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shub39%2Fbiometric-attendance/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shub39","download_url":"https://codeload.github.com/shub39/biometric-attendance/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234845370,"owners_count":18895746,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["college-project","python3","r307","raspberry-pi-4","syncthing"],"created_at":"2024-09-27T10:04:14.573Z","updated_at":"2025-10-01T09:30:35.097Z","avatar_url":"https://github.com/shub39.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Biometric Attendance system with raspberry pi 4\n\u003cimg src=\"https://cdn.jsdelivr.net/gh/devicons/devicon@latest/icons/raspberrypi/raspberrypi-original.svg\" height=\"100\" width=\"100\" align=\"right\"/\u003e\n\u003cimg src=\"https://cdn.jsdelivr.net/gh/devicons/devicon@latest/icons/python/python-original.svg\" height=\"100\" width=\"100\" align=\"right\"/\u003e\n\nA simple attendance system with raspberry pi 4 and fingerprint scanners. It has the following features\n\n1. Enroll Student data and store details like name, roll, subjects, etc\n2. Take attendance and store attendance data in a csv file format\n3. Share the data over network with teachers \u003ca href=\"https://syncthing.net/\"\u003eUsing Syncthing\u003c/a\u003e\n\n\n# QuickStart\n\n1. Download copy of the code or clone it to desired path in the raspberry pi\n2. Use \u003ca href=\"https://linuxhandbook.com/crontab/\"\u003eCrontab\u003c/a\u003e to run *\"main.py\"* at startup.\n3. Connect the peripherals properly (pinouts can be found easily on the web)\n4. Install the below mentioned modules\n5. To enroll students disable crontab, connect to the raspberry pi through \u003ca href=\"https://www.realvnc.com/en/connect/download/viewer/\"\u003eVNC Viewer \u003c/a\u003e or HDMI and run *\"admin.py\"*. You will require a keyboard to enroll student details.\n\n\n# Current Module Requirements\nThese 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\n1. \u003ca href=\"https://pypi.org/project/pyfingerprint/\"\u003ePyfingerprint Module\u003c/a\u003e\n```bash\npip install pyfingerprint --break-system-packages\n```\n2. \u003ca href=\"https://pypi.org/project/luma.core/\"\u003eLuma Core\u003c/a\u003e\n```bash\npip install luma.core --break-system-packages\n```\n# How To Autorun?\nAs mentioned above I am using \u003ca href=\"https://linuxhandbook.com/crontab/\"\u003eCrontab\u003c/a\u003e 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.\n```bash\n#!/bin/bash\ncd PATH/TO/FOLDER # path to the directory where main.py is located\npython3 main.py \n```\ngrant executable permission to the script\n```bash\nchmod +x start.sh\n```\nOpen terminal and enter\n```bash\ncrontab -e\n```\nselect your preffered text editor and go to the last line and add\n```bash\n@reboot ~/start.sh\n```\nsave and exit. Now the program should run automatically from the next boot\n\n# Current Devices Used\n\n\u003col\u003e\n    \u003cli\u003e\u003ca href=\"https://robu.in/product/raspberry-pi-4-model-b-with-1-gb-ram/\"\u003eRaspberry Pi 4 Model B\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://robu.in/product/r307-optical-fingerprint-reader-module-sensor/\"\u003eR307 fingerprint scanner\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://robu.in/product/pl2303-pl2303hx-usb-ttl-module-5-pin/\"\u003ettl to USB converter\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://robu.in/product/0-96-inch-i2c-iic-oled-lcd-module-4pin-with-vcc-gnd-blue/\"\u003eI2C OLED Display module\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003eUSB C charging cable and power adapter\u003c/li\u003e\n    \u003cli\u003eJumper wires\u003c/li\u003e\n\u003c/ol\u003e\n\n# Showcase\n\n![image](https://github.com/shub39/fingerprint_attendance/assets/143277026/77be40a7-a433-4962-ad2a-fb686d6630e4)\n\n![image](https://github.com/shub39/fingerprint_attendance/assets/143277026/83a091b0-aa2a-4414-b10d-03398c2db51b)\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshub39%2Fbiometric-attendance","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshub39%2Fbiometric-attendance","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshub39%2Fbiometric-attendance/lists"}