🌦️ Weather Forecast App

A sleek desktop weather app built with Python and CustomTkinter, fetching real-time data from OpenWeatherMap, Geopy, and TimezoneFinder. Features interactive maps, animated icons, and city search with auto-suggestions.

---

A Preview of the APP

.......

---

🚀 Key Features

• 🔍 Search by city with auto-suggestions
• 📊 Current weather: Temperature, humidity, wind speed, and conditions
• 🗺️ Interactive map (via tkintermapview)
• 🌈 Lottie animations for dynamic weather icons
• ⏰ Real-time timezone and location handling
• 📜 Search history tracking

🛠️ Tech Stack

• Language: Python 3.x
• GUI: CustomTkinter (modern UI)
• APIs:
  • 🌤️ OpenWeatherMap (weather data) — Get your API key and save it in a .env file
  • 📍 Geopy (geocoding)
  • 🕒 TimezoneFinder (timezone detection)
• Map: tkintermapview (interactive maps)
• Animations: Lottie JSON files

⚙️ Installation

1. Clone the repository:

   git clone https://github.com/1efferson/weatherapp.git
   cd weatherapp

2. Set up the virtual environment:

    # macOS/Linux
   source venv/bin/activate

   # Window
   venv\Scripts\activate
   
    
     

3. Install dependencies:

   pip install -r requirements.txt

4. 🚨 Restart VSCode before launching the app to ensure all dependencies and environment paths are loaded correctly.
5. Run the app:

   python WeatherApp_main.py

❓ Troubleshooting

• If the app crashes or dependencies aren’t detected, restart VSCode and re-activate the virtual environment.
• Ensure your API keys (OpenWeatherMap) are properly configured in the app.

📌 Known Issue

⚠️ Background Image Responsiveness on Windows

Currently, the app's background image does not resize correctly on Windows systems. This is a known issue and is actively being worked on to ensure full cross-platform compatibility.

🤝 Contribute & Collaborate

I welcome contributions and collaborations! If you're interested in improving or extending the app:

• 🍴 Fork the repository
• 📥 Open a pull request with your improvements
• 💬 Or simply open an issue to suggest ideas

Let’s build something great together! 🚀