https://github.com/bjesus/wttrbar
Custom module for showing the weather in Waybar, using the great wttr.in
https://github.com/bjesus/wttrbar
sway waybar wayland weather wttr
Last synced: 2 months ago
JSON representation
Custom module for showing the weather in Waybar, using the great wttr.in
- Host: GitHub
- URL: https://github.com/bjesus/wttrbar
- Owner: bjesus
- License: mit
- Created: 2023-04-17T06:13:20.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-12-01T09:40:20.000Z (7 months ago)
- Last Synced: 2025-04-06T08:06:06.623Z (2 months ago)
- Topics: sway, waybar, wayland, weather, wttr
- Language: Rust
- Homepage:
- Size: 140 KB
- Stars: 210
- Watchers: 4
- Forks: 27
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
wttrbar
a simple but detailed weather indicator for Waybar using wttr.in.
## Installation
Compile yourself using `cargo build --release`, or download the precompiled binary from the [releases](https://github.com/bjesus/wttrbar/releases) page.
For Arch Linux, use the [AUR](https://aur.archlinux.org/packages/wttrbar) package.
For NixOS, use the [NixPkg](https://search.nixos.org/packages?channel=24.05&show=wttrbar&from=0&size=50&sort=relevance&type=packages&query=wttrbar) package.
## Usage
- `--ampm` - display time in AM/PM format
- `--location STRING` - pass a specific location to wttr.in
- `--main-indicator` - decide which [`current_conditions` key](https://wttr.in/?format=j1) will be shown on waybar. defaults to `temp_C`
- `--date-format` - defaults to `%Y-%m-%d`, formats the date next to the days. see [reference](https://docs.rs/chrono/latest/chrono/format/strftime/index.html)
- `--nerd` - use [nerd font](https://www.nerdfonts.com/) symbols instead of emojis
- `--hide-conditions` - show a shorter descrpition next to each hour, like `7° Mist` instead of `7° Mist, Overcast 81%, Sunshine 17%, Frost 15%`
- `--fahrenheit` - use fahrenheit instead of celsius
- `--mph` - use mph instead of km/h for wind speed
- `--custom-indicator STRING` - optional expression that will be shown instead of main indicator. [`current_conditions` and `nearest_area` keys](https://wttr.in/?format=j1) surrounded by {} can be used. For example, `"{ICON} {FeelsLikeC} ({areaName})"` will be transformed to `"text":"🌧️ -4 (Amsterdam)"` in the output
- `--lang LANG` - set language (currently `en`, `de`, `pl`, `tr`, `fr`, `ru`, `zh`, `be`, `es`, `pt`, `it`, `ja`, `uk`, `sv`; submit a PR to add yours)
- `--observation-time` - show the time the current weather conditions were measured
e.g. `wttrbar --date-format "%m/%d" --location Paris --hide-conditions`
### Icons
To display the weather icons correctly, you will need to have a font that supports emojis installed. The screenshot uses [Noto Emoji](https://github.com/googlefonts/noto-emoji), but you can use [other fonts](https://wiki.archlinux.org/title/fonts#Emoji_and_symbols) too.
## Waybar configuration
Assuming `wttrbar` is in your path, it can be used like:
```json
"custom/weather": {
"format": "{}°",
"tooltip": true,
"interval": 3600,
"exec": "wttrbar",
"return-type": "json"
},
```
You can also then creating custom styling based on the current condition:
```css
#custom-weather.sunny {
background-color: yellow;
}
```
## Old version
This code is based on my [old Python gist](https://gist.github.com/bjesus/f8db49e1434433f78e5200dc403d58a3) that was used for the same purpose.