Skip to main content

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.

Distribution family

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 sudo asks for a password, type your account password and press Enter. Terminal shows nothing while you type, which is normal.
  • If curl is 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.

The Linux desktop you use
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:GNOME is GNOME and KDE is 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.

  1. Clear this box to see other languages.
  2. Type funput in the search box, then select Funput.
  3. Click the arrow button to move Funput into the left column.

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

Can't find Funput in the list?

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á and mas before 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.