Skip to content

A simple Python Pokédex app that lets you search Pokémon by name or ID, displaying their details and sprite image. Built with Tkinter and Pillow.

License

Notifications You must be signed in to change notification settings

giblecdg/pokedex-python

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Pokédex in Python 🐾

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.


pokedex tkinter

🌟 Features

  • 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 the sprites folder.
  • Error Handling: Gracefully handles typos, special cases, and common search mistakes.

🔧 Technologies Used

  • Python 3.12.4
  • Tkinter: For the graphical user interface.
  • Pillow (PIL): To handle Pokémon sprite images.
  • JSON: To manage Pokémon data.

📂 Project Structure

├── 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

🚀 How to Use

  1. Install Python 3.12.4 or a compatible version.
  2. Install required dependencies using pip:
    pip install pillow
  3. Clone this repository and navigate to the project directory:
    git clone https://github.com/giblecdg/pokedex-python.git
    cd pokedex-python
  4. Run the application:
    python main.py
  5. Search for a Pokémon by entering its name or ID in the search bar and hit the SEARCH button.

📋 How to Add Pokémon

  1. Open the pokemon_data.json file in the data folder.
  2. Add a new Pokémon entry in the following format:
    "pokemon_name": [id, "Name", "Type", "Description", "sprite_filename.png"]
  3. Place the corresponding sprite image in the sprites folder.

🐞 Known Issues

  • 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.

🤝 Contributing

Contributions are welcome! Feel free to submit a pull request or open an issue if you have suggestions, improvements, or encounter bugs.


📜 License

This project is licensed under the MIT License.
Feel free to use, modify, and distribute it as you like.


💬 Credits

Developed with ❤️ by giblecdg.
Enjoy catching 'em all! 🌟

About

A simple Python Pokédex app that lets you search Pokémon by name or ID, displaying their details and sprite image. Built with Tkinter and Pillow.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages