{"id":20186710,"url":"https://github.com/azeemidrisi/qr-attendance-system","last_synced_at":"2025-05-08T21:20:22.571Z","repository":{"id":193645461,"uuid":"689229783","full_name":"AzeemIdrisi/QR-Attendance-System","owner":"AzeemIdrisi","description":"A hassle-free solution for marking attendance within college network.","archived":false,"fork":false,"pushed_at":"2024-11-23T08:45:44.000Z","size":103,"stargazers_count":51,"open_issues_count":5,"forks_count":22,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-31T18:21:15.827Z","etag":null,"topics":["attendance-monitoring","attendance-system","flask","hackathon","hacktoberfest","hacktoberfest-accepted","mini-project","project","qrcode"],"latest_commit_sha":null,"homepage":"https://www.youtube.com/watch?v=k-tDIN0c9XU","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AzeemIdrisi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-09-09T06:47:22.000Z","updated_at":"2025-03-28T23:58:03.000Z","dependencies_parsed_at":"2023-11-11T22:28:22.306Z","dependency_job_id":"48ae6c13-d46c-4bdc-b241-daf78582983b","html_url":"https://github.com/AzeemIdrisi/QR-Attendance-System","commit_stats":null,"previous_names":["azeemidrisi/live-the-code","azeemidrisi/qr-attendance-system"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AzeemIdrisi%2FQR-Attendance-System","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AzeemIdrisi%2FQR-Attendance-System/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AzeemIdrisi%2FQR-Attendance-System/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AzeemIdrisi%2FQR-Attendance-System/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AzeemIdrisi","download_url":"https://codeload.github.com/AzeemIdrisi/QR-Attendance-System/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253149966,"owners_count":21861803,"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":["attendance-monitoring","attendance-system","flask","hackathon","hacktoberfest","hacktoberfest-accepted","mini-project","project","qrcode"],"created_at":"2024-11-14T03:18:18.444Z","updated_at":"2025-05-08T21:20:22.531Z","avatar_url":"https://github.com/AzeemIdrisi.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# QR Attendance System\n\n![image](https://github.com/AzeemIdrisi/QR-Attendance-System/assets/112647789/dbc0c061-76d0-45bb-b5da-7f4373ffd073)\n\n\u003c/div\u003e\n\n## Table of Contents\n\n- [Overview](#overview)\n- [Features](#features)\n- [Prerequisites](#prerequisites)\n- [Setup](#setup)\n- [Usage](#usage)\n- [Screenshots](#screenshots)\n- [License](#license)\n- [Contributions](#contributions)\n- [Developers](#develpers)\n\n## Overview\n\nThe QR Code Attendance System is an efficient,fast and user-friendly tool for tracking attendance using QR codes. It utilizes HTML, CSS, and Django to create a web-based interface for marking attendance. This system is designed to work seamlessly when devices are connected to the __Same College Local Network__.\n\nThe teacher/faculty can display the QR Code using classroom projector so that present students can scan and mark their attendance.\n\n## Features\n\n- **Automatic IP Fetching:** It fetch your IPv4 address automatically and Generate a QR code based on that IP to enable connections within the classroom.\n- **Faculty Panel:** It has a Faculty View Panel that enables the teacher to remove duplicate or proxy attendances based on count.\n- **User-Friendly Interface:** A straightforward web interface for effortless attendance management.\n- **Real-Time Tracking:** Mark attendance by scanning QR codes with real-time updates.\n- **Accessibility:** Easily access attendance records for quick reference.\n\n## Prerequisites\n\nBefore you begin, ensure you have the following prerequisites installed:\n\n- **Python3**\n- **Django**\n- **qrcode**\n- **Web Browser:** Required for accessing the system interface.\n\n## Setup\n\n1. **Clone the Repository:**\n\n   ```\n   git clone https://github.com/AzeemIdrisi/QR-Attendance-System\n   ```\n\n2. **Navigate to the Project Directory:**\n\n   ```\n   cd QR-Attendance-System\n   ```\n\n\n4. **Install dependencies:**\n\n   ```\n   pip install -r requirements.txt\n   ```\n4. **Run the Django Server:**\n\n   ```\n   python manage.py runserver 0.0.0.0:8000 \n   ```\n\n5. **Access the System:**\n\n   Open your web browser and go to `http://localhost:8000` to use the system.\n\n### Setting up Firewall settings for the first time\n\n- Open Windows Defender Firewall Settings:\n\n   - Press Win + S to open the search bar.\n   - Type \"Windows Defender Firewall\" and select the corresponding result.\n\n- Create an Inbound Rule:\n\n   - On the left panel, click on \"Advanced settings.\"\n   - In the left panel, select \"Inbound Rules.\"\n   - In the right panel, click on \"New Rule...\" to open the New Inbound Rule Wizard.\n\n- Select Rule Type:\n\n   - Choose \"Port\" and click \"Next.\"\n\n- Specify Port and Protocol:\n\n   - Choose \"Specific local ports\" and enter the port number your Django server is running on (e.g., 8000).\n   - Click \"Next.\"\n\n- Choose Action:\n\n   - Choose \"Allow the connection\" and click \"Next.\"\n\n- When Does the Rule Apply?\n\n   - Keep all three options (Domain, Private, Public) checked.\n   - Click \"Next.\"\n\n- Specify Rule Name:\n\n   - Enter a name for your rule (e.g., \"Django Server\").\n   - Optionally, provide a description.\n   - Click \"Finish.\"\n\n- Check the Inbound Rules:\n\n   - In the left panel, click on \"Inbound Rules.\"\n   - Find your newly created rule in the list.\n\n- Test the Connection:\n\n   On another device within the same local network, try to access your Django server using the local IP address and port number or By simply scanning the displayed QR Code.\n\n## Usage\n\n1. **Open the System in Your Web Browser:**\n\n   Access the system by opening your web browser and visiting `http://localhost:8000`.\n\n\n2. **Display QR Codes:**\n\n   Display the QR codes to students or attendees.\n\n3. **Mark Attendance:**\n\n   To mark attendance, scan the QR codes using a device connected to the same local network.\n\n4. **Real-Time Tracking:**\n\n   The attendance records will be updated in real-time, ensuring accurate tracking.\n\n## Screenshots\n\n### Admin Page\n![image](https://github.com/AzeemIdrisi/QR-Attendance-System/assets/112647789/e4c9f2d8-6b8e-44de-a63d-f7e5db45383e)\n\n### Student Page\n![image](https://github.com/AzeemIdrisi/QR-Attendance-System/assets/112647789/a8e2f4a7-831c-4ac5-8e1b-c917a9ca9001)\n\n### Submission Successful Page\n![image](https://github.com/AzeemIdrisi/QR-Attendance-System/assets/112647789/0f77779e-7648-4356-84c0-7db58b3e786c)\n\n\n## Contributions\n\nWe welcome contributions from the community! If you'd like to contribute to this project, please follow our [contribution guidelines](CONTRIBUTING.md).\n\n## Developers\nCreated by __Team Hokage__ during __Live The Code 2.0__ Hackathon.\n\nContributors : [Mohd Azeem](https://github.com/AzeemIdrisi), [Dheeraj Jha](https://github.com/Dheerajjha451), [Shantanu Pant](https://github.com/Shanty34)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazeemidrisi%2Fqr-attendance-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fazeemidrisi%2Fqr-attendance-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazeemidrisi%2Fqr-attendance-system/lists"}