https://github.com/oumarousandasouley/weather

A weather app built with KivyMD and Python that retrieves weather information from OpenWeatherMap API.
https://github.com/oumarousandasouley/weather

kivy kivy-application kivymd mobiledevelopment python python3

Last synced: 2 days ago
JSON representation

A weather app built with KivyMD and Python that retrieves weather information from OpenWeatherMap API.

• Host: GitHub
• URL: https://github.com/oumarousandasouley/weather
• Owner: OumarouSandaSouley
• Created: 2024-06-18T13:12:02.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2024-06-24T06:21:39.000Z (3 months ago)
• Last Synced: 2024-09-25T20:20:11.927Z (2 days ago)
• Topics: kivy, kivy-application, kivymd, mobiledevelopment, python, python3
• Language: kvlang
• Homepage:
• Size: 205 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
OSS Weather App

================

A weather app built with KivyMD and Python that retrieves weather information from OpenWeatherMap API.

Description

-----------

This app allows users to search for weather information by city name or automatically detect their current location using Google search results. The app displays the current temperature, humidity, wind speed, and weather conditions.

Features

--------

* Search for weather information by city name

* Automatically detect current location using Google search results

* Display current temperature, humidity, wind speed, and weather conditions

Setup

-----

### Requirements

* Python 3.7 or later

* KivyMD library

* OpenWeatherMap API key (free account)

### Installation

1. Clone the repository: `git clone https://github.com/OumarouSandaSouley/oss-weather.git`

2. Install the required libraries: `pip install -r requirements.txt`

3. Replace the value of api_key in the main.py with your OpenWeatherMap API key 

4. Run the app: `python main.py`

Usage

-----

1. Run the app

2. Search for weather information by city name or click the "Current Location" button

3. The app will display the current weather information

Screenshots

----------

## Screenshots

### Screenshot 1

![screenshot1](screenshots/img1.png)

### Screenshot 2

![screenshot2](screenshots/img2.png)

License

-------

This project is licensed under the MIT License.

Contributing

------------

Contributions are welcome! If you want to contribute to this project, please fork the repository and submit a pull request.

Issues

------

If you encounter any issues or have suggestions, please create an issue on this repository.

Author

------

Oumarou Sanda Souley

Acknowledgments

---------------

* KivyMD library for providing the GUI framework

* OpenWeatherMap API for providing the weather data