Setting Up Japanese Input on Fedora KDE with Fcitx5 and Mozc

After moving to Fedora KDE, one of the first things I wanted to fix was Japanese input.

My goal was not only to install Mozc, but also to make the conversion keys feel closer to what I was used to on macOS:

• Henkan enables the IME
• Muhenkan disables the IME

This article documents the setup I used with Fcitx5 + Mozc.

Install Fcitx5 and Mozc

On Fedora, install the required packages with:

sudo dnf install -y fcitx5-mozc fcitx5-configtool

Enable Fcitx5 in KDE

Open KDE System Settings and go to the keyboard / virtual keyboard settings.

Select Fcitx 5, or the Fcitx 5 Wayland launcher depending on your environment, and apply the change.

After logging out and back in, Fcitx5 should start as your input method framework.

Add Mozc

Open the Fcitx5 configuration tool:

fcitx5-configtool

Add Mozc to the list of available input methods.

If the keyboard layout is detected incorrectly, verify that the underlying keyboard layout matches your physical keyboard before adjusting IME shortcuts. Otherwise, a shortcut problem can actually be a layout problem.

Mac-like conversion key behavior

For Japanese keyboards, the Henkan and Muhenkan keys are convenient dedicated switches.

I configured them so that:

• Henkan activates Japanese input
• Muhenkan returns to direct input

This avoids using a single toggle key and makes the current IME state more predictable.

That small change made Fedora much more comfortable for daily development because I no longer had to wonder whether the next keystroke would be interpreted as Japanese or ASCII.

Why I prefer explicit on/off keys

Toggle shortcuts are compact, but they depend on remembering the current state.

Separate on/off shortcuts are more deterministic:

Henkan   -> IME ON
Muhenkan -> IME OFF

For programming, this is especially useful because switching from Japanese prose back to symbols, identifiers, and shell commands happens constantly.

Closing thoughts

Fcitx5 + Mozc works well on Fedora KDE once the desktop integration and keyboard shortcuts are configured.

The installation itself is simple; the quality-of-life improvement comes from tuning the input method to your keyboard habits.

If you are moving from macOS or another environment where dedicated IME on/off keys are part of your muscle memory, mapping Henkan and Muhenkan explicitly is worth trying.