Skip to content

README.md

Latest commit

 

History

History
103 lines (67 loc) · 2.53 KB

README.md

File metadata and controls

103 lines (67 loc) · 2.53 KB

Maharashtra Weather App 🌦️

Python

This is a desktop weather application that I built using Python.
The app shows real-time weather information for cities across Maharashtra using data from OpenWeatherMap, along with a clean UI and dynamic background images that change based on the current weather.

I focused on keeping the project simple, well-structured, and easy to understand while still looking presentable.

Screenshots

Main Dashboard

Maharashtra Weather App – Main View

Weather State Example

Maharashtra Weather App – Weather View

Maharashtra Weather App – Weather View

What this project does

  • Shows current temperature and weather condition
  • Displays “feels like” temperature
  • Changes background image based on weather (clear, rain, clouds, fog, etc.)
  • Allows selecting Maharashtra cities using a dropdown or manual input
  • Fetches real-time data from OpenWeatherMap
  • Runs as a desktop application using Tkinter

How to run the project

1. Clone the repository

git clone <your-repo-link>
cd maharashtra-weather-app

2. Install dependencies

pip install -r requirements.txt

3. Create and configure config.py

This project uses a local configuration file that is not tracked by Git.

  1. Create a new file named config.py by copying the example file:
# Windows
copy config.example.py config.py

# macOS / Linux
cp config.example.py config.py
  1. Open config.py and add your OpenWeatherMap API key:
OPENWEATHER_API_KEY = "YOUR_API_KEY_HERE"

4. Run the application

python main.py

Technologies used

  • Python 3
  • Tkinter for the user interface
  • Pillow (PIL) for image handling
  • OpenWeatherMap API for weather data
  • Threading for smoother UI updates

Configuration

  • config.example.py is included in the repository as a reference template.
  • config.py is intentionally ignored using .gitignore.
  • Each user must create their own config.py with a valid API key.

Notes

A valid API key is required to fetch weather data

Without an API key, the app will run but weather data will not load

Background images are stored locally inside the assets/ folder

Supported Cities

The application supports major cities across Maharashtra, including Mumbai, Pune, Nagpur, Nashik, Aurangabad, Kolhapur, Solapur, and more.

Author

Built by Aayush

Weather data provided by OpenWeatherMap
⚡