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 "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 rightclicking on bbweather unless the information to be dis
played 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 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.
- -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
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>