Ubuntu Manpage: wmweather - dockable weather monitor

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.

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