From ArchWiki
Jump to navigation Jump to search

Fcitx5 is the successor of Fcitx.


Install the fcitx5 package.

fcitx5-im group provides fcitx5 ontology, #Configuration tool, and all #Input method module except fcitx5-qt4-gitAUR.

Note: fcitx5 just give a basic framework, it just give a English support, if you want input other language, such Chinese or Japanese, you need a Input method engine.



  • fcitx5-anthy, a popular Japanese input engine. However, it is not actively developed anymore.
  • fcitx5-mozc, based on Mozc, the Open Source Edition of Google Japanese Input.
  • fcitx5-skk, a Japanese Kana Kanji input engine, based on libskk.

Other languages

Input method module

To obtain a better experience, you should install the following modules as you need, without them, the input method may work on most applications but you may experience input method hang up, preview window screen location error or no preview error.

Tip: Generally, install fcitx5-qt and fcitx5-gtk can handle all the occasion.


Set environment variables for IM modules

To enable Fcitx5 normally in the program, you must set the following environment variables and log in again:


Desktop Environment Autostart

Note: The location of the Fcitx5 startup file has changed, and it is currently /usr/share/applications/fcitx5.desktop.

If you want fcitx5 autostart when you start your desktop, please see Fcitx#Desktop Environment Autostart


Configuration tool

The configuration file of fcitx5 is located at ~/.local/share/fcitx5. Although you can use a text editor to edit the configuration file, it is obviously more convenient to use the GUI configuration. Install the fcitx5-configtool package.


The warehouse's themes are very less, you can find more theme at GitHub.

Tip: If you are using KCM, then switch themes by: Setting -> Location -> input method -> Configure addons -> Classic user interface -> Theme.


Diagnose problems

If you have problems using fcitx5, eg. Ctrl+Space fail to work in all applications, then the first thing you should try is to diagnose using fcitx5-diagnose. The output of fcitx5-diagnose should contain the clue to most common problems.

The newest wps cannot use fcitx5

See WPS Office#Fcitx5 cannot input Chinese.

Fcitx5 has a error position in intellij IDEs

Some java applications cannot get position exactlly, Fcitx5 cannot fix this problem [2].

Emoji show abnormal at candidate box

1. Confirm you have install a font with Emoji. ( Such as noto-fonts-emoji )

2. Set system font as Noto Sans CJK SC( For Simplified Chinese )

3. Use this command to reboot Fcitx5 :

# kill `ps -A | grep fcitx5 | awk '{print $1}'` && fcitx5&

Tips and tricks

How to view the Unicode encoding of selected characters

  • If you need to view the Unicode encoding of the selected text in the text editor, then directly select the text, and then use the shortcut keys ctrl + alt + shift + u to view the encoding of the selected text.
  • If you need to view the Unicode encoding of the text in the non-editing area (such as this wiki), you need to first copy the text to the clipboard, then click on any editable area (such as the search box), and then use the shortcut keys ctrl + alt + shift + u can view the encoding of the text in the clipboard.

Input special character

In general, for some simple symbols, such as , ā, á, ©, etc., you can enter through Configuring compose key, but for more special symbols, such as , , , etc., you Either customize ~/.XCompose, or use Fcitx5's Unicode function to achieve.

Take as an example:

Position the cursor in any input box, and then press Ctrl + Alt + Shift + U, and then enter circle one, you will see a variety of , other special characters are similar here.


The user data directory is ~/.local/share/fcitx5/rime/.

Note: The following example takes luna_pinyin as an example, please refer to the modification for other input schemes.

Greek letters

Add the following code to the luna_pinyin.custom.yaml or custom input scheme file

    # Use / as the identifier here
    # You can freely replace your favorite identifiers (such as: `~, .\; etc., characters that need not be displayed directly on the screen)
    # Replace the / before the Greek letter at the same time
    punct: "^/([0-9]0?|[A-Za-z]+)$"
    # Here, the letter name is used as the code of the Greek letter, and you can replace it with your favorite code as needed.
    # For example, if you want to use a as the alpha code
    # just replace the alpha below with a
    "/alpha": ["Α", "α"]
    "/beta": ["Β", "β"]
    "/gamma": ["Γ", "γ"]
    "/delta": ["Δ", "δ"]
    "/epsilon": ["Ε", "ε"]
    "/zeta": ["Ζ", "ζ"]
    "/eta": ["Η", "η"]
    "/theta": ["Θ", "θ"]
    "/iota": ["Ι", "ι"]
    "/kappa": ["Κ", "κ"]
    "/lambda": ["Λ", "λ"]
    "/mu": ["Μ", "μ"]
    "/nu": ["Ν", "ν"]
    "/xi": ["Ξ", "ξ"]
    "/omicron": ["Ο", "ο"]
    "/pi": ["Π", "π"]
    "/rho": ["Ρ","ρ"]
    "/sigma": ["Σ", "σ", "ς"]
    "/tau": ["Τ", "τ"]
    "/upsilon": ["Υ", "υ"]
    "/phi": ["Φ", "φ"]
    "/chi": ["Χ", "χ"]
    "/psi": ["Ψ", "ψ"]
    "/omega": ["Ω", "ω"]

Take output α as an example, just input /alpha.