NAME

owrep — Weather information utility

SYNOPSIS

owrep [-c file] [-d delim] [-D] [-h] [-l location] [-u units] [-z]

DESCRIPTION

owrep is a simple utility for accessing the current weather from http://www.openweathermap.org, using the published API. It can generate either a human-readable weather summary, or a compressed set of data in a fixed format, with fields separated by a specified delimiter. The latter is suitable for feeding into other programs for further processing.

The following options are available:

-c file: Specify alternate location for the configuration file.
-d delim: Specify the delimiter for use with -z; the default is @. delim must be a single character.
-D: Turn on debugging; various progress messages are generated, and the raw data from http://www.openweathermap.org is also output.
-h: Display a short help message.
-l location: Specify the location for the weather report. This is a number obtained from http://www.openweathermap.org. If given, this overrides any value in the configuration file.
-u units: Specify the units to be used for output; the possible values are imperial and metric. These keywords may be abbreviated. If given, this overrides any value in the configuration file.
-z: Generate compressed output.

OUTPUT FORMAT

In normal output mode, weather information is generated in a self explanatory, human readable form.

In compressed output mode, weather information is generated as a single line containing many fields, separated by the specified delimiter (the default being @). These fields are as follows. The Type column indicates the type of information provided.

Number	Type	Contents
1	string	City/Town
2	string	Country
3	real	Longitude
4	string	Longitude direction (E or W)
5	real	Latitude
6	string	Latitude direction (N or S)
7	date	Sunrise date
8	time	Sunrise time
9	date	Sunset date
10	time	Sunset time
11	string	Temperature units
12	integer	Temperature now
13	integer	Temperature minimum
14	integer	Temperature maximum
15	integer	Humidity
16	string	Humidity units
17	integer	Pressure
18	string	Pressure units
19	string	Wind speed units
20	real	Wind speed
21	string	Wind speed description
22	real	Gust speed
23	integer	Wind direction (bearing)
24	string	Wind direction code (e.g. SW)
25	string	Wind direction description
26	integer	Cloud cover percentage
27	string	Cloud cover description
28	integer	Visibility distance
29	string	Visibility units
30	string	Precipitation mode
31	integer	Precipitation
32	string	Precipitation units
33	date	Date of last update
34	time	Time of last update

FILES

/usr/local/etc/owrep.conf: default configuration file

EXIT STATUS

The owrep utility exits 0 on success, and >0 if an error occurs.

AUTHORS

Bob Eager ⟨bob@eager.cx⟩.