NAME

       xkbind - X Keyboard Extension Indicator for the X Window System

SYNOPSIS

       xkbind -help
       xkbind -version
       xkbind  [-display  displayname]  [-force]  [-nodetach]  [-defgrp  group]  [-deflbl label] [-label0 label]
       [-label1 label] [-label2 label] [-label3 label] [-iname <name list>] [-iclass <class  list>]  [-ireverse]
       [-inowild]

DESCRIPTION

       The  xkbind  program  (X  Keyboard Extension Indicator) is a small and light indicator of keyboard layout
       (XKB group) for  the X Window System; it shows current keyboard layout in titles  of  top-level  windows.
       xkbind allows to simulate separate keyboard layout for each handled window and it works with most of win‐
       dow managers.

       xkbind exits 0 on success, and greater than 0 if an error occurs.

OPTIONS

       xkbind  accepts a number options most of which can be specified either on the command line, in the user's
       $HOME/.xkbindrc, $HOME/.Xdefaults (or $HOME/.Xresources), or in the system-wide configuration file.   De‐
       scription  of all the acceptable options is given below.  The command line option is specified first with
       correspondent X resource name (if any) in parenthesis afteward.  Options specified on  the  command  line
       have  the  highest  priority.  The -version and -help options interpreted even if xkbind can not open the
       display.

       -help  Print a short help message to stderr and exit.

       -version
              Print a version number of xkbind to stderr and exit.

       -force Do not allow xkbind automatically check existence of its own copy already running on the specified
              X server.

       -nodetach
              Do not detach as a background process.

       -display displayname (display)
              The X server to use.  This option overrides the contents of DISPLAY environment variable.

       -defgrp group (defgroup)
              Group number that xkbind initially binds to each handled window.

       -deflbl label (label.default)
              The default value for options label.group[0-3].

       -label[0-3] label (label.group[0-3])
              A label string for the specified keyboard group.

       -iname <name list> (ignore.name)
              Space- or tab-separated list of window names (WM_CLASS(res_name) property) that should be  ignored
              by xkbind.

       -iclass <class list> (ignore.class)
              Space-  or  tab-separated list of window classes (WM_CLASS(res_class) property) that should be ig‐
              nored by xkbind.

       -reverse (ignore.reverse)
              Indicates that the "ignore list" in options ignore.name and ignore.class should be interpreted  as
              "accept list"

       -nowild (ignore.usewild)
              Disable pattern matching while searching in window lists.

RESOURCES

       The format of the option in the X resources files is "Xkbind.option: value", where the option name is the
       one specified below.

       display
              The X server to use.  The default is the contents of environment variable DISPLAY.

       defgroup
              Group number that xkbind initially binds to each handled window.  The default is the current group
              when the program starts.

       label.default
              The default value for options label.group[0-3].  It defaults itself to the empty string.

       label.group[0-3]
              A  label  string  for the specified keyboard group.  The default is the value of label.default op‐
              tion.

       ignore.name
              Space- or tab-separated list of window names (WM_CLASS(res_name) property) that should be  ignored
              by xkbind.

       ignore.class
              Space-  or  tab-separated list of window classes (WM_CLASS(res_class) property) that should be ig‐
              nored by xkbind.

       ignore.reverse
              Specifies whether or not an "ignore list" in options ignore.name and ignore.class should be inter‐
              preted as an "accept list".  The default is "False".

       ignore.usewild
              Specifies whether or not symbols '*', '?' and '\' in the name and class lists should be interpret‐
              ed in the special way (like in the shell pattern matching).  The default is "True".

SIGNALS

       SIGALRM

       SIGVTALRM

       SIGHUP

       SIGPROF
              xkbind ignores these signals.

       SIGINT

       SIGTERM

       SIGABRT
              xkbind performs cleanup and normal exit.

ENVIRONMENT

       DISPLAY
              Default host and display number.

FILES

       xkbind reads configuration options from the following files in the order of priority:

       $HOME/.xkbindrc
              User's private configuration file.

       $HOME/.Xresources or $HOME/.Xdefaults
              User's X defaults file.

       /etc/local/lib/xkbind/app-defaults/Xkbind
              System-wide X defaults file.  The actual pathname may differ on your system.

BUGS

       Compount text encoding of international characters in label strings is not implemented.

AUTHORS

       Copyright (C) 2004 CHG

       This program is free software; you can redistribute it and/or modify it under the terms of the GNU Gener‐
       al Public License as published by the Free Software Foundation; either version 2 of the License,  or  (at
       your option) any later version.

       This  program  is  distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even
       the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General  Public
       License for more details.

       You  should have received a copy of the GNU General Public License along with this program; if not, write
       to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

Version 2010.05.20                                  Feb 2011                                           XKBIND(1)