Install Funput with Fcitx5 on Linux
Four steps, about 10 minutes, with one sign-out. You need to open Terminal and know the password you sign in with. Already using IBus on GNOME?
Step 1: Install the Funput package
About 2 minutes. Run commands in Terminal.
Open Terminal from your application menu, select your Linux distribution below, and run the commands in order. If you already added the Funput repository, skip to Install the package.
Add the repository once.
sudo install -d /usr/share/keyrings
curl -fsSL https://repo.funput.app/funput.asc | sudo tee /usr/share/keyrings/funput.asc >/dev/null
sudo tee /etc/apt/sources.list.d/funput.sources >/dev/null <<'REPO'
Types: deb
URIs: https://repo.funput.app/deb
Suites: ./
Signed-By: /usr/share/keyrings/funput.asc
REPO
sudo apt update
Install the package.
sudo apt install funput
Use this list to find the commands for your distribution. Some distributions may lack a library that Funput needs. If the installation fails, see Troubleshooting.
Terminal asks for a password or says curl is missing
- When
sudoasks for a password, type your account password and press Enter. Terminal shows nothing while you type, which is normal. - If
curlis missing, install it from your distribution's software manager. - If your account has no administrator rights, install Funput for your account instead.
Step 2: Set up Fcitx5 for your desktop
About 3 minutes. Needs one sign-out.
1. Start Fcitx5 when you sign in.
mkdir -p ~/.config/autostart
cp /usr/share/applications/org.fcitx.Fcitx5.desktop ~/.config/autostart/
2. Configure Wayland. If ~/.config/environment.d/fcitx5.conf already exists, edit the two matching lines and keep your other settings instead of running the commands below. Leave GTK_IM_MODULE unset for this session.
mkdir -p ~/.config/environment.d
cat > ~/.config/environment.d/fcitx5.conf <<'CONF'
XMODIFIERS=@im=fcitx
QT_IM_MODULE=fcitx
CONF
3. Install the Kimpanel extension as well. Without the Input Method Panel extension, the Fcitx5 box that shows the word you are typing may not appear, for example in WPS Office or the GNOME search field.
Using sway? Set it up in sway's startup configuration, then do step 2 above.
1. Enable Fcitx5 in KDE. Open System Settings → Virtual Keyboard and select Fcitx 5.
2. Set XMODIFIERS. If ~/.config/environment.d/fcitx5.conf already exists, edit only its XMODIFIERS line instead of running the commands below.
mkdir -p ~/.config/environment.d
cat > ~/.config/environment.d/fcitx5.conf <<'CONF'
XMODIFIERS=@im=fcitx
CONF
KDE Wayland only needs this line. If you set GTK_IM_MODULE or QT_IM_MODULE for the whole session, remove the old settings before signing back in.
Debian, Ubuntu, Linux Mint or Pop!_OS. This tool selects Fcitx5 and starts it for your session.
im-config -n fcitx5
If the tool is missing, run sudo apt install im-config and try again.
Fedora. This package configures X11 and starts Fcitx5 when you sign in.
sudo dnf install fcitx5-autostart
Arch, openSUSE or a distribution without its own tool. Do both steps below, even on GNOME or KDE.
Step 1. Start Fcitx5 when you sign in. On GNOME, KDE, Xfce and other desktops that read the autostart folder, run:
mkdir -p ~/.config/autostart
cp /usr/share/applications/org.fcitx.Fcitx5.desktop ~/.config/autostart/
For window managers with their own startup settings, use that desktop's autostart method.
Step 2. Tell apps to use Fcitx5. Add these lines to the right login profile.
export XMODIFIERS=@im=fcitx
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx
Not sure whether you use X11 or Wayland?
Open Terminal and run both lines:
echo "$XDG_SESSION_TYPE"
echo "$XDG_CURRENT_DESKTOP"
- Line 1 says
x11: pick Other desktops or X11, whether you use GNOME or KDE. - Line 1 says
wayland: look at line 2. For example,ubuntu:GNOMEis GNOME andKDEis KDE Plasma.
If the result is blank or says tty, open Terminal from the application menu of your graphical desktop and try again. Using another Wayland desktop? See the setup for each compositor.
Sign out and back in
Save your work, then sign out of the Linux desktop and back in so the new settings load. If the settings still don't apply
Step 3: Add Funput to Fcitx5
About 1 minute.
Find Fcitx 5 Configuration in your application menu, or run fcitx5-configtool in Terminal. On KDE, this window lives in System Settings and has an Add Input Method button that opens the list of input methods.
Select Funput from the Fcitx5 icon near the clock. While Vietnamese typing is on, the icon is the colored Funput logo. When it is off, the logo turns white. Press Ctrl + ` to turn Vietnamese typing on or off. You can change this shortcut in Funput → Phím tắt (Shortcuts).
Step 4: Try typing Vietnamese
Open the Funput app to choose Telex or VNI. Then open a text editor and type along with the animation below.
Type the keys tieengs, then press Space, and Funput produces tiếng.
Letters appear straight in your text as you type. Some apps underline the unfinished word until you press Space.
If you still get letters without accents, check that Funput is selected in Fcitx5 and that Vietnamese typing is on. If it still doesn't work, see what to check when Funput doesn't type Vietnamese.
Customize Funput after installing
- See the Telex and VNI guide for which key adds which mark.
- If you often mix in English words, you can turn on Lật từ (word flip) in Funput → Phím tắt (Shortcuts). With Telex, for example, it switches the word you are typing between
máandmasbefore you press Space. - Funput keeps its settings in
~/.config/Funput/settings.json. Changes made in the Funput app take effect right away, without restarting the input method. - Letters go straight into the text field. In apps that cannot take that, Funput falls back to showing the unfinished word underlined. Why is the word I'm typing underlined?
Update Funput
If you installed from the repository, new Funput releases arrive with your system updates. If you update from Terminal, run only the line for your distribution.
sudo apt update && sudo apt upgrade funput # Debian / Ubuntu
sudo dnf upgrade funput # Fedora
sudo zypper update funput # openSUSE
sudo pacman -Syu # Arch (updates the whole system)
If the input method misbehaves after an update, sign out and back in.