NAME
weather - command-line tool to obtain weather conditions and forecasts
SYNOPSIS
weather [ options ] [ alias [ alias [...] ] ]
DESCRIPTION
This utility is intended to provide quick access to current weather
conditions and forecasts. Presently, it is capable of providing data
for localities throughout the United States of America by retrieving
and processing METAR data from the National Oceanic and Atmospheric
Administration and forecasts from the National Weather Service.
Behavior can be determined by command-line options and specification of
zero or more aliases. Aliases are defined in weatherrc files, as a
convenient means of grouping option combinations together using a short
name. Specifying multiple aliases on the command line causes the
utility to output data for each, as if it had been invoked multiple
times. If no alias is specified, then an alias of "default" is used
(assuming it has been defined) or the built-in default values are
chosen (if it has not).
OPTIONS
A summary of options is included below.
--version
show program’s version number and exit
-h, --help
show a help message and exit
-a, --alert
include local alert notices
--atypes=ATYPES
alert notification types to display
--aurl=AURL
alert URL (including %atype% and %zone%)
-c CITY, --city=CITY
the city name (ex: "Raleigh Durham")
--flines=FLINES
maximum number of forecast lines to show
-f, --forecast
include a local forecast
--furl=FURL
forecast URL (including %city% and %st%)
--headers=HEADERS
the conditions headers to display
-i ID, --id=ID
the METAR station ID (ex: KRDU)
--imperial
filter/convert for US/UK units
-l, --list
print a list of configured aliases
-m, --metric
filter/convert for metric units
--murl=MURL
METAR URL (including %id%)
-n, --no-conditions
disable output of current conditions (forces -f)
-o, --omit-forecast
omit the local forecast (cancels -f)
--quiet
skip preambles and don’t indent
-s ST, --st=ST
the state abbreviation (ex: NC)
-v, --verbose
show full decoded feeds (cancels -q)
-z ZONES, --zones=ZONES
alert zones (ex: nc/ncc183,nc/ncz041)
FILES
weather may additionally obtain configuration data from a system-wide
configuration file, a per-user configuration file, and a local
directory configuration file. The file format and configuration options
are described in weatherrc(5). They are aggregated in the following
order:
/etc/weatherrc
the system-wide configuration
~/.weatherrc
the per-user configuration (can be used to override the above)
./weatherrc
the local directory configuration (can be used to override the
above)
EXAMPLES
weather
View output for the defined default alias, or the built-in
default values if there is no default alias defined in the
configuration files.
weather -i kavl
Display current conditions at the KAVL METAR station.
weather -n -c asheville -s nc
See a forecast for the Asheville, NC area.
weather -fv gso
Get the full decoded METAR for the station associated with the
gso alias, and the forecast data for the city/state associated
with the gso alias, without filtering or fancy formatting.
weather home work
Show current conditions for both the home and work aliases in
that order.
SEE ALSO
weatherrc(5)
AUTHOR
Utility and manual written by Jeremy Stanley <fungi@yuggoth.org>.
March 15, 2010