Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/denis-source/weather_app
Simple yet elegant weather application
https://github.com/denis-source/weather_app
accuweather-api kivy-application metaweather-api open-weather-api python weather
Last synced: 20 days ago
JSON representation
Simple yet elegant weather application
- Host: GitHub
- URL: https://github.com/denis-source/weather_app
- Owner: Denis-Source
- License: other
- Created: 2022-05-09T07:33:56.000Z (over 2 years ago)
- Default Branch: kivy
- Last Pushed: 2022-05-26T12:32:17.000Z (over 2 years ago)
- Last Synced: 2024-10-16T12:36:30.949Z (about 1 month ago)
- Topics: accuweather-api, kivy-application, metaweather-api, open-weather-api, python, weather
- Language: Python
- Homepage:
- Size: 586 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# weather_app
Simple yet elegant weather application
## Features
- adaptable color scheme to time of the day and weather conditions;
- ability to select a weather api;
- selectable temperature units and time formats;
- simple yet effective location search;
- location autosetting;
- written in [kivy](https://github.com/Denis-Source/weather_app) and [tkinter](https://github.com/Denis-Source/weather_app/tree/tkinter) GUI frameworks.
***
## Installation
Weather app uses kivy as a frontend framework and can be installed on both mobile and desktop platforms.
Installation process:
```shell
git clone https://github.com/Denis-Source/weather_app
cd weather_app
```
It is recommended to use venv
Windows:
```shell
python -m venv venv
venv\Scripts\Activate.ps1
pip install -r requirements.txt
```
Linux/MacOS:
```shell
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
```
In order to use the app you should have API keys. For testing purposes, you can use MetaWeather and Sunset and Sunrise APIs.
To run the app simply start the main file:
```shell
python weather_app.py
```
***
## Showcase
### Search screen
By default, the app will ask a location to get weather about.
The location can be entered in any language supported by the APIs.
The search screen can be omitted if the default location setting is set.
Location is determined by the API and it has a comprehensive list of cities and locations all around the world.
### Status screen
When the location is entered, the application makes several calls to the APIs:
- depending on whether the selected API gets the coordinates or the [woeid](https://en.wikipedia.org/wiki/WOEID) of the specified location;
- gets information about sun rise or set timings (needed to determine time of the day of the location);
- api call to get current weather information;
- one or several calls to get a forecast for the next 4 or more days.
If the entered city is correct and the API key is correct, the API returns a valid response.
The list of API handlers that parse and decode the information to a standard format, creating a weather object that contains the following information:
- current temperature;
- current weather conditions;
- approximate daily forecast for the next 4 days;
- other information is stored but not used (wind, humidity, etc).
The main design feature of the application is the ability to change its appearance depending on weather conditions and time of the day.
#### Cloudy weather in New York at 5 in the evening will have the next theme:
#### Clear weather in LA at 2:
#### Cloudy weather in Lisbon at dusk:
#### Night in Kyiv:
#### Sunrise in Hong Kong:
***
## Customization
The application allows you to change time format, temperature units as well as APIs you call. All this work can be done via the configuration screen (menu button or `f1` key).
The screen theme is also dynamically changed.
#### Example of the configuration screen:
There is an option to define the default location.
#### The default can be set in the form:
***
## APIs
The application has 3 or 4 different types of APIs:
- geolocation;
- sunrise and sunset information about the location;
- current weather information;
- average forecast for the following 4 or more days.
The architecture of the app allows dynamic selection of APIs on the fly.
#### Selection of APIs for weather reports:
As the latest version is considered, there are the following available APIs:
- [OpenWeather](https://openweathermap.org/api): geolocation, weather and sun information;
- [AccuWeather](https://developer.accuweather.com/): geolocation and weather;
- [MetaWeather](https://www.metaweather.com/api/): geolocation and weather;
- [Sunset and Sunrise](https://sunrise-sunset.org/api): sun information.
Some of them require an API key and allow a limited daily requests amount; others are free.
> Note: Some APIs use [woeid](https://en.wikipedia.org/wiki/WOEID) and other longitude and latitude, so as a consequence they, are not compatible.