BBAPPCONF(1)

NAME
bbappconf - configure applications for blackbox

SYNOPSIS
bbappconf [OPTIONS]

DESCRIPTION
bbappconf is a tool to configure the behaviour of certain aspects of an application under the Blackbox window manager.

USAGE
By default bbappconf reads the Blackbox style-file as defined in $HOME/.blackboxrc and copies as much of the style as possible. The result is an application which looks a lot like the toolbar. The -geometry is given as +x+y or -x-y (or combination) where -x-y is the (x,y) distance of the right bottom of screen to the right bottom of bbappconf. So -geometry -0-0 puts the application in the lower right corner of the screen.

OPTIONS
A summary of the options supported by bbappconf is included below.

-c[onfig] filename
    use alternate config file

-d[ecorated]
    Show 'normal' decorated window

-display display name
    X server to connect to

-geom[etry] geometry
    Set geometry of window

-h[elp]
    Show summary of options and exit.

-n[obb]
    fall back on default configuration

-s[hape]
    Don't display groundplate

-v[ersion]
    Display version number

-w[ithdrawn]
    Place bbtool in the Slit

CONFIGURATION
To be able to do something with windows we first have to identify them. In bbappconf this is done using the X-Windows class hints. A class hints consists of the application name and class. Normally all windows of an application have the same class, different windows of an application can have different names. You can tell bbappconf to indentify a windows as follows:
bbappconf.x.classHint.class: class
bbappconf.x.classHint.name: name You should at least define one of these, if both are defined both should match. If you want to find out the class/name of a window, use xprop, it will show you: WM_CLASS(STRING) = "name", "class" After you have identified an application window you can tell bbappconf what to do with it:

bbappconf.x.stick:
    true or false -- makes the window stick on all your desktops.

bbappconf.x.decorless:
    true or false -- removes all decorations from a window, like titlebars.

bbappconf.x.startOnWorkspace:
    1..number of workspaces -- tells bbappconf to start a window on a certain workspace.

EXAMPLES
The configuration file shows some examples.

FILES

  Under Blackbox
/usr/pkg/share/bbtools/bbappconf.bb the global configuration file
$HOME/.bbtools/bbappconf.bb a local configuration file

  Under other Window managers
/usr/pkg/share/bbtools/bbappconf.nobb the global configuration file
$HOME/.bbtools/bbappconf.nobb a local configuration file

VERSION
0.0.1-peak3

HISTORY
bbappconf first appeared on the internet on October 17th, 2000

SEE ALSO
blackbox(1)

AUTHOR
John Kennis <jkennis@chello.nl> - bbappconf
Jan Schaumann <jschauma@netmeister.org> - this man page