https://github.com/yousifj129/learnwords

Boost your vocabulary with LearnWords, a simple and interactive app that helps you learn new words and their meanings while reading books. Take quizzes, review definitions, and track your progress - all in one convenient place!
https://github.com/yousifj129/learnwords

english good-first-issue gui learning pyside6 python qt qt6

Last synced: 5 months ago
JSON representation

Boost your vocabulary with LearnWords, a simple and interactive app that helps you learn new words and their meanings while reading books. Take quizzes, review definitions, and track your progress - all in one convenient place!

• Host: GitHub
• URL: https://github.com/yousifj129/learnwords
• Owner: yousifj129
• License: mit
• Created: 2024-11-11T11:25:35.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-11-20T15:36:34.000Z (over 1 year ago)
• Last Synced: 2025-04-06T03:01:42.218Z (about 1 year ago)
• Topics: english, good-first-issue, gui, learning, pyside6, python, qt, qt6
• Language: Python
• Homepage:
• Size: 573 KB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md

Awesome Lists containing this project

README

          
# LearnWords

## Using the App

LearnWords is a vocabulary-building app that helps you learn new words while reading books. Here's how to use it:

1. Run the app and enter a word you'd like to learn.

2. The app will fetch the word's definition, synonyms, antonyms, and examples from a public dictionary API.

3. Review the word's information and add it to your vocabulary list.

4. Take a quiz to test your knowledge of the words you've learned.

5. to inspect and delete words you don't need anymore, click on the `Inspect words` button, and then double click the word you want to delete. Also, you can clear all with one button.

![alt text](https://github.com/yousifj129/LearnWords/blob/main/imgs/mainWindow.png?raw=true)

![alt text](https://github.com/yousifj129/LearnWords/blob/77f15d767c18a4c029ca83619fd69620f40b11eb/imgs/QuizWindow.png)

## Under the Hood

LearnWords uses the DictionaryAPI to fetch word data. When you add a word to your vocabulary list, the app saves the word's information to a JSON file named `learned_words.json`. This file stores all the words you've learned, along with their definitions, synonyms, antonyms, and examples.

The app uses the following:

* PySide6 for GUI

* requests for making API calls to DictionaryAPI

* json for storing and loading word data

## Features

* Learn new words and their meanings

* Review word definitions, synonyms, antonyms, and examples

* Take a quiz to test your knowledge

* Save learned words to a JSON file for later access (todo: have multiple JSON files for different sets of vocab and prebuilt vocab to make it easier to learn topic specific words (like the SAT, IELTS and others))

## License

LearnWords is licensed under the MIT License. See LICENSE for details.