GUIDE arch linux
✍️
Author
goshintai
🐧
OS
Arch Linux Β· Hyprland
πŸ‡―πŸ‡΅
Topic
Japanese input (fcitx5 + Mozc)
πŸ“
Type
tech guide
5 steps BEGINNER β–ˆ
Tags
linux arch hyprland japanese fcitx5 mozc guide
g
How to Install Japanese Keyboard on Arch (Hyprland + fcitx5 + Mozc)

So I recently needed to type in Japanese on my Arch Linux setup using Hyprland, and lemme tell you, it wasn't exactly plug and play. But once I figured it out, it was actually kinda straightforward. Here's a full step-by-step of what I did to get fcitx5 + Mozc working for Japanese input.

TL;DR
Install fcitx5-mozc, set environment variables, add Mozc in the fcitx5 GUI
…and don't forget to save hyprland.conf (yes, I forgot lol).
Step 1 β€” Install the necessary packages

Run the following:

sudo pacman -S fcitx5-mozc fcitx5-configtool fcitx5-gtk

This gives you:

πŸ“¦fcitx5 β€” the input method framework
πŸ“¦mozc β€” Japanese input engine by Google
πŸ“¦the GTK frontend + GUI config tool
Step 2 β€” Tell Hyprland to start fcitx5

Open your Hyprland config:

nano ~/.config/hypr/hyprland.conf

Add this under your existing exec-once entries:

exec-once = fcitx5 &

Don't be like me: I forgot to save the file before rebooting so fcitx5 didn't load on startup. Press Ctrl+O β†’ Enter to save, Ctrl+X to exit.

Step 3 β€” Add environment variables

Open your shell config:

nano ~/.bashrc

Add these at the bottom:

export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx
export XMODIFIERS=@im=fcitx

Then reload:

source ~/.bashrc

If you use zsh, put them in ~/.zshrc instead.

Step 4 β€” Reboot

After saving everything, reboot or log out and back into Hyprland. This should start fcitx5 automatically.

Step 5 β€” Add Japanese (Mozc) in fcitx5

Launch the config tool:

fcitx5-configtool

Then:

β–ΈOn the left panel, click "+" to add input method
β–ΈSearch for Mozc and add it
β–ΈMake sure it's below your default input method (like English)
β–ΈDefault toggle key is Ctrl + Space
Summaries
βœ…Set up the environment variables
βœ…Add fcitx5 to exec-once
βœ…Save your config file 😭

If you're using Arch with Hyprland and want to type Japanese, fcitx5 + mozc is solid. Let me know if you run into any issues!β–ˆ

arch Β· hyprland Β· japanese fcitx5 + mozc
← back to main