BBWEATHER(1)

NAME
bbweather - display the current weather conditions

SYNOPSIS
bbweather [OPTIONS] StationID

DESCRIPTION
bbweather is a tool which displays the current weather conditions in an decorated window, simulating the look of the Blackbox toolbar (Blackbox is a Windowmanager for X11). This tool is heavily based on bbdate by John Kennis, almost 90% of the code (rough guess ;) were taken over unaltered. Furthermore, bbweather was inspired by wmWeather by Michael G. Henderson, from where "GrabWeather", the perl-script that fetches the weather-conditions from your local station originates.

USAGE
To use bbweather , you will need to know the station-ID of a weather-station to grab the information from. You can find out which stations are near you at http://www.nws.noaa.gov/oso/siteloc.shtml . Once you determined the proper station, you need to run the perl-script GrabWeather with that ID as the first command-line parameter. Since you probably want to stay updated on the weather conditions, you might consider adding an entry to your crontab: 0 * * * * /path/to/GrabWeather StationID This will create a directory called ".wmWeatherReports" in your $HOME in which it will place the data-files. You can then run bbweather : bbweather StationID If you left-click on bbweather , it will display detailed weather information in an xmessage much like wmWeather You can cycle through the information by hand by right-clicking on bbweather unless the information to be displayed is too long to fit into the window, in which case it will be scrolled through the display until the 'cycle' is over. The following information is displayed when cycling:

T: Temperature H: Humidity

W: Wind speed and direction

V: Visibility

General Conditions

P: Pressure

DP: Dew Point

As of: Time Data collected

In: location

OPTIONS
You can specify some general options in the configuration files. bbweather uses the same blackbox-style files as bbdate, which all are very self-explanatory. See FILES below. This program follow the usual GNU command line syntax, with long options starting with two dashes (`-'). If _GNU_SOURCE is not defined on your system, you can only use the normal command-line options. All of these options can alternatively be specified in the configuration file. A summary of options is included below.

-c, --cycle
    Cycle through Temperature and Humidity, Wind conditions, Visibility and General Conditions. Per default, bbweather only displays Temperature and Humidity values. Cycling can be toggled at any time by middle-clicking on the application.

-d, --weathdir DIR
    Look in DIR for weather data (default is ~/.wmWeatherReports

-f, --file FILE
    Read configuration from FILE (default is specified at compile-time (usually /usr/local/share/bbtools/bbweather.conf))

-g +x+y, --geometry +x+y
    Specify Geometry

-h, --help
    Show summary of options.

-m, --metric
    Use metric units

-s, --shape
    Don't show frame

-t sec, --ticks sec
    Cycle in sec seconds interval

-u min, --update min
    Check for new weather data ever min Minutes

-v, --version
    Show version of program.

-w, --withdrawn
    Place bbweather into the slit

-x, --extra
    When cycling, cycle through ALL information.

-z, --zone
    Specify timezone in hours of deviation from UTC.

REQUIRES

wget
    http://sunsite.auc.dk/wget/

Perl
    http://www.perl.com

FILES
/usr/local/share/bbtools/bbweather.conf /usr/local/share/bbtools/bbweather.nobb /usr/local/share/bbtools/bbweather.style

VERSION
0.6.2 bbweather is documented fully by The bbweather Handbook, available http://www.netmeister.org/apps/bbweather/.

BUGS
If you run into any problems, if you encounter bugs, or if you have any other comments on this program, please don't hesitate to contact the author.

SEE ALSO
wmWeather(1), GrabWeather(1), bbdate(1)

AUTHOR
Jan Schaumann <jschauma@netmeister.org>