---
name: "bbkeysconf.pl"
section: "1"
platform: "linux"
package: "bbkeys"
version: "0.8.6-2"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/bbkeys"
---

# bbkeysconf.pl(1)

a general XWindow keygrabber

Part of [bbkeys(1)](/bbkeys/1.md).

## NAME

bbkeys - a general XWindow keygrabber

## SYNOPSIS

**bbkeys** \[*OPTION*\]

## DESCRIPTION

**bbkeys** is the keygrabber for the blackbox window manager. **bbkeys** handles all keybindings and keyboard shortcuts for  blackbox. It uses blackbox's Image classes for rendering its look and feel so that **bbkeys** will render itself to match whatever blackbox style is used. It is highly configurable either via the *bbconf* GUI utility or the (now deprecated) *bbkeysconf* GUI utility or by hand-editting bbkeys's config file.

## USAGE

On startup, **bbkeys** reads *$HOME/.bbkeysrc*, which you can edit by hand or through *bbconf* or *bbkeysconf*. This is now configurable through a command-line switch as show in OPTIONS.

## OPTIONS

A summary of the options supported by **bbkeys** is included below.

- **-c\[onfig\]** *filename*

  use alternate 'look and feel' config file

- **-rc\[file\]** *filename*

  use alternate keygrab definition file.  (default is ~/.bbkeysrc)

- **-d\[ecorated\]**

  show 'normal' decorated window

- **-display** *display name*

  X server to connect to

- **-geom\[etry\]** *geometry*

  set geometry of the bbkeys window

- **-h\[elp\]**

  show summary of options and exit

- **-i\[conic\]**

  start bbkeys in a minimized state (will override the -withdrawn option)

- **-m\[iniMe\]**

  like Austin Powers 2. bbkeys, but smaller

- **-n\[obb\]**

  fall back on default configuration

- **-no\[qt\]**

  use non-qt configuration tool

- **-s\[hape\]**

  don't display groundplate

- **-t\[inyMe\]**

  all you can see is its keyhole

- **-v\[ersion\]**

  display version number and exit

- **-w\[ithdrawn\]**

  place bbkeys in the Slit

## FILES

Default: *$datadir=/usr/local/share/*\
 *$HOME/.bbkeysrc* maintains keybindings\
 See *[bbkeysrc(5)](/bbkeysrc/5.md)*

### Under Blackbox

```
$datadir/bbtools/bbkeys.bb the global style configuration file
$HOME/.bbtools/bbkeys.bb a local style configuration file
```

### Under other Window managers

```
$datadir/bbtools/bbkeys.nobb the global style configuration file
$HOME/.bbtools/bbkeys.nobb a local style configuration file
```

## VERSION

0\.8.6

## BUGS

This application is perfect and should solve all of your problems,  up to and including male pattern baldness and world hunger. Should you, against all odds, find any bugs, please report them to the author.

## SEE ALSO

**[bbkeysrc(5)](/bbkeysrc/5.md),** **[bbkeys.bb(5)](/bbkeys.bb/5.md)**

## AUTHOR

Jason 'vanRijn' Kasper \<vR@movingparts.net\> - bbkeys\
 Jan Schaumann \<jschauma@netmeister.org\> - this man page