From ArchWiki
Revision as of 03:11, 22 November 2012 by Hippo (Talk | contribs) (Installation)

Jump to: navigation, search

FCITX (Flexible Input Method Framework) is a input method framework aiming at providing environment independent language support for Linux.


fcitx can be installed with Pacman from the [community] repository.

Using FCITX to Input

Before you can make use of FCITX for input, you have to setup some environment variables. It is quite simple.

  • Opening the .xprofile (or .profile depending on the desktop environment and display manager you are using) file in your home directory and add following lines:
 #setup XIM environment
 export GTK_IM_MODULE=xim
 export QT_IM_MODULE=xim
 export XMODIFIERS="@im=fcitx"

Since 4.1.0, Fcitx provides it's own input method module, fcitx-gtk2, fcitx-gtk3, and fcitx-qt. It's recommend to use input method module instead of xim directly, in order to resolve strange bugs brought by XIM.

You can set corresponding environment variables

 export GTK_IM_MODULE=fcitx
 export QT_IM_MODULE=fcitx
  • Re-login to make such environment effective.

If you are using any XDG compatible desktop environment such as KDE, GNOME, XFCE, LXDE, after you relogin, the autostart should work out of box. If not, open your favorite terminal, type:


To see if fcitx is working correctly, open an application such as leafpad and press CTRL+Space(the default shortcut for switching input method) to invoke FCITX and input some words.

If everything goes well, you may want to add fcitx to your .xinitrc file (see xinitrc) if the xdg autostart doesn't work for you:

 fcitx -r



Fcitx provides GUI configure tool since version 4.0. You can install either kcm-fcitx(based on kcm), fcitx-configtool(based on gtk3), or fcitx-configtool-gtk2AUR(based on gtk2, unsupported) from AUR. Editing the configure file manually is possible but is not supported anymore and may cause trouble.

Desktop Environment Integration


You can install gnome-shell-extension-kimpanel-gitAUR package in AUR, which provides a similar user experience as ibus-gjs.


You can install kcm-fcitx and kdeplasma-addons-applets-kimpanel.

kcm-fcitx is a kcontrol module for fcitx.

kdeplasma-addons-applets-kimpanel is a plasmoids, that provides native feeling under kde desktop. Simply add kimpanel to plasma and fcitx will automatically switch to it without extra configuration.

Install other components of fcitx

All components of fcitx will requires fcitx to restart after install.

Keyboard layout integration

fcitx-keyboard is now built-in supported. Open a configuration tool (kcm-fcitx or fcitx-configtool mentioned above), you might want to uncheck the "Show only current language" and find your keyboard layout.

In order to enable spell checking, press ctrl + alt + h when fcitx is on a input method provides by fcitx-keyboard. Then that's it, you can type long word, to see whether it works.

Chinese Input

fcitx built-in provides fcitx-pinyin and fcitx-table inside fcitx package, which supports Pinyin and table-based input method, for example, Wubi.

If you want better support for pinyin, you can install, fcitx-cloudpinyin, fcitx-sunpinyin, or fcitx-libpinyin.

If you need Bopomofo support, you can install fcitx-chewing or fcitx-libpinyin.

If you need Cangjie, Zhengma, Boshiamy support, you can install fcitx-table-extraAUR in AUR.

Japanese Input Method

Install fcitx-anthy or mozc-fcitxAUR in AUR.

Korean Input Method

Install fcitx-hangulAUR in AUR.

Other language

m17n provides quite a long other language support, you can install m17n support for fcitx with fcitx-m17nAUR in AUR.


CTRL+Space does not work

If you cannot invoke FCITX by pressing the CTRL+Space keyboard combination, but FCITX runs in background without problem, please check your locale, and make sure your locale is un-commented in /etc/locale.gen. After that it seems that by simply change LC_CTYPE to zh_CN.UTF-8 (or probably any Chinese locale) will get it done for Chinese input.

See also