LinuxCommandLibrary
GitHubF-DroidGoogle Play Store

im-config

configures input method framework for Linux desktops

TLDR

Configure input method interactively
$ im-config
copy
Configure using a console dialog instead of a GUI
$ im-config -c
copy
List installed input method frameworks
$ im-config -l
copy
Set input method framework non-interactively
$ im-config -n [ibus|fcitx5|xim|none]
copy
Show current configuration values
$ im-config -m
copy
Remove the user configuration file
$ im-config -n REMOVE
copy

SYNOPSIS

im-config [options]

DESCRIPTION

im-config configures the input method framework for Linux desktops. It selects between IBus, Fcitx 5, XIM and other input systems and writes the choice to ~/.xinputrc (or /etc/X11/xinit/xinputrc system-wide).Without options it shows a dialog listing available frameworks, marking the automatic choice for the current locale. The selected framework is started by im-launch when the X session starts, setting variables such as GTK_IM_MODULE, QT_IM_MODULE and XMODIFIERS.

PARAMETERS

-a

List all possible input method frameworks, even if their packages are not installed.
-c
Use console dialog (whiptail).
-x
Use X dialog with zenity.
-s
Simulate; show what would happen without changing configuration files.
-l
List available input method frameworks to stdout (only installed ones unless -a is given).
-m
List configuration values: active system/user configuration and automatic/override choice for the current locale.
-n METHOD
Set the input method framework. none activates nothing and uses the desktop default; REMOVE deletes the configuration file.
-o METHOD
Print the localized description of an input method.
-h
Display help information.

CAVEATS

Debian/Ubuntu tool. A logout or session restart is needed for changes to take effect. im-config 1.0 (July 2026) dropped Wayland support and replaced the options with a debugging-oriented set: -p (list possible), -i (list installed), -d (defaults), -r (report current values), -w METHOD (write configuration), -c, -q, -v. On Wayland sessions (GNOME, KDE Plasma) the desktop usually configures the input method itself. Problems can be inspected with journalctl -b -t im-config.

HISTORY

im-config was written by Osamu Aoki for Debian as a replacement for the older im-switch tool, and is maintained by the Debian Input Method Team.

SEE ALSO

im-launch(1), ibus(1), fcitx5(1), fcitx(1)

RESOURCES

Copied to clipboard
Kai