Independent Omarchy Guide
System configuration

Chinese Input on Omarchy with Fcitx5, Rime, and CJK Fonts

Install, enable, and troubleshoot Fcitx5, Rime, Chinese input schemes, and CJK fonts on Omarchy and Wayland without breaking desktop shortcuts.

Reliable Chinese input on Omarchy requires three layers to work together: the input-method framework must be running, each application must connect to it, and the selected fonts must contain the required glyphs. Installing a Rime package alone does not fix candidate-window or missing-glyph problems.

Choose an input stack

NeedSuggested components
Pinyin, double pinyin, common Chinese methodsFcitx5 + Chinese Addons
Rime schemas and dictionary syncFcitx5 + Rime
Fix CJK characters rendered as boxesNoto CJK or Source Han fonts

Open the Omarchy menu with Super + Space, then use Install → Package to find fcitx5 and fcitx5-configtool. Add fcitx5-chinese-addons or fcitx5-rime for the desired method, and noto-fonts-cjk when CJK coverage is incomplete. Verify current names in the official Arch package search.

Review AUR sources

Dictionaries and themes not in the official repository may come from the AUR. AUR recipes are not vetted by the Arch team; inspect the PKGBUILD, source, maintenance history, and comments before installing.

Start Fcitx5 and add a method

After installation, open the Fcitx5 configuration tool:

  1. Confirm Fcitx5 starts with the graphical session.
  2. Add your keyboard layout and the intended Chinese method.
  3. Choose a language toggle that does not conflict with Omarchy hotkeys.
  4. Log out and back in so applications receive the new session environment.
  5. Test a browser, terminal, editor, and Electron application separately.

Do not paste every environment variable from an old tutorial into every startup file. GTK, Qt, Electron, and native Wayland support changes over time. Add session variables only when a specific application fails, following the current ArchWiki Fcitx5 guide.

Configure Rime and double pinyin

Make the default Rime schema work before adding a third-party schema, double-pinyin layout, or synchronized dictionary. Keep user configuration in the Rime user directory and back it up privately instead of editing package-managed files.

A recoverable workflow is:

  1. Back up the current Rime user directory.
  2. Add one schema or patch at a time.
  3. Redeploy Rime.
  4. Test both a normal text field and a terminal.
  5. Revert the last file when it fails instead of deleting every dictionary.

User dictionaries can contain names, addresses, and project terms. Review privacy before syncing them, and never attach the entire dictionary to a public support issue.

Set CJK fonts and fallback

Omarchy's Style → Font setting controls the main monospaced choice, while CJK prose still depends on fontconfig fallback. After adding fonts, verify:

  • simplified and traditional characters plus punctuation;
  • Nerd Font icons in the bar and terminal;
  • readable baselines and weights across scripts;
  • distinguishable full-width and half-width code characters;
  • expected rendering in PDFs and office files.

Do not remove system fonts to force a fallback. If priority must be fixed, create the smallest user-level fontconfig override and document why it exists.

Diagnose common failures

SymptomCheck first
No input-method iconWhether Fcitx5 runs in this graphical session
Icon exists but no inputMethod list, toggle, and application protocol support
Browser works, terminal failsTerminal and Wayland/input-method settings
Candidate popup is misplacedScaling, Electron/Wayland flags, and app version
CJK glyphs are boxesCJK package and fontconfig fallback
Update changed behavior.bak user overrides and current migration notes

Next, configure display, networking, and audio. Preserve evidence and follow the troubleshooting order for system-wide failures.

Sources: ArchWiki Fcitx5, ArchWiki Fonts, and Omarchy Fonts.

On this page