https://github.com/37743/attention

This project is a desktop application designed to assist individuals with cognitive disabilities, such as ADHD, in their pursuit of education by providing a supportive, interactive and accessible yet enjoyable learning environment.
https://github.com/37743/attention

adhd cv2 education hackathon studying

Last synced: 3 months ago
JSON representation

This project is a desktop application designed to assist individuals with cognitive disabilities, such as ADHD, in their pursuit of education by providing a supportive, interactive and accessible yet enjoyable learning environment.

• Host: GitHub
• URL: https://github.com/37743/attention
• Owner: 37743
• License: agpl-3.0
• Created: 2024-01-24T15:59:59.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2024-05-20T17:38:34.000Z (9 months ago)
• Last Synced: 2024-10-11T11:46:50.113Z (4 months ago)
• Topics: adhd, cv2, education, hackathon, studying
• Language: Python
• Homepage:
• Size: 67.6 MB
• Stars: 3
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


[NOTICE]: <> (Use "#region folding" extension by maptz for a better experience reading this file)

[![LATEST](https://img.shields.io/badge/Empowering_People_of_Determination-09b5a9?style=for-the-badge&label=Hackathon&l&labelColor=5c2ba8)](https://hackathon.bu.edu.eg/)

[![WEBSITE](https://img.shields.io/badge/check_out_our_website-5c2ba8?style=for-the-badge&logo=data:image/jpeg;base64,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)](https://37743.github.io/Attention/website/home_page.html)



  


    

      

      

    

  






***

# Attention! 

This project is a desktop application designed to assist individuals with disabilities in their pursuit of education by providing a supportive, interactive and accessible yet enjoyable learning environment.

## Features:

- Upload your own studying material, your own rules![^1]

- Sign-up and compete with others for prestigious badges, aim for the best ranking!

- Real-time assistive evaluation,we will support you throughout the whole process![^2]

- Customize your profile by uploading a picture for your profile!

- ... and more!

## Usage

1. Register for an account.

   



| ![insert_image1_here](snapshots/register-screen.jpg)|

|:---:|

| Registration Page |



2. Login using your credentials.



| ![insert_image2_here](snapshots/login-screen.jpg)|

|:---:|

| Login Page |



3. Upload your document.



| ![insert_image3_here](snapshots/add-material.jpg)|

|:---:|

| Upload Page |



4. Start reading.



| ![insert_image4_here](snapshots/reading-doc.jpg)|

|:---:|

| Document Page |



5. Get rewarded with fantastic-looking badges.



| ![insert_image5_here](snapshots/profile-screen.jpg)|

|:---:|

| Account Page |



6. Check out your placement on the leaderboard.



| ![insert_image6_here](snapshots/home-screen.jpg)|

|:---:|

| Home Page |



## Frequently Asked Questions (FAQ)

- How do this application work for people of ADHD?

  - **ANSWER:** *This application utilizes the innate sense of competitiveness which is enforced by implementing a game-like experience system with rewards, the more you focus on the reading part, the more experience points you earn, thus motivating you to improve upon yourself while enjoying your time.*

- How do I earn XP?

  - **ANSWER:** *You could earn experience points by simply uploading a document and reading said document for a set amount of time, the amount of points you get is dependent on your performance during reading, which is evaluated based on your ability to focus.*

- Is my data safe?

  - **ANSWER:** *Yes, the database connection could only be achieved by secret keys which are obtained through an API request, and even if anyone was to get into our database, your passwords are securely hashed, which would, in turn, render the attacks useless.*

## Credits

### Hackathon Members & Contributors

- [@37743](https://github.com/37743) - **Yousef Gomaa**

- [@ahmedfarghly001](https://github.com/ahmedfarghly001) - **Ahmed Farghly**

- [@Desoky231](https://github.com/Desoky231) - **Abdelrahman Eldesoky**

- [@e-ayman](https://github.com/e-ayman) - **Eyad Ayman**

### Used Tools & Packages (Plenty of Thanks)

- Kivy, a Python framework used for the graphical interface,

- PDFMiner, for pdf files scrapping & text extraction,

- MariaDB, for the relational database management system,

- PHPMyAdmin, as a tool for SQL administration,

- and OpenCV, for real-time computer vision.

[^1]: Currently supported extensions are ".pdf" and ".txt".

[^2]: Might force/request access to your camera in order to properly conduct eye-tracking.