Difference between revisions of "Fcitx"

From ArchWiki
Jump to navigation Jump to search
Line 45: Line 45:
You can install {{AUR|fcitx-configtool}} package in [[Arch User Repository|AUR]], which provides a GTK3 GUI to configure fcitx.
Fcitx provides GUI configure tool since version 4.0. You can install either {{AUR|kcm-fcitx}}(based on kcm), {{AUR|fcitx-configtool}}(based on gtk3), or {{AUR|fcitx-configtool-gtk2}}(based on gtk2, unsupported) from [[Arch User Repository|AUR]]. Editing the configure file manually is possible but is not supported anymore and may cause trouble.
==Autostart with desktop==
==Autostart with desktop==

Revision as of 23:56, 16 October 2012

zh-CN:Fcitx FCITX (Free Chinese Input Toy of X) is a input method framework aiming at providing environment independent language support for Linux.


fcitx can be installed with Pacman from the [extra] 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.

  • Open the .xprofile or (.profile?) 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 brings XIM.

You can set corresponding environment variables

 export GTK_IM_MODULE=fcitx
 export QT_IM_MODULE=fcitx

In order to use Fcitx input methdo module, you also need DBus startup correctly.

  • Re-login to make such environment effective.

After you re-login, open your favorite terminal, type:

  fcitx &

To see if fcitx is working correctly, open an application such as leafpad and press CTRL+Space to invoke FCITX and input some words.

If everything goes well, you may want to start FCITX automatically whenever you start X.

Open the .xinitrc file (see xinitrc) in your home directory, add line before starting your WM:

 killall fcitx
 fcitx &

That is it.

If you use any type of XDM (gdm for example), you should set up such environment in ~/.profile instead of above two files.



Fcitx provides GUI configure tool since version 4.0. You can install either kcm-fcitxAUR(based on kcm), fcitx-configtoolAUR(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.

Autostart with desktop

Gnome-Shell Integration

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

KDE Integration

You can install kcm-fcitxAUR package in AUR 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.

XDG compatible environment

You can copy /usr/share/applications/fcitx.desktop to ~/.config/autostart/, under KDE, GNOME, XFCE, , LXDE, or any other XDG compatible environment.


You can put fcitx inside your .xinitrc, and set corresponding environment variable mentioned above in ~/.xinitrc.

If you want use input method module, make sure dbus is started before you start everything, if you are not sure, add

 eval `dbus-launch --sh-syntax --exit-with-session`

to the head of .xinitrc.

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-fcitxAUR or fcitx-configtoolAUR mentioned above), you might want to uncheck the "Show only current language" and find your keyboard layout.

If you want to runtime spell checking when typing, you can install aspell-* or hunspell-* package. 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-cloudpinyinAUR, fcitx-sunpinyinAUR, fcitx-libpinyinAUR or fcitx-googlepinyinAUR, all in AUR.

If you need Bopomofo support, you can install fcitx-chewing-gitAUR or fcitx-libpinyinAUR in AUR.

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

Japanese Input Method

Install 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.

See also