WMWEATHER(1)

📦
version 2.4.9 · 3 versions
, in ubuntu stonking

okay bestie, so this is the wmweather(1) manual page — Version 2.4.9 — and it's literally your lil dockable weather monitor that sits in your dock and tells you if it's giving jacket weather or not 🌦️✨ no cap.

✨ NAME ✨

wmweather — dockable weather monitor 🛰️💖

🌈 SYNOPSIS 🌈

wmweather -s <4-char ICAO location indicator> [options]

💅 DESCRIPTION 💅

okay so wmweather monitors your local weather conditions: temperature, dew point, pressure, humidity and wind direction and speed. the way that you HAVE to give it a 4-character `ICAO location indicator' though?? yeah, non-negotiable 🫶

those standardized METAR station designations and current weather reports are designed for use by the aviation community ✈️, and since most major cities have at least one airport, there's usually one or more METAR stations in a given city. so like, you're covered, don't stress.

and obviously 💀 you need to be connected to the internet, and you also need libcurl installed. wmweather will then attempt to download the latest METAR report for the station of your choice from the National Weather Service run by NOAA 🌸.

you can toggle back and forth between imperial and metric units btw, i.e. between degrees Fahrenheit, inches of Mercury, and miles per hour — and — degrees Celsius, hectoPascal, and kilometers per hour. a middle click does this 🔁.

also!! a left click will bring up the fully decoded METAR report in xmessage. and a right click will force an immediate update, i.e. wmweather will attempt to grab weather information. main character energy fr fr 👑

🎀 OPTIONS 🎀

  • -s id, --station=id — this one tells wmweather which METAR station to show data for. id can be any four-letter ICAO location indicator, which you can find at https://www.notams.faa.gov/common/icao/ 🌍
  • -c, --compat — switch into compatibility mode. the old monitor style gets used, the default metric pressure units become millimeters of Mercury instead of hectoPascal, and the colorization options get enabled 🎨. so when the time turns red, that means the weather report is older than 24 hours ⏰. when the wind speed turns red, that means the wind is gusty and the listed value is an average only 💨. similarly, a red direction means a variable wind direction and the value given is the average direction. also the symbolic link wmWeather is functionally equivalent to wmweather --compat 🫶
  • -d [@]min, --delay=[@]min — set the time (in minutes) between updates, default is 15 minutes. use @ to specify minutes past the hour 🕰️
  • -m, --metric — display metric values: temperatures in degrees Celsius rather than degrees Fahrenheit, pressure in hectoPascal rather than inches of Mercury, and wind speed in kilometers per hour rather than miles per hour. this option can be toggled at runtime using a middle click 🌡️
  • -i, --imperial — display imperial values: temperatures in degrees Fahrenheit rather than degrees Celsius, pressure in inches of Mercury rather than hectoPascal, and wind speed in miles per hour rather than kilometers per hour. this option can be toggled at runtime using a middle click 🇺🇸
  • -w, --chill, -W — display wind chill — if available — instead of dew point temperature 🥶
  • -e, --heat — display wind heat index — if available — instead of temperature 🥵
  • -b, --beaufort — display wind speed on the `Beaufort scale' 🌬️
  • -n, --knots — display wind speed in units of knots, i.e. sea miles per hour ⚓
  • -u, --utc — display update time in UTC instead of localtime. this is equivalent to --time=+0000 🌐
  • -t offset, --time=offset — convert update time according to (RFC 822 compliant) time offset rather than to localtime, e.g. --time=+0100 for MET ⏳
  • -x host[:port], --proxy=host[:port] — proxy specification, this option is passed to libcurl 🔌
  • -U username[:password], --proxy-user=username[:password] — proxy authentication, this option is passed to libcurl 🔐
bestie PLEASE don't specify this option 🙈 use the file ~/.netrc for authentication instead. i'm literally begging you.
  • --lcd — use LCD style display 🖥️
  • --display=id — set the display to use, e.g. --display=:0.0 🪟
  • --geometry=pos — set the position of the dock app. note that the size (64x64) is hard-coded and cannot be changed 📐
  • -h, --help — display a list of command-line options 🆘
  • -v, --version — display the program version 🔢
  • -a, --hPa — when toggled to metric, display pressure in units of hectoPascals, i.e. milliBars 📊
  • -k, --kPa — when toggled to metric, display pressure in units of kiloPascals 📈
  • -g, --mmHg — when toggled to metric, display pressure in units of millimeters of Mercury 🌡️
  • -p, --mps — when toggled to metric, display wind speed in units of meters per second 🏃
  • --bc=color — when toggled to compatibility mode, set the background color (#8e8e69 is LCD-ish) 🎨
  • --lc=color — when toggled to compatibility mode, set the color of the labels, e.g. --lc=red or --lc=salmon or --lc=#4523ff 🏷️
  • --dc=color — when toggled to compatibility mode, set the color of the data entries 📝
  • --wgc=color — when toggled to compatibility mode, set the gusty-wind/variable-direction color 💨. the wind speed indicator will turn this color when the wind speed is gusty. the value shown in this case is the average speed. similarly, the wind direction indicator with change to this color when the wind direction is variable. the value shown in this case is the average direction 🧭
  • --tc=color — when toggled to compatibility mode, set the color of the ICAO location indicator and update time header 🕐

🦋 FILES 🦋

  • /etc/wmweather.conf — the system-wide configuration file. specify one long option per line, e.g. station=EDDC or metric. whitespace, empty lines, and lines beginning with a # will be ignored 🙅
  • ~/.wmweather/config — the user configuration file 🏠
  • ~/.wmweather/???? — these files contain the latest downloaded weather records in decoded METAR format 📂
  • ~/.netrc — these file contains authentication information and should be used in preference to --proxy-user 🔑

🌸 ENVIRONMENT 🌸

  • http_proxy — the HTTP proxy to be used, see also --proxy 🌐

💜 SEE ALSO 💜

to find out more about NOAA's National Weather Service, have a look at http://www.nws.noaa.gov/ 🌦️

💀 BUGS 💀

please report any bugs to <martin@godisch.de> 🐛. Debian users are encouraged to use the Debian Bug Tracking System at http://bugs.debian.org/wmweather 🫶

👑 AUTHORS 👑

Version 1:

  • Michael G. Henderson <mghenderson@lanl.gov>

Version 2:

  • Martin A. Godisch <martin@godisch.de>

Contributors:

  • Athanasius, Pablo Castellazzi, Avtar Gill, Adam Lackorzynski, Jon Larabee, Jordi Mallach, Paul Martin, HIROSE Masaaki, Michael Pötters

and that's the whole page bestie 🎀 this one's Version 2.4.9, dated June 2026, brought to you by The Debian Project — go check the weather, drink some water, and slay 💖✨🦋

📦 where this page comes from