Repolode
Submit
mars-base

mars-base/rime-input-method-guide

A step-by-step guide for setting up the fcitx5 input method framework with the Rime engine and rime-ice (雾凇拼音) scheme on Debian and other Linux distributions.

View on GitHub
Stars
59
Forks
1
Open issues
0
Last commit
8 days ago

What is it?

This repository is a configuration guide for running the fcitx5 input method framework with the Rime engine on Debian 12/13 under GNOME Wayland. It covers removing ibus, installing fcitx5 packages, and writing the user-level files that matter: session environment variables, autostart entries, input method group profiles, and GTK injection.

Beyond setup, it documents the rime-ice (雾凇拼音) scheme: how to change the candidate count to 9 and switch output between simplified and traditional Chinese using Rime's *.custom.yaml override files, which survive git pulls. It also includes a Nord-Dark candidate window theme, daily maintenance commands, rollback steps, and a list of known limitations such as GNOME's native GTK4 apps not accepting fcitx5 input.

The guide notes that most steps are distribution-neutral for Ubuntu, Fedora, Arch and openSUSE, with only package names and package managers changing.

Key features

  • 01Covers removing ibus and installing fcitx5 with Rime on Debian, Fedora, Arch and openSUSE
  • 02Configures session environment variables and autostart for Wayland sessions
  • 03Adjusts rime-ice candidate count and simplified/traditional output via custom YAML overrides
  • 04Provides a Nord-Dark candidate window theme with setup steps
  • 05Lists maintenance commands, rollback steps and known GNOME Wayland limitations

Use cases

  • Setting up Chinese input on a Debian GNOME Wayland desktop
  • Replacing ibus with fcitx5 and Rime on a Linux machine
  • Customizing the rime-ice scheme without losing changes on updates

Quick start

  1. 1

    Install fcitx5 with Rime on Debian/Ubuntu

    sudo apt install fcitx5 fcitx5-rime fcitx5-frontend-gtk3 fcitx5-frontend-gtk4 fcitx5-frontend-qt5 fcitx5-config-qt
  2. 2

    Set fcitx5 as the input method framework

    im-config -n fcitx5
  3. 3

    Create the session environment variables file, then log out and back in

  4. 4

    Clone the rime-ice scheme into the fcitx5 Rime directory

    git clone --depth 1 https://github.com/iDvel/rime-ice.git ~/.local/share/fcitx5/rime

Things to know

  • Written for Debian 12/13 with GNOME on Wayland; other distributions are only described in outline.
  • On GNOME Wayland, some native GTK4 apps such as GNOME Text Editor may not accept fcitx5 input.

Topics

#input-method#fcitx5#rime#linux#debian#wayland#chinese-input#dotfiles

FAQ

What is rime-input-method-guide?
A step-by-step guide for setting up the fcitx5 input method framework with the Rime engine and rime-ice (雾凇拼音) scheme on Debian and other Linux distributions. This repository is a configuration guide for running the fcitx5 input method framework with the Rime engine on Debian 12/13 under GNOME Wayland. It covers removing ibus, installing fcitx5 packages, and writing the user-level files that matter: session environment variables, autostart entries, input method group profiles, and GTK injection.
Is rime-input-method-guide free to use? What license does it have?
rime-input-method-guide has no declared license. Its code is public, but without a license you have no explicit permission to reuse it; ask the author before relying on it.
Is rime-input-method-guide still maintained?
Actively maintained. The last commit to rime-input-method-guide was on Oct 11, 2026.
What can I use rime-input-method-guide for?
Setting up Chinese input on a Debian GNOME Wayland desktop Replacing ibus with fcitx5 and Rime on a Linux machine Customizing the rime-ice scheme without losing changes on updates
How do I install rime-input-method-guide?
Install fcitx5 with Rime on Debian/Ubuntu: sudo apt install fcitx5 fcitx5-rime fcitx5-frontend-gtk3 fcitx5-frontend-gtk4 fcitx5-frontend-qt5 fcitx5-config-qt Set fcitx5 as the input method framework: im-config -n fcitx5 Create the session environment variables file, then log out and back in Clone the rime-ice scheme into the fcitx5 Rime directory: git clone --depth 1 https://github.com/iDvel/rime-ice.git ~/.local/share/fcitx5/rime
Where can I get rime-input-method-guide?
The source code and installation instructions are on GitHub: https://github.com/mars-base/rime-input-method-guide

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects