BBWEATHER(1)bbweatherBBWEATHER(1)NAMEbbweather - display the current weather conditions
SYNOPSISbbweather [OPTIONS] StationID
DESCRIPTIONbbweather 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 "Grab
Weather", the perl-script that fetches the weather-condi
tions 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 com
mand-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. The following information is dis
played 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 condi
tions, 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.
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.3
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 ALSOwmWeather(1), GrabWeather(1), bbdate(1)AUTHOR
Jan Schaumann <jschauma@netmeister.org>
bbtools July 29, 2001 BBWEATHER(1)
