- 1 Installation
- 2 Using FCITX to Input
- 3 Configuration
- 4 Autostart with desktop
- 5 Install other components of fcitx
- 6 Troubleshooting
- 7 See also
Pacman from the [extra] repository.can be installed with
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
.xprofileor (.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,, , and . 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:
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.
.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 AUR. Editing the configure file manually is possible but is not supported anymore and may cause trouble.AUR(based on kcm), AUR(based on gtk3), or AUR(based on gtk2, unsupported) from
Autostart with desktop
You can install AUR, which provides a similar user experience as ibus-gjs.AUR package in
You can install AUR and .AUR package in
is a kcontrol module for fcitx.
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 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
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 (AUR or AUR 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.
If you want better support for pinyin, you can install, AUR.AUR, AUR, AUR or AUR, all in
Japanese Input Method
Install AUR.AUR in
Korean Input Method
Install AUR.AUR in
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.