eapostol / attendance-tracker

attendance tracker created by Jessica Song, for class attendance

ATP

ATP is a tool designed to simplify attendance management using the Tesseract API. With this application, users can effortlessly handle attendance by following a straightforward process. No more manual searches through Zoom participants – just snap a picture, upload it, and let the tool intelligently compare it to the student roster list.

Important Format Considerations

• Ensure that student names in the roster image follows the "last name, first name" format for accurate extraction. Zoom participants image does not need to follow the format, but does need to include the students last name to be accounted for.
• Images must be uploaded in .png, or .jpg format.

Getting Started

1. Set up a virtual environment to manage project dependencies by running the appropriate command for your system

# mac/unix
python3 -m venv env
source env/bin/activate

# windows
py -m venv env
.\env\Scripts\activate

2. Install node & python dependencies by running the command

npm run install-node
npm run install-python  

3. Create .flaskenv file by running the command

touch .flaskenv

4. Inside the .flaskenv file add

FLASK_APP=server.py
FLASK_ENV=development

5. Then start the server by running

npm run start

6. Open http://127.0.0.1:5173/ to view in browser.
7. Click screen shot detection (video extraction is still under development).
8. Upload the attendance roster image.
9. Upload the Zoom participants list image.
10. Click the "Compare" button to start the automated attendance comparison.
11. Absent students will be intelligently identified and displayed for quick reference. Absent students referes to students who are not included in the Zoom participants image but are included in the attendance roster.

screen-capture.4.webm

Python Script for Automated Attendance

You can also take advantage of the "Run Script" feature to automate the attendance-taking process. This script is designed to quickly mark everyone as present (since most student will be present). You can go back and mark the students who are absent by hand as there will be fewer absentees.

Note: To enable this feature, ensure you have cloned the QuickAttendance repository. The path to this repository needs to be configured in the server.py file.

Usage Instructions

1. Click the "Run Script" button.
2. Place your mouse over the first name in the browser where you want the script to start. Do not click; the script will handle the clicks for you.
3. The script will automatically navigate through the list, marking each student as present.

Quick Stop

To stop the script promptly, move your mouse to the top left corner of the screen.

screen-capture.1.online-video-cutter.com.1.mp4

Future Developments

Future developments will include video extraction for larger classes.

Credits

Special thanks to Serendipbrity for their contributions with the QuickAttendance script.