<div align="center">
<img src="data/icons/hicolor/scalable/apps/io.github.amit9838.mousam.svg?raw=true" width="120">
<h1>Mousam</h1>

<p>Weather at a Glance</p>

<a href = "https://github.com/amit9838/mousam/releases"><img src="https://img.shields.io/github/v/release/amit9838/mousam?style=flat&label=Latest+Release&color=%234a92ff"></a>
<a href = "https://github.com/amit9838/mousam/discussions"><img alt="GitHub Discussions" src="https://img.shields.io/github/discussions/amit9838/mousam?logo=github&color=orange"></a>

</div>
<div align="center">
<img src="https://raw.githubusercontent.com/amit9838/mousam/master/screenshots/ss3.png?raw=true#gh-dark-mode-only">
<img src="https://raw.githubusercontent.com/amit9838/mousam/master/screenshots/ss1.png?raw=true#gh-light-mode-only">
</div>

## Features

- Displays real-time temperature, humidity, wind speed, UV index, pressure and more
- **Air Quality Index**: Comprehensive air pollutants data with health-based classification
- **Compact Mode**: A sleek, minimal view for focused weather tracking
- **Dynamic Backgrounds**: Adaptive UI that changes its aesthetic based on current conditions
- **Smart Notifications**: System alerts for weather updates with preference controls
- **Detailed Forecasts**: Hourly, tomorrow, and 7-day forecasts with graphical representations
- **Celestial Tracking**: Visual graphs for sun and moon positions and day/night cycles
- **Advanced Metrics**: Hourly temperature, wind direction and precipitation tracking
- **Architecture**: Asynchronous data loading and refined state management for peak performance
- See conditions in metric or imperial systems

## Installation

### **Flatpak:**

<a href='https://flathub.org/apps/io.github.amit9838.mousam'><img width='240' alt='Download on Flathub' src='https://dl.flathub.org/assets/badges/flathub-badge-en.png'/></a>

- Or you can use the terminal:

```
flatpak install flathub io.github.amit9838.mousam
```

### **Snap:**

<a href='https://snapcraft.io/mousam'><img width='240' alt='Download on SnapCraft' src='https://github.com/snapcore/snap-store-badges/blob/master/EN/%5BEN%5D-snap-store-black-uneditable.png?raw=true'/></a>

- Or you can use the terminal:

```
sudo snap install mousam
```

### **Debian** (Unofficial)

<a href='https://github.com/amit9838/mousam/discussions/68'><img width='240' alt='Download on SnapCraft' src='https://www.m5hosting.com/wp-content/uploads/2021/07/debian-dedicated-server.jpg' style="border-radius:5px; padding:3px 8px; background-color:white;"></a>

Thanks to @hsbasu for maintaining Debian package

[Installation Instruction](https://github.com/amit9838/mousam/discussions/68)

## Build

### Dependances

- python3-requests
- build-essential
- meson

### Build

```
rm -rf builddir
meson setup -Dprefix=$HOME/.local builddir
meson compile -C builddir --verbose
```

### Install

```
meson install -C builddir
```

### Run

```
mousam
```

## Contribution

Thanks to all the contributors have helped in the development project so that open-source community can enjoy best tools with best features.

<a href="https://github.com/amit9838/mousam/graphs/contributors">
<img src="https://contrib.rocks/image?repo=amit9838/mousam&columns=10"/>
</a>

## Credits

- Thanks to [Open Meteo](https://open-meteo.com/) from providing weather data for free of cost.

- Thanks to [@basmilius](https://github.com/basmilius) for making beautiful weather icons.

<div align="center">
 <h2>Support</h2>
I hope you ❤️ <b>Mousam</b>, if you think it is worth supporting you can do so using below methods
<br>
<br>
 
<div>
<a href="https://www.paypal.com/ncp/payment/MDNGWG9HQZDCE">
 <img src=https://upload.wikimedia.org/wikipedia/commons/thumb/b/b5/PayPal.svg/1280px-PayPal.svg.png alt="cards"  width="128" />    
</a>
<span>&nbsp; &nbsp; &nbsp;</span>
<a href="https://www.buymeacoffee.com/ami9838">
    <img className="mt-4" alt="support" width="128" src="https://miro.medium.com/1*QCQqlZr6doDP-cszzpaSpw.png" />
</a>
</div>
<div align="center">
</div>
