Description
===========

The XkbInd program (X Keyboard Extension Indicator) is a minimal
indicator of keyboard layout (XKB group) for the X Window System; it
indicates current keyboard layout in the title of top-level windows via
prefix to the original string.  It also allows to simulate independent
keyboard layout for each handled window and it works with most of the
window managers, including twm, mwm and fvwm.


Main Features
=============

  1. XkbInd simulates independent keyboard layout for each handled
     top-level window.

  2. XkbInd is very light-weight and uses less than 150 kb of virtual memory
     (excluding "shared", of course).

  3. XkbInd doesn't grab entries in the default color pallet, doesn't
     perform any drawing operations on the X display itself, but relies wholly
     on the window manager.

  4. XkbInd doesn't occupy any area on the screen, and outputs all relevant
     information to the window title.

  5. XkbInd can be configured to ignore (or accept) particular windows or
     applications.  This feature is based on examination of WM_CLASS property.
     It is possible to use wildcards in the "ignore" and "accept" lists.

  6. XkbInd is a "true" XKB program, i.e. all interactions with the X-server
     are carried out through XKB extension protocol.

  7. XkbInd keeps current layout of window at the server side as window
     property, unlike the most other similar programs which keep this data
     in the internal storage.

  8. And the last, XkbInd does only what it says -- it is an indicator.
     Nothing more.


Installation
============

Firstly, you should download and unpack distribution archive:

  $ tar xvzf xkbind-<version>.tar.gz

To install XkbInd you should perform the following:

  $ cd xkbind-<version>
  $ ./configure
  $ make
  # make install (as root)

For details, see INSTALL file.


Configuration
=============

The program is highly configurable; it accepts many options most of which
can be specified either on the command line, in the user's or system-wide
configuration files.  These files use standard X resources notation.
For details use "man xkbind".


Using
=====

The best place to run XkbInd is from ~/.xsession or  ~/.xinitrc.  Add the
line "xkbind" to one of these files just before "exec" of window manager.


Similar Programs
================

  1. FvwmKb <http://sourceforge.net/projects/fvwmkb>--XKB support module
  for FVWM window manager.

  2. xxkb <http://www.tsu.ru/~pascal/other/xxkb>--Another XKB indicator
  with pixmap support.


Contacts
========

Internet: http://xkbind.sf.net
E-mail: smersh@users.sf.net
