NAME
wmweather - dockable weather monitor
SYNOPSIS
wmweather -s <4-char ICAO location indicator> [options]
DESCRIPTION
wmweather monitors local weather conditions: temperature, dew point,
pressure, humidity and wind direction and speed. The user needs to
specify a 4-character ‘ICAO location indicator’. The standardized METAR
station designations and current weather reports are designed for use
by the aviation community. Since most major cities have at least one
airport, there is usually one or more METAR stations in a given city.
You--obviously--need to be connected to the internet and you also need
to have libcurl installed. wmweather will then attempt to download the
latest METAR report for the station of your choice from the National
Weather Sevice run by NOAA.
You can toggle back and forth between imperial and metric units, i.e.
between degrees Fahrenheit, inches of Mercury, and miles per
hour--and--degrees Celsius, hectoPascal, and kilometers per hour. A
middle click will do 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.
OPTIONS
-s id, --station=id
This option tells wmweather which METAR station to show data
for. id can be any four-letter ICAO location indicator, which
can be found at http://www.nws.noaa.gov/tg/siteloc.shtml.
-c, --compat
Switch into compatibility mode. The old monitor style will be
used, default metric pressure units are millimeters of Mercury
instead of hectoPascal, and the colorization options are
enabled. When the time turns red, this means that the weather
report is older than 24 hours. When the wind speed turns red,
this means that the wind is gusty and the listed value is an
average only. Similarly, a red direction indicates a variable
wind direction and the value given is the average direction. 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.
-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. Please
don’t specify this option, use the file ~/.netrc for
authentication instead.
--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
netrc(5)
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