Welcome to Pokédex by giblecdg, a simple and interactive Pokédex application built with Python and Tkinter! This project allows you to search for your favorite Pokémon, explore their details, and even expand the Pokédex by adding your own entries.
- Search Pokémon: Find Pokémon by name or ID.
- Dynamic Interface: Displays Pokémon details, type, and a short description.
- Customizable Pokédex: Add your own Pokémon to the
pokemon_data.json
file and include their sprites in thesprites
folder. - Error Handling: Gracefully handles typos, special cases, and common search mistakes.
- Python 3.12.4
- Tkinter: For the graphical user interface.
- Pillow (PIL): To handle Pokémon sprite images.
- JSON: To manage Pokémon data.
├── data/
│ └── pokemon_data.json # JSON file containing Pokémon data
├── images/
│ ├── app/
│ │ ├── gui.png # GUI background image
│ │ └── icon.ico # Application icon
│ └── sprites/ # Folder containing Pokémon sprites
├── main.py # Main Python script
- Install Python 3.12.4 or a compatible version.
- Install required dependencies using pip:
pip install pillow
- Clone this repository and navigate to the project directory:
git clone https://github.com/giblecdg/pokedex-python.git cd pokedex-python
- Run the application:
python main.py
- Search for a Pokémon by entering its name or ID in the search bar and hit the SEARCH button.
- Open the
pokemon_data.json
file in thedata
folder. - Add a new Pokémon entry in the following format:
"pokemon_name": [id, "Name", "Type", "Description", "sprite_filename.png"]
- Place the corresponding sprite image in the
sprites
folder.
- Special characters in Pokémon names (e.g.,
Farfetch'd
,Mr. Mime
) require specific handling. - Make sure the sprite filenames match exactly with the entries in
pokemon_data.json
.
Contributions are welcome! Feel free to submit a pull request or open an issue if you have suggestions, improvements, or encounter bugs.
This project is licensed under the MIT License.
Feel free to use, modify, and distribute it as you like.
Developed with ❤️ by giblecdg.
Enjoy catching 'em all! 🌟