Back to files

Readme-File for SirTobi`s ButtonBar

1) What is it ?

It just a small buttonbar to call programs with a click. I built it, cause i searched for such an application to open it via ssh on a remote server and call there tools like xterm, halt, ... It is intended to be small, with less dependencys but flexible enough for my use. There are no icons in this packages. You can use any xpm you like. Where to get them ?
a) on your system: Find them with

find / -type f -name "*.xpm"
b) from icewm, look at www.stud.uni-hannover.de/~sirtobi/toice/ c) convert them from any image you like with ImageMagick or gimp or...

convert -geometry 32x32 <image_to_convet> xpm:image.xpm

2) Compiling

Just do an

make linux
or

make solaris
It works under both system, perhaps also with any other unix, but its not tested. Try it and tell me if it does and how.

3) Usage

Just call it ;-)
It searches for an config file in the following order: a) for a file given as commandline argument b) "bb.conf" in the actual directory
c) "bb.conf" at the place where you have called bb d) .bbrc in your home directory
e) /etc/bb.conf

4) Configuration file

All configuration is done in the file mentioned in 3). An sample is included in the package.

It has the follwing structure:

[CONFIG]

Configuration issues, lines with '' and empty lines are ignored.

[COMMANDS]

# the menu-structure.

4.1) Config-Section

Each line should be from the form key=value. You have the following keys:

| Key | Value | Description

| ALIGN | V,H | Alignment of the buttonbar. Values are (V)ertical or (H)orizontal. | TIPDELAY | secs | The delay until the tolltip appears. -1 for deactive, any other value

|             |        | in seconds is allowed
| XPOS        |   n    | The initial horizontal position
| YPOS        |   n    | The initial vertical position
| HOST        | String | Weather to show an host name or not.
|             | <none> | Values are the hostname to show,
|             | <auto> | <none> to show no hostname, or
|             |        | <auto> for automatic hostname detection.
| FQDN        | 0,1    | Show the full hostname or not.
| USER        | String | Weather to show an User or not.
|             | <none> | Values are the username to show,
|             | <auto> | <none> to not to show an username, or
|             |        | <auto> for automatic username detection

| ICONPREFIX | dir | the path to an directory where the icons are stored | USEICONS | 0,1 | Weather to use icons or not | USETEXT | 0,1 | Weather to use text or not | DECORATIONS | 0,1 | Weather to use window decorations or not

| LOAD        |  secs  | actualize the load every <secs> seconds. 0 for deactive.
| NOHUP       | 0,1    | Don't close on Hangup signals

4.2) Commands-Section

An normal menuentry should be produced with a line like this: ICON:Textual description:COMMAND
The ICON should be the basename of an icon in ICONPREFIX, with no path and no extension. The Textual description is shown, when USETEXT is set to 1 or in TollTips. The Command.... What do you think ?
(!) If the command is console based, use it with xterm, e.g. xterm -e mc (!) If you call bb via ssh, you perhaps have to use the commands with full path !

Instead of an COMMAND, you can use one of these internal commands: [SUB] Start an submenu
[QUIT] A button to quit bb

You wonder what is missing ?
If you want a submenu to end, just put a "[END]" on a single line. If you need an shell-box, just put a "[SHELL]" on a single line.

Thats all folks !
Have phun !