Metadata-Version: 2.1
Name: arithmetics_sdd
Version: 1.1
Summary: This program is designed to develop basic arithmetic skills
Home-page: https://github.com/Shayem1/Understanding-Arithmetics-Interactive-Experience
Author: Shayem Quazi
License: MIT
Classifier: Topic :: Multimedia
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Education
Classifier: Topic :: Games/Entertainment
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: customtkinter
Requires-Dist: pyttsx3
Requires-Dist: Pillow

**Gallery**
![Question](https://github.com/Shayem1/Understanding-Arithmetics-Interactive-Experience/assets/139934537/1128d169-403e-4bcf-943f-c676c15bb0d9)
![Screenshot 2024-05-25 214125](https://github.com/Shayem1/Understanding-Arithmetics-Interactive-Experience/assets/139934537/b140ca8c-931c-45db-96ba-755a909b95be)
![Screenshot 2024-05-25 213819](https://github.com/Shayem1/Understanding-Arithmetics-Interactive-Experience/assets/139934537/a44f7a08-85ca-4957-a5da-e0fae98a217a)
![Screenshot 2024-05-25 213934](https://github.com/Shayem1/Understanding-Arithmetics-Interactive-Experience/assets/139934537/4d42a5a0-9591-4501-bb95-640cf2593758)

**Description**
This program is intended for grades 1-2. Involves simple addition, subtraction, 
multiplication and division alongside worded problems

Includes:
  - 20 questions - 5 multiple choice questions for each operation
  - Way to track score and accuracy 
  - 106 languages (default English)
  - Text to speech
  - 720p to max monitor resolution (including fullscreen)
  - Full touchscreen support
  - Complete the quiz however you want, and check your results by finishing question 20
  - Explanation of every question

Recommended requirements:
  - CPU (any that supports Windows 10/11)
  - GPU integrated or dedicated
  - RAM 4 GB or more
  - Storage: 110 Mb or more
  - Monitor: 1280 by 720 or more
  - Touchscreen or keyboard + mouse
  - Operating system: Windows 10 or 11 (other operating systems may work)

**Installation:** 

Automatic
- Download the zip and extract files
- Download by clicking: [here](https://github.com/Shayem1/Understanding-Arithmetics-Interactive-Experience/releases/download/untagged-485cf5b7ab9f6b633618/Executable.Program.zip)
- Go to "Executable Program\dist\Program main\Program main.exe" and run normally

Manual    
***Required pip-installations (requires pip) 
*Copy and paste the text inside brackets and run in the terminal to install

- pyttsx3 (pip install pyttsx3) (pip install pywin32)
- PIL (pip install Pillow)
- customtkinter + tkinter (pip install customtkinter) (pip install tk)


Help:
1. Quiz:
     Click on the start button and select a level to start the quiz
   
     - Stuck on a question?
       Guess and the quiz will give you an explanation.
       
     - Stuck on what to do after clicking an option?
       If all options are greyed out you have finished the question, you
       may move on by clicking the next button in the bottom right corner.
       
     - Got kicked out after finishing a question?
       Click on a question you have not answered, you may not repeat questions
       until you finish the quiz.
       
     - Want to finish the quiz early?
       Complete question 20 and it will reset the quiz.

3. Settings/options:
     Click on "OPTIONS" to go to the options menu
   
     - Want to change languages?
       Click on options --> select language and click on apply.
       There are 106 translated languages using Google translate

     - Want fullscreen?
       Click on the button in the top left corner of any screen
       or click on the fullscreen checkbox in the options menu,

     - Want to resize the resolution?
       Drag any edge or side and expand as you wish, text will dynamically
       resize as well.

     - Want to listen to the question out loud?
       Click on the speaker icon in any level and it will read out
       any language that uses the Latin/English alphabet


Acknowledgements:
- Google translate Python module and web service for providing
  an effective and relatively fast method of converting English
  to other languages

- Tkinter and Customtkinter python module which is the primary
  library for the creation of the GUI

- Pillow or PIL python module which is the primary library in
  configuring and setting up images within the program.

- pyttsx3 python module which is the library required to use
  speech to text

- Github for allowing me to store, update and maintain my code
  and for providing a license to my program

- Codemy for explaining how to effectively code and debug my code
  https://www.youtube.com/@Codemycom

- W3 schools for teaching me new methods of coding 
  https://www.w3schools.com/

- OS Python module for bulk handling dozens of files quickly and
  effectively

- Python 3.11.4 64 bit for coding

- UTF-8 encoder and decoder to store and retrieve complex characters
