INSTALL

   1 To make and install this program :
   2
   3 run:
   4 ./configure (for configure options see ./configure --help)
   5 make
   6 make install (as root)
   7
   8 To make and install the gui configurator written in qt2, cd into the
   9 bbkeysconf subdirectory and run `make`, followed by a `make install`.
  10 You may have to edit the Makefile in this directory to tell it where your
  11 qt2 libs are.
  12
  13 The global configuration files can be found in $(datadir)/bbtools
  14 (default: /usr/local/share/bbtools).
  15
  16 Blackbox users:
  17
  18 By default bbkeys reads the Blackbox style-file as defined in .blackboxrc
  19 and copies as much of the style as possible. The result is a application
  20 which looks a lot like the toolbar. Further configuration options can be
  21 found in bbkeys.style. Most likely you want to change these options,
  22 copy this file to somewhere in your homedir (eg blackbox/bbkeys.config)
  23 and edit it. Edit the file .blackboxrc and add or edit the line:
  24 bbkeys.configFile: <your config file>
  25
  26 WARNING: You have to define the entire PATH.
  27
  28 All style options set be reading the Blackbox-style file can be overridden by
  29 placing them in bbkeys.config (and changing them). See bbkeys.style for all
  30 possible options.
  31
  32 Make sure the file .bbtoolsrc does not exist, else the configuration style
  33 for other Window Managers will be used.
  34
  35 Users other Window managers:
  36
  37 By default bbkeys reads the bbtoolsrc bbkeys.nobb config files.
  38 If you want to define your personal config-file copy bbtoolsrc to your home-dir
  39 as ./.bbtoolsrc Copy bbkeys.nobb somewhere in your homedir. Edit .bbtoolsrc so
  40 bbkeys.configFilex: <your config file>.
  41
  42 WARNING: You have to define the entire PATH.