A weather widget for Waybar using Open-Meteo. No API key required.
A compact line in your bar — hover for the full forecast:
meteobar tooltip
| Feature | wttrbar | meteobar |
|---|---|---|
| API reliability | wttr.in (frequent downtime) | Open-Meteo (stable, no limits) |
| Location disambiguation | None | Smart geocoding (City, Province, Country) |
| Day/night icons | No | Automatic (current weather) |
| Format customization | Fixed flags | Template strings with placeholders |
| CSS classes | No | Weather-condition based |
| API key required | No | No |
- Current conditions with day/night-aware icons
- Daily and hourly forecast in tooltip
- Smart geocoding with province/country disambiguation
- Auto-detect location by IP
- Multiple icon sets: Nerd Font, Weather Icons, emoji, Font Awesome
- Template-based format customization
- CSS classes per weather condition for bar styling
- Metric and imperial units
- Written in Rust — fast, single binary, no runtime dependencies
- Waybar
- A Nerd Font for icons (recommended; required only for the framed tooltip via
--frame) - (Optional) Font Awesome ≥ 7.0.0 OTF for Font Awesome icon set
yay -S meteobar
git clone https://github.com/mryll/meteobar.git cd meteobar make install PREFIX=~/.local
Or system-wide:
sudo make install
To uninstall:
make uninstall PREFIX=~/.localAdd to your ~/.config/waybar/config.jsonc:
"modules-right": ["custom/meteobar", ...], "custom/meteobar": { "exec": "meteobar --location 'Buenos Aires'", "return-type": "json", "interval": 900, "tooltip": true }
That's it. You'll see something like 23° in your bar with a full forecast tooltip on hover.
meteobar [OPTIONS]
Options:
--location <NAME> City name, "City, Province", "City, Country", or "auto" for IP geolocation.
Auto-detects by IP if omitted.
--lat <FLOAT> Latitude (requires --lon)
--lon <FLOAT> Longitude (requires --lat)
--city-name <NAME> Display name for the location (used with --lat/--lon)
--format <TEMPLATE> Bar text template [default: "{icon} {temp}°"]
--tooltip-format <FORMAT> Tooltip content: days, hours, both [default: days]
--days <N> Forecast days in tooltip (1-7) [default: 3]
--hours <N> Forecast hours in tooltip (0-24) [default: 0]
--units <UNITS> Unit system: metric, imperial [default: metric]
--icons <SET> Icon set for bar text: nerd, weather, emoji, fontawesome [default: nerd]
--frame Draw the framed tooltip box (pins a Mono Nerd Font for alignment).
Off by default: plain, borderless, renders in your font.
--frame-font <NAME> Font family pinned in framed mode — must be a complete Mono Nerd Font
[default: "JetBrainsMono Nerd Font Mono"]
--timeout <SECS> HTTP timeout in seconds (1-60) [default: 10]
--version Print version
--help Print help
Use --format to control the bar text:
| Placeholder | Example | Description |
|---|---|---|
{icon} |
| Weather icon (nerd font or emoji) |
{temp} |
23 | Current temperature |
{feels_like} |
22 | Feels-like temperature |
{humidity} |
47 | Humidity percentage |
{wind} |
9 | Wind speed |
{wind_dir} |
NE | Wind direction (cardinal) |
{pressure} |
1012 | Atmospheric pressure (hPa) |
{city} |
Buenos Aires | Location name |
{min} |
13 | Today's minimum temperature |
{max} |
26 | Today's maximum temperature |
{rain_chance} |
5 | Today's precipitation probability (%) |
{description} |
Overcast | Weather description |
# Minimal (default) meteobar --location "Berlin" # => 23° # Detailed meteobar --location "Berlin" --format "{icon} {temp}° {city} ({description})" # => 23° Berlin (Clear sky) # Temperature range meteobar --location "Berlin" --format "{icon} {min}/{max}°" # => 13/26° # Weather Icons (Erik Flowers, filled with day/night variants) meteobar --location "Berlin" --icons weather # Emoji mode meteobar --location "Berlin" --icons emoji # => ☀️ 23° # Font Awesome (requires otf-font-awesome >= 7.0.0) # Icons are automatically wrapped in Pango markup for correct rendering meteobar --location "Berlin" --icons fontawesome
Note
The tooltip always uses Nerd Font icons for consistent monospace alignment, regardless of the --icons setting. The --icons flag controls the bar text only.
meteobar emits CSS classes you can use in style.css:
| Class | Condition |
|---|---|
clear |
Clear sky / mainly clear |
cloudy |
Partly cloudy / overcast |
rainy |
Rain / drizzle |
snowy |
Snow |
stormy |
Thunderstorm |
foggy |
Fog / mist |
error |
Total failure |
#custom-meteobar.clear { color: #e5c07b; } #custom-meteobar.rainy { color: #81a1c1; } #custom-meteobar.snowy { color: #88c0d0; } #custom-meteobar.stormy { color: #bf616a; }
Tooltip colors are automatically read from the active Omarchy theme at ~/.config/omarchy/current/theme/colors.toml on every execution. On non-Omarchy systems, the One Dark palette is used as fallback.
| Gruvbox | Catppuccin Latte | Everforest |
|---|---|---|
| Gruvbox | Catppuccin Latte | Everforest |
With format and emoji:
"custom/meteobar": { "exec": "meteobar --location 'New York' --icons emoji --format '{icon} {temp}° {description}'", "return-type": "json", "interval": 900, "tooltip": true }
Imperial units with hourly forecast:
"custom/meteobar": { "exec": "meteobar --location 'London' --units imperial --tooltip-format both --hours 6", "return-type": "json", "interval": 900, "tooltip": true }
Auto-detect location by IP:
"custom/meteobar": { "exec": "meteobar --location auto", "return-type": "json", "interval": 900, "tooltip": true }
Location with province/country disambiguation:
"custom/meteobar": { "exec": "meteobar --location 'Avellaneda, Buenos Aires'", "return-type": "json", "interval": 900, "tooltip": true }
Adjust padding (inside the widget) and margin (outside the widget) in ~/.config/waybar/style.css:
#custom-meteobar { padding: 0 8px; margin: 0 4px; }
- Resolves location (from
--location,--lat/--lon, or auto-detect by IP via ipwho.is)- Supports
"City, Province","City, Country","City, CC"(ISO country code) for disambiguation --location autoexplicitly uses IP geolocation
- Supports
- Fetches weather data from Open-Meteo (free, no API key)
- Outputs JSON that Waybar consumes (
text,tooltip,class,alt)
| Symptom | Cause | Fix |
|---|---|---|
| No output | Location not resolved | Check --location spelling, try "City, Country" format |
| Stale data | API timeout | Check internet connection; increase --timeout |
| Wrong location | Ambiguous city name | Use "City, Province" or "City, CC" (ISO country code) |
error class |
API failure | Open-Meteo may be temporarily down; widget retries on next interval |
| Nothing | Module not loaded | Check Waybar config and restart Waybar |
- claudebar — Claude AI usage widget for Waybar
- codexbar — OpenAI Codex usage widget for Waybar
- logibar — Logitech battery widgets for Waybar
- tickerbar — Multi-market price ticker for Waybar (crypto, stocks, forex)
- Omarchy — Beautiful, modern & opinionated Linux distribution
- Waybar — Status bar for Wayland compositors