How's the Weather? - Readme

This Weather Application is a Python program built using the Tkinter library and the OpenWeatherMap API. It allows users to search for a city and retrieve up-to-date weather information for that location. Below, you'll find important information about how the application works and how to use it effectively.

Table of Contents

• How's the Weather? - Readme
  • Table of Contents
  • Features
  • Dependencies
  • Installation
  • Usage
  • Screenshots
  • Contributing

---

Features

• Weather Information: Get current weather information for a specific city, including temperature, humidity, sunrise time, sunset time, and weather conditions.

• Day/Night Indicator: The application changes its display based on whether it is daytime or nighttime in the searched location.

• User-Friendly Interface: A simple and easy-to-use graphical interface built with Tkinter.

• Real-Time Data: Retrieves real-time weather data from the OpenWeatherMap API.

---

Dependencies

Before using this Weather Application, you need to have the following dependencies installed:

• Python 3.x
• Tkinter (included in standard Python libraries)
• Requests library (pip install requests)
• PIL (Python Imaging Library) library (pip install PIL)

---

Installation

1. Clone this repository to your local machine or download the code as a ZIP file.

2. Make sure you have Python 3.x installed. You can download it from the official Python website.

3. Install the required dependencies by running the following commands in your terminal:

   pip install requests
   pip install PIL

4. Open a terminal/command prompt, navigate to the directory where you have the Weather Application code, and run the command with the file name as you saved it:

5. The Weather Application window should now open, allowing you to enter a city and view the weather information.

---

Usage

IMPORTANT: You will need to obtain a free API key to use this software from https://openweathermap.org/. You simply request the API, make a .env file and save it like this: API_KEY="{the_key_they_supply}"

1. Launch the Weather Application by following the installation steps above.

2. Enter the name of the city you want to check the weather for in the text input field.

3. You can specify the state or (if applicable) country by separating them with commas. For example, "New York, NY" or "London, UK." The searches are not case-sensitive.

4. Press the Enter key to retrieve weather information.

5. The weather information, including temperature, humidity, and conditions, will be displayed on the screen. Additionally, an icon representing the current weather conditions will be shown.

6. The application also indicates whether it is daytime or nighttime in the searched location, adjusting the display icons accordingly.

7. You can search for weather information for different cities by entering a new location in the text input field and pressing Enter.

8. To exit the application, simply close the window.

---

Screenshots

---

Contributing

Contributions to this Weather Application are not currently open. If you have any suggestions, bug reports, or feature requests, please let me know at [email protected]

---

Thank you for using How's the Weather? I hope you find it useful for checking the weather in different locations. If you have any questions or encounter any issues, please feel free to reach out.

Happy weather checking!