home | help
UNTITLED()			      LOCAL			      UNTITLED()

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 ob-
	       tained from http://www.openweathermap.org.  If given, this  over-
	       rides 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 explana-
     tory, human readable form.

     In compressed output mode, weather information is	generated  as  a  single
     line  containing many fields, separated by the specified delimiter (the de-
     fault 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.

SEE ALSO
     owrep.conf(5)

AUTHORS
     Bob Eager <bob@eager.cx>.

FreeBSD ports 15.quarterly	 March 04, 2018 			OWREP(1)

home | help