Skip to content

README.md

Latest commit

 

History

History
105 lines (73 loc) · 2.2 KB

README.md

File metadata and controls

105 lines (73 loc) · 2.2 KB

Python Dictionary 🧠

A lightweight graphical dictionary tool for French/English words built with Tkinter.

GitHub Repository: https://github.com/danialsource/Dictionarypy

🚀 Features

  • Graphical User Interface (GUI) with Tkinter: Easy to use, no terminal needed
  • Simple JSON-based database: Easily add new words and meanings
  • Quick search, add, and display meanings via buttons and lists
  • Clean and readable code: No heavy dependencies
  • Great for learning Python, small projects, or expanding to bigger projects

🛠️ Installation & Setup

  1. Clone the repository:

    git clone https://github.com/danialsource/Dictionarypy.git

  2. Navigate to the project folder:

    cd Dictionarypy

  3. Run the main program:

    python main.py

📁 Project Structure

python-dict/
│  
├─ demo/
│  ├─ main.exe
│  ├─ dictionary.json
│  └─ dictionary-v1.0-windows.zip
├─ main.py              # GUI and program entry point   
├─ icon.ico             # Application icon  
├─ .gitignore.txt  
└─ LICENSE.txt

📝 Sample words.json

{
  "hello": "Bonjour",
  "world": "mot",
  "computer": "ordinateur"
}

To add a new word:

  1. Use the English word as the key
  2. Add its french or English meaning as the value
  3. Save the file and use the program’s interface

✅ How to Use

  1. Run the program
  2. Enter a word
  3. If the word exists, the meaning is displayed
  4. If not, use the "Add" option to enter its meaning
  5. New words are immediately saved in words.json

📦 Releases

You can find the latest stable releases of Python Dict here:

  • Each release includes a ready-to-run version of the program
  • Easy to download and use without cloning the repository
  • Release notes include updates, bug fixes, and new features

👥 Contributing

Feel free to open an Issue or submit a Pull Request if you have suggestions or find bugs. Remember to update the words.json file and commit your changes.

📄 License

This project is released under the MIT License — free to use, modify, and distribute.