{"id":25497182,"url":"https://github.com/mahmoudmahm00d/attendance_tracker","last_synced_at":"2026-03-02T04:04:52.926Z","repository":{"id":278105911,"uuid":"933814657","full_name":"mahmoudmahm00d/attendance_tracker","owner":"mahmoudmahm00d","description":"Simple attendance tracker app built with flutter","archived":false,"fork":false,"pushed_at":"2025-11-11T19:55:02.000Z","size":2582,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-11-11T22:03:07.113Z","etag":null,"topics":["android","attendance","attendance-system","flutter","qrcode","qrcode-reader","sqlite"],"latest_commit_sha":null,"homepage":"","language":"Dart","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/mahmoudmahm00d.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,"zenodo":null}},"created_at":"2025-02-16T18:44:22.000Z","updated_at":"2025-11-11T19:46:20.000Z","dependencies_parsed_at":null,"dependency_job_id":"40edb008-b1c3-4097-81f6-ba21a1153650","html_url":"https://github.com/mahmoudmahm00d/attendance_tracker","commit_stats":null,"previous_names":["mahmoudmahm00d/attendance_tracker"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/mahmoudmahm00d/attendance_tracker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mahmoudmahm00d%2Fattendance_tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mahmoudmahm00d%2Fattendance_tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mahmoudmahm00d%2Fattendance_tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mahmoudmahm00d%2Fattendance_tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mahmoudmahm00d","download_url":"https://codeload.github.com/mahmoudmahm00d/attendance_tracker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mahmoudmahm00d%2Fattendance_tracker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29992286,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-02T01:47:34.672Z","status":"online","status_checked_at":"2026-03-02T02:00:07.342Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["android","attendance","attendance-system","flutter","qrcode","qrcode-reader","sqlite"],"created_at":"2025-02-19T01:18:37.301Z","updated_at":"2026-03-02T04:04:52.907Z","avatar_url":"https://github.com/mahmoudmahm00d.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Attendance Tracker\n\nA Flutter application designed to simplify attendance tracking with QR code integration and comprehensive reporting features.\n\n## About\n\nAttendance Tracker is an open-source Flutter application designed for educational institutions to simplify attendance management. The app follows a hierarchical structure with groups, subjects, and students, allowing for flexible organization.\n\n## Features\n- Linear group management system\n- QR code generation for student identification\n- Camera-based attendance tracking\n- PDF report generation with QR codes\n- Subject-wise attendance reporting\n- Excel export functionality\n- Database import/export capabilities\n- Bulk operation support\n\n## Screenshot\n\n![](images/screenshot.png)\n\n## Database Diagram\n\n![](images/sqlite-db.png)\n\n## How to Use\n\n### Basic Navigation\n1. **Home Screen**: Access groups, subjects, students, and quick actions\n2. **Groups**: Create and manage student groups\n3. **Subjects**: Create subjects and track attendance for each\n4. **Students**: Add students individually or import from Excel\n\n### Taking Attendance in Detail\n\n#### Understanding Key Terms\n- **Group**: A collection of students (e.g., a class, department, or section)\n- **Subject**: A course or class associated with a specific group\n- **Attendance Session**: A record of student presence for a specific subject on a particular date\n\n#### Methods for Taking Attendance\n\n##### 1. QR Code Scanner Method\n1. Navigate to a subject from the subjects list\n2. Tap \"Take Attendance with QR\" option\n3. The camera will open with a QR scanner\n4. Students show their ID cards or QR codes (generated from the app)\n5. When scanned:\n   - The student name appears on screen\n   - Toggle \"Auto Save\" to automatically record attendance when scanning\n   - Without Auto Save, you can review scanned students and save in bulk\n\n##### 2. Manual Attendance Method\n1. Navigate to a subject\n2. Tap \"View Attendance\"\n3. You'll see a list of all students in the associated group\n4. To mark attendance:\n   - For individual students: Tap the menu (three dots) next to a student name and select \"Add Attendance\"\n   - For multiple students: Enable selection mode, select students, and use the floating action button to mark attendance\n5. Select the date for the attendance record\n\n#### How Groups Affect Attendance\n- Each subject is associated with a primary group\n- Students can belong to multiple groups (primary and secondary)\n- When taking attendance for a subject:\n  - All students from the subject's primary group are available\n  - Students from other groups who have been added to this group are also available\n  - The app filters the student list based on group membership\n- When viewing attendance reports:\n  - You can filter by specific groups to see attendance for subsets of students\n  - This allows for tracking attendance across different organizational structures\n\n\n## Getting Started\n\n```bash\n# Clone the repository\ngit clone https://github.com/mahmoudmahm00d/attendance-tracker.git\n\n# Navigate to project directory\ncd attendance-tracker\n\n# Install dependencies\nflutter pub get\n\n# Run the application\nflutter run\n```\n\n## Requirements\n\n- Flutter 3.0 or higher\n- Android SDK 21+\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmahmoudmahm00d%2Fattendance_tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmahmoudmahm00d%2Fattendance_tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmahmoudmahm00d%2Fattendance_tracker/lists"}