1 <chapter xmlns="http://docbook.org/ns/docbook"
2 xmlns:xlink="http://www.w3.org/1999/xlink"
3 xmlns:xi="http://www.w3.org/2001/XInclude"
5 xml:id="module-services-input-methods">
6 <title>Input Methods</title>
8 Input methods are an operating system component that allows any data, such as
9 keyboard strokes or mouse movements, to be received as input. In this way
10 users can enter characters and symbols not found on their input devices.
11 Using an input method is obligatory for any language that has more graphemes
12 than there are keys on the keyboard.
15 The following input methods are available in NixOS:
20 IBus: The intelligent input bus.
25 Fcitx: A customizable lightweight input method.
30 Nabi: A Korean input method based on XIM.
35 Uim: The universal input method, is a library with a XIM bridge.
40 Hime: An extremely easy-to-use input method framework.
49 <section xml:id="module-services-input-methods-ibus">
53 IBus is an Intelligent Input Bus. It provides full featured and user
54 friendly input method user interface.
58 The following snippet can be used to configure IBus:
63 <link linkend="opt-i18n.inputMethod.enabled">enabled</link> = "ibus";
64 <link linkend="opt-i18n.inputMethod.ibus.engines">ibus.engines</link> = with pkgs.ibus-engines; [ anthy hangul mozc ];
69 <literal>i18n.inputMethod.ibus.engines</literal> is optional and can be used
70 to add extra IBus engines.
74 Available extra IBus engines are:
80 Anthy (<literal>ibus-engines.anthy</literal>): Anthy is a system for
81 Japanese input method. It converts Hiragana text to Kana Kanji mixed text.
86 Hangul (<literal>ibus-engines.hangul</literal>): Korean input method.
91 m17n (<literal>ibus-engines.m17n</literal>): m17n is an input method that
92 uses input methods and corresponding icons in the m17n database.
97 mozc (<literal>ibus-engines.mozc</literal>): A Japanese input method from
103 Table (<literal>ibus-engines.table</literal>): An input method that load
104 tables of input methods.
109 table-others (<literal>ibus-engines.table-others</literal>): Various
110 table-based input methods. To use this, and any other table-based input
111 methods, it must appear in the list of engines along with
112 <literal>table</literal>. For example:
114 ibus.engines = with pkgs.ibus-engines; [ table table-others ];
121 To use any input method, the package must be added in the configuration, as
122 shown above, and also (after running <literal>nixos-rebuild</literal>) the
123 input method must be added from IBus' preference dialog.
126 <simplesect xml:id="module-services-input-methods-troubleshooting">
127 <title>Troubleshooting</title>
129 If IBus works in some applications but not others, a likely cause of this
130 is that IBus is depending on a different version of <literal>glib</literal>
131 to what the applications are depending on. This can be checked by running
132 <literal>nix-store -q --requisites <path> | grep glib</literal>,
133 where <literal><path></literal> is the path of either IBus or an
134 application in the Nix store. The <literal>glib</literal> packages must
135 match exactly. If they do not, uninstalling and reinstalling the
136 application is a likely fix.
140 <section xml:id="module-services-input-methods-fcitx">
144 Fcitx is an input method framework with extension support. It has three
145 built-in Input Method Engine, Pinyin, QuWei and Table-based input methods.
149 The following snippet can be used to configure Fcitx:
154 <link linkend="opt-i18n.inputMethod.enabled">enabled</link> = "fcitx";
155 <link linkend="opt-i18n.inputMethod.fcitx.engines">fcitx.engines</link> = with pkgs.fcitx-engines; [ mozc hangul m17n ];
160 <literal>i18n.inputMethod.fcitx.engines</literal> is optional and can be
161 used to add extra Fcitx engines.
165 Available extra Fcitx engines are:
171 Anthy (<literal>fcitx-engines.anthy</literal>): Anthy is a system for
172 Japanese input method. It converts Hiragana text to Kana Kanji mixed text.
177 Chewing (<literal>fcitx-engines.chewing</literal>): Chewing is an
178 intelligent Zhuyin input method. It is one of the most popular input
179 methods among Traditional Chinese Unix users.
184 Hangul (<literal>fcitx-engines.hangul</literal>): Korean input method.
189 Unikey (<literal>fcitx-engines.unikey</literal>): Vietnamese input method.
194 m17n (<literal>fcitx-engines.m17n</literal>): m17n is an input method that
195 uses input methods and corresponding icons in the m17n database.
200 mozc (<literal>fcitx-engines.mozc</literal>): A Japanese input method from
206 table-others (<literal>fcitx-engines.table-others</literal>): Various
207 table-based input methods.
212 <section xml:id="module-services-input-methods-nabi">
216 Nabi is an easy to use Korean X input method. It allows you to enter
217 phonetic Korean characters (hangul) and pictographic Korean characters
222 The following snippet can be used to configure Nabi:
227 <link linkend="opt-i18n.inputMethod.enabled">enabled</link> = "nabi";
231 <section xml:id="module-services-input-methods-uim">
235 Uim (short for "universal input method") is a multilingual input method
236 framework. Applications can use it through so-called bridges.
240 The following snippet can be used to configure uim:
245 <link linkend="opt-i18n.inputMethod.enabled">enabled</link> = "uim";
250 Note: The <xref linkend="opt-i18n.inputMethod.uim.toolbar"/> option can be
251 used to choose uim toolbar.
254 <section xml:id="module-services-input-methods-hime">
258 Hime is an extremely easy-to-use input method framework. It is lightweight,
259 stable, powerful and supports many commonly used input methods, including
260 Cangjie, Zhuyin, Dayi, Rank, Shrimp, Greek, Korean Pinyin, Latin Alphabet,
265 The following snippet can be used to configure Hime:
270 <link linkend="opt-i18n.inputMethod.enabled">enabled</link> = "hime";
274 <section xml:id="module-services-input-methods-kime">
278 Kime is Korean IME. it's built with Rust language and let you get simple, safe, fast Korean typing
282 The following snippet can be used to configure Kime:
287 <link linkend="opt-i18n.inputMethod.enabled">enabled</link> = "kime";