https://github.com/amit9838/mousam
Weather at a glance
https://github.com/amit9838/mousam
cairo card-design gnome graph gtk4 libadwaita python utility weather
Last synced: about 9 hours ago
JSON representation
Weather at a glance
- Host: GitHub
- URL: https://github.com/amit9838/mousam
- Owner: amit9838
- License: gpl-3.0
- Created: 2023-06-11T06:43:47.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2025-03-30T13:15:20.000Z (about 1 year ago)
- Last Synced: 2025-05-10T20:15:24.539Z (12 months ago)
- Topics: cairo, card-design, gnome, graph, gtk4, libadwaita, python, utility, weather
- Language: Python
- Homepage: https://amit9838.github.io/mousam/
- Size: 8.66 MB
- Stars: 313
- Watchers: 10
- Forks: 44
- Open Issues: 35
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: COPYING
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-gtk - Mousam - Lightweight weather application with dynamically changing gradient-based background according to current weather condition `#python` `#gtk4` `#libadwaita`. (Weather Viewers / Strategy)
README
## 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:**
- Or you can use the terminal:
```
flatpak install flathub io.github.amit9838.mousam
```
### **Snap:**
- Or you can use the terminal:
```
sudo snap install mousam
```
### **Debian** (Unofficial)
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.
## 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.


