WMWEATHER(1)							   Version 2.4.5						      WMWEATHER(1)

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 func-
	      tionally 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
	      Potters

The Debian Project						     July 2009							      WMWEATHER(1)