Set environment variables
To use uim, you need to set a few environment variables, and optionally start some of the bridges (
In your X session initiation script (this may be
~/.gnomerc depending on your system), set
export GTK_IM_MODULE='uim' # Instructs the GTK immodule to use uim export QT_IM_MODULE='uim' # Instructs the Qt immodule to use uim export XMODIFIERS='@im=uim' # Instructs XIM to use uim
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.
(define default-im-name '<im-name>)
~/.uim configuration file. You can get a list of allowed
<im-name>s by running
Graphical configuration tool
- 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 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.
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.
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-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
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.