# Uim/Setup

uim | Introduction | Installation | Setup | Usage | Configuration | Support | Manuals | Development License

## Set environment variables

To use uim, you need to set a few environment variables, and optionally start some of the bridges (uim-xim, uim-fep).
In your X session initiation script (this may be ~/.xinitrc, ~/.xsession or ~/.gnomerc depending on your system), set
and you should be able to use uim in all GTK+ and Qt applications.

## Select a default input method

By default, uim starts up the direct input method (that passes everything unmodified back to the application). To change this you will need to specify a default input method.

### Configuration file

Put
in your ~/.uim configuration file. You can get a list of allowed <im-name>s by running

### Graphical configuration tool

* Run uim-pref-gtk or uim-pref-qt.
* Select the "Global settings" group.
* In the "Input method deployment" section, check "Specify default IM" and choose the one you want from the list.
The list includes only enabled IMs. If the one you want isn't in the list, you may need to press the "Edit" button in by the "Enabled input methods" field in the "Input method deployment" section.
If you cannot find your favorite IM in the list of enabled input methods, please check that you have it installed.

## The XIM (X Input Method) protocol

For non-GTK/Qt applications (through the XIM protocol) run
from your X session initiation script so that you have an instance running when you enter the X windows system.
    For further details, refer to uim-xim documentation.
    Freedesktop.org site: http://uim.freedesktop.org/wiki/UIM_2dXIM.

## Virtual terminals

If you choose not to run uim-xim (the GTK and Qt bridges should work for most every application available in X) or need it in console, you can use the uim Front End Processor (FEP) bridge. Start it by running
You will see an indicator in the bottom line of the terminal showing which input method is in use and which mode it is in.
    For more, see: uim-fep
    Freedesktop.org site: http://uim.freedesktop.org/wiki/UIM_2dFEP.

## Emacs

    For more, see: uim-el.
    Freedesktop.org site: http://uim.freedesktop.org/wiki/UIM_2dEL.

## Toolbars

Uim comes with a few tools to control the active conversion engine and some of its options. These are on toolbars that you may just be able to integrate into your desktop environment.
The tools are:
* uim-toolbar-gtk
* uim-toolbar-gtk-systray
* uim-toolbar-qt
* uim-toolbar-qt4 (>= uim 1.5.7)
If you use GNOME, you should probably use the ones with "gtk" in the name, and KDE users would be advised to use the "qt" or "qt4" one. GTK+ and Qt are the widget toolkits that GNOME and KDE are written in, so this will ensure a consistent look and feel). Aside from that, the toolbars should be environment independent and you can use them regardless of which graphical environment you use.
As for now, you just have to play around with these as there is no further documentation for these (sorry).
    A useful resource is the Uim-toolbar page on the Japanese Anthy/Uim wiki.
You can pass a positional argument to uim-toolbar-gtk.
will place the toolbar at 200 pixels from the left and 100 pixels from the bottom. Change the sign to change from which edge the pixels count.

## References

* ↑ System Configuration for uim