Skip to main content

Troubleshooting

Open the section that matches what you see. The funput package is for Fcitx5, and the funput-ibus package is for IBus.

Funput is missing from the input method list

Fcitx5

  1. Open Fcitx 5 Configuration, click +, and clear Only Show Current Language. Look for Funput under Vietnamese.
  2. If the settings window does not open, look for fcitx5-config-qt on Debian or Ubuntu. On Fedora, openSUSE, and Arch Linux, look for fcitx5-configtool in the package manager.
  3. If Funput still does not appear, check the Funput app for setup guidance. Log out and back in. To see whether Fcitx5 has loaded Funput, run fcitx5-diagnose in Terminal.

IBus on GNOME

  1. Go to Settings → Keyboard → Input Sources, choose + or Add Input Source, then look for Vietnamese → Funput.
  2. If Funput is still missing, check that funput-ibus is installed. Run ibus restart in Terminal, then reopen Settings. You can also log out and back in to reload it.

Add Funput to IBus

Funput is on, but Vietnamese accents are missing

Open a text editor and turn on Vietnamese typing in Funput. Type the keys for the input style you selected in the Funput app, then press Space.

  • Telex tieengs → tiếng
  • VNI tie61ng → tiếng
  • It happens in every app. For Fcitx5, check your X11 or Wayland settings, then log out and back in to apply them. Run fcitx5-diagnose to see which settings are active. For IBus, check the GNOME input source.
  • It happens in just one app. If the same keys work in the text editor, check the settings for the affected app first. This is especially useful for Qt or XWayland apps.
Text is underlined or hidden in WPS Office

Press Space to finish the word. If it appears correctly, the underline or hidden text is how the app handles words you are still typing. This is called preedit. You may see an underline in Terminal, in certain text fields, or on the first word after switching windows. Funput selects the typing behavior for each app.

WPS Office can hide the word until you press Space. With Fcitx5, Funput can show the unfinished word in a separate panel. With IBus, press Space to see the finished word in WPS.

If the first word is incorrect or the underline persists after Space, note the app name, the keys you pressed, and the app's process name if you know it. What to include in a bug report

APT reports a missing dependency
  • Installing from a .deb file. Check that the Funput input method package and funput-settings have the same version and architecture. Include both in the same install command. Run dpkg --print-architecture to check whether you need amd64 or arm64. Choose packages from GitHub Releases
  • Installing from the Funput repository. Run sudo apt update and try again. If the error remains, note the missing package and version. Older Linux releases may lack the version of a library Funput needs. What to include in a bug report
Two input methods receive the same keystrokes

Check whether Fcitx5 and IBus are active in the same session. You can keep both packages installed and use one framework at a time. Turn off autostart or undo the setup for the framework you are not using, then log out and back in. See how Fcitx5 starts at login

Repository and bug reports​

Remove the Funput repository

Installed packages stay on your computer. Removing the repository stops updates from this source. Run only the commands for your distribution.

Debian or Ubuntu. The second command removes the entry used by the older guide.

sudo rm -f /etc/apt/sources.list.d/funput.sources
sudo rm -f /etc/apt/sources.list.d/funput.list
sudo apt update

Fedora

sudo rm /etc/yum.repos.d/funput.repo

openSUSE

sudo zypper removerepo funput

Arch Linux. Open /etc/pacman.conf with administrator access, remove the [funput] section and its Server line, then remove the repository key.

sudo pacman-key --delete [email protected]
What to include in a bug report
  • Your Linux distribution, desktop, whether you use Fcitx5 or IBus, and the step where the error occurs.
  • The app name and version if only one app is affected. Include the keys you pressed if they help reproduce the problem.
  • For Fcitx5, the relevant part of the fcitx5-diagnose output. Review it before sharing.

Report a Funput issue on GitHub