xbindkeys

XBindKeys(1)                 General Commands Manual                XBindKeys(1)



NAME
       xbindkeys - a grabbing keys program for X

SYNOPSIS
       xbindkeys [ options ]

DESCRIPTION
       XbindKeys is a program that grab keys and mouse button events in X and
       starts associated shell command.


COMMAND LINE OPTIONS
       Available command line options are as follows:

       -d, --defaults
              Print a default rc file

       -f, --file
              Use an alternative rc file

       -h, --help
              Short help on options plus version/author info.

       -X, --display
              Set X display to use

       -v, --verbose
              More information on xbindkeys when it run


       -k, --key
              Identify one key pressed (useful to fill the configuration file)


       -mk, --multikey
              Idenfify multi key pressed (useful to fill the configuration file)


       -g, --geometry
              size and position of window with -k|-mk option


       -n, --nodaemon
              don't start as daemon


XBINDKEYSRC
       XBindKeys uses a configuration files.  This file is $HOME/.xbindkeysrc,
       used only for one user.  All whitespace is ignored in the files except
       for within the commands names double quotes.

       The configuration file consists of commands names in double quotes, and
       associated keys in the next line.

       Comments are started with a pound (#) and extend to the end of the line.

       You can see a default file with the --defaults option or create a default
       $HOME/.xbindkeysrc with
        'xbindkeys --defaults > $HOME/.xbindkeysrc'.

KEYSYMS
       The program expects combinations of keysyms to be used by using plus(+)
       characters to combine them together.

       The format of a command line is:
           "command to start &"
              associated key

       Please, don't forget the '&' at the end of the command,
       if not xbindkeys will launch only one command at the same time if
       threads have not been enabled (by default threads are enabled).

       To specify an associated key, you can use 'xbindkeys --key' or
        'xbindkeys --multikey' and put one of the two lines in the
       configuration file.

       A list of keys is in /usr/include/X11/keysym.h and in
       /usr/include/X11/keysymdef.h.
       The XK_ is not needed.

       List of modifier (on my keyboard):
           Control, Shift, Mod1 (Alt), Mod2 (NumLock),
           Mod3 (CapsLock), Mod4, Mod5 (Scroll).

       By defaults, xbindkeys does not pay attention with the modifiers
       NumLock, CapsLock and ScrollLock.
       Add the lines above in the configuration file, if you want to pay
       attention to them.

           keystate_numlock = enable
           keystate_capslock = enable
           keystate_scrolllock= enable


EXAMPLES
       # control+shift+d starts an xterm (it's a comment)
       "xterm &"
         control+shift + q

       # Menu key starts xbindkeys_show (it's a comment)
       "xbindkeys_show &"
         Menu

       # Control + mouse button 1 starts an xterm (it's a comment)
       "xterm &"
         Control + b:1



BUGS
       If you find a bug, send a mail to <hocwp@free.fr>

HOMEPAGE
       http://hocwp.free.fr/xbindkeys


AUTHOR
       Philippe Brochard <hocwp@free.fr>


FILES
       $HOME/.xbindkeysrc
            The users configuration file.



SEE ALSO
       xbindkeys_show
           Utility for showing the actual keybinding with xbindkeys
       xmodmap(1x)
           Utility for modifying keymap & button mappings in X.
       xev(1x)
           Print contents of X events.
       /usr/include/X11/keysymdef.h
           X11 KeySym definitions.




3rd Berkeley Distribution        Thr 16 May 2002                    XBindKeys(1)