WeatherMaster/README.md

<div align="center">
   <img src="https://github.com/PranshulGG/WeatherMaster/blob/master/preview/readme_app_icon.svg" alt="" width="150px">
</div>
<h1 align="center">
 WeatherMaster
</h1>
   <div  align="center">
      <img src="https://img.shields.io/github/license/PranshulGG/WeatherMaster?style=for-the-badge&color=cba6f7&labelColor=302D41">
      <img src="https://img.shields.io/github/last-commit/PranshulGG/WeatherMaster?style=for-the-badge&color=b1d18a&labelColor=1f3701">
      <img src="https://img.shields.io/github/release/PranshulGG/WeatherMaster?style=for-the-badge&color=dbc66e&labelColor=3a3000">
      <br>
      <img src="https://img.shields.io/github/stars/PranshulGG/WeatherMaster?style=for-the-badge&color=ffb5a0&labelColor=561f0f">
      <img src="https://img.shields.io/github/downloads/PranshulGG/WeatherMaster/total?label=Downloads&style=for-the-badge&color=aac7ff&labelColor=0a305f">
      <a href="https://discord.gg/sSW2E4nqmn">
 <img src="https://img.shields.io/discord/1302477023410782229?label=Discord&style=for-the-badge&color=ffb0c8&labelColor=541d32">
</a>

   </div>
   <div align="center">
   <h3>WeatherMaster: inspired by the Google Pixel weather app.</h3>
   </div>
 <div align="center">
    
   [Features](https://github.com/PranshulGG/WeatherMaster?tab=readme-ov-file#-features) • [Contact](https://github.com/PranshulGG/WeatherMaster?tab=readme-ov-file#contact) • [License](https://github.com/PranshulGG/WeatherMaster?tab=readme-ov-file#license) • [Translate](https://github.com/PranshulGG/WeatherMaster?tab=readme-ov-file#-translate-the-app-on-crowdin)
    </div>
    
<div align="center">
 <a href="https://github.com/PranshulGG/WeatherMaster/releases"><img alt="GitHub" src="https://censorship.no/img/github-badge.png" height="80"/></a>
   <a href="https://apt.izzysoft.de/fdroid/index/apk/com.example.weathermaster"><img alt="GitHub" src="preview/download_Btn.png" height="80"/></a></div>
<br>

![app_thumbnail](preview/thumbnail_mat.png)

# 👁️ Screenshots

<div align="center">
<img src="preview/1.png"  width="250">
<img src="preview/2.png"  width="250">
<img src="preview/3.png"  width="250">
<img src="preview/4.png"  width="250">
<img src="preview/5.png"  width="250">
<img src="preview/6.png"  width="250">
<img src="preview/7.png"  width="250">
<img src="preview/8.png"  width="250">
<img src="preview/9.png"  width="250">

</div>

<br>

# 🌐 Translate the app on [Crowdin](https://crowdin.com/project/weathermaster/invite?h=448278a9b1370f3c10d4336a091dae792286917)

<a href="https://crowdin.com/project/weathermaster/invite?h=448278a9b1370f3c10d4336a091dae792286917"><img src="https://badges.crowdin.net/weathermaster/localized.svg" width="200"> </a>

# ✨ Features:

- 🌍 **Offline Mode:** Access previously loaded weather data even without an internet connection.
- 🌤️ **Current Weather:** Get real-time updates on weather conditions in your area.
- 📢 **Government Weather Alerts:** Receive official alerts and warnings to stay safe.
- ⏳ **24-Hour Forecast:** Plan your short-term activities with accurate forecasts for the next two days.
- 📅 **14-Day Forecast:** View detailed weather predictions for the upcoming week.
- 🌙 **Moon Phases:** Track the phases of the moon and plan accordingly.
- 🌑 **Moonrise & Moonset:** Know the exact times for moonrise and moonset each day.
- 🌅 **Sunrise & Sunset:** Stay informed about sunrise and sunset times to optimize your day.
- 📏 **Day Length:** Check how long the daylight lasts each day.
- 📝 **Day Description:** Get a brief summary of the day’s weather conditions.
- 🌧️ **Rain Bar:** See a visual representation of expected rainfall.
- 👁️ **Visibility:** Monitor how far you can see clearly based on weather conditions.
- 💧 **Humidity:** Check the current humidity levels to stay comfortable.
- 🧭 **Pressure:** Track atmospheric pressure to understand weather changes.
- 🌬️ **Wind Direction & Speed:** Stay aware of wind patterns and strength.
- ❄️ **Snow Amount:** Know the expected snowfall for winter planning.
- ☁️ **Cloudiness:** See how much of the sky is covered by clouds.
- 🌡️ **Min-Max Temperature:** View the range of temperatures for the day.
- 🌬️ **Feels Like Temperature:** Understand how the temperature feels based on wind and humidity.
- 🌧️ **Precipitation Type & Area Coverage:** Get details on what kind of precipitation is expected and its coverage area.
- 🌞 **UV Index:** Stay protected from harmful UV rays with UV index updates.
- 🌿 **Air Quality:** Monitor air quality to stay informed about pollution levels.
- 🗺️ **Live Map:** Access a real-time map to track weather conditions in different areas.
- 📍 **Location Picker:** Easily select and view weather information for different locations.
- ⭐ **Save Favorite Locations:** Save your preferred locations for quick access to their weather updates.
- 👗 **Clothing Recommendations:** Get suggestions on what to wear based on the current weather conditions.
- 🌾 **Pollen Data (Europe Only):** View pollen levels for grass, trees, and weeds in your area.
- **⚙️ Customizable Layout:** Arrange and customize the app’s layout to display weather features in your preferred order and style. Example: Saved locations, condition widgets etc.

# 🌞 Weather providers:
- [**open-meteo**](https://open-meteo.com)
- [**Met norway**](https://www.met.no/en)
- [**WeatherApi**](https://www.weatherapi.com/)
- [**accuweather**](https://www.accuweather.com/)
- [**Météo-France**](https://www.meteofrance.com)
- [**DWD**](https://www.dwd.de/EN/Home/home_node.html)
- [**NOAA**](https://www.noaa.gov)
- [**ECMWF**](https://www.ecmwf.int)
- [**UK Met Office**](https://www.metoffice.gov.uk)
- [**JMA**](https://www.jma.go.jp/jma/indexe.html)
- [**GEM**](https://www.ec.gc.ca/meteo-weather/default.asp?lang=En&n=FB1BB3E4-1)
- [**BOM**](http://www.bom.gov.au)
- [**CMA**](http://www.cma.gov.cn/en/)
- [**KNMI**](https://www.knmi.nl)
- [**DMI**](https://www.dmi.dk/en/)


# ⚙️ Other:

- 📱<strong>Native Android Experience: </stronge>Enjoy a user interface and interaction that closely resemble a native Android Weather app.

- 🎨<strong>Material Design: </stronge>The app is built using Material Web Components, ensuring a clean, consistent, and visually appealing design.

- ⚙️<strong>Customization Options: </stronge>Enjoy a ton of customization options. Adjust themes, Units.

- 📐<strong>Responsive Design: </stronge>WeatherMaster is fully responsive for all mobile devices.

- 🧩<strong>User-Friendly Interface: </stronge>The app's interface is designed to be straightforward and user-friendly.


# 🛠️ Built With:

- <strong>HTML & CSS: </stronge> For the basic structure and styling of the app.

- <strong>JavaScript: </stronge>To handle the app's logic and interactivity.

- <strong>Java: </stronge>Mainly used for JavaScript interface and permissions, allowing the app to run on Android devices.

- <strong>Material Web Components: </stronge>Utilized to create a consistent and attractive Material Design look and feel.

- <strong>Weather icons</strong>: <a href="https://gitlab.com/bignutty/google-weather-icons">Google weather icons

# 📝 Todos:

- ✅ Adding cache to reduce api requests
- ✅ Translations
- ✅ Widgets
- ✅ Make it lightweight
- ✅ Allows you to add multiple locations
- ✅ Customization
- ✅ More detailed weather
- ✅ Live weather map
- ✅ Pick locations using map
- ✅ Change app colors according to the weather
-  Any user suggestions :)
   <br>
   <br>

> [!NOTE]
> The app is designed to run on Android devices and does not support web browsers. Attempting to open the app in a browser will not work.
<br>

# Contact
For any questions or feedback, feel free to open an issue on GitHub or contact pranshul.devmain@gmail.com

<br>

# License
This project is licensed under the GPL-3.0 license. See the `LICENSE` file for details.