# oh-my-rime: A Ready-to-Use Rime Input Method Configuration for Chinese Text Entry

> oh-my-rime (also called Mint Input or 薄荷输入法) is a pre-configured template for the Rime input method framework that ships seven input schemes, two built-in themes, and a large word library. It targets Chinese-language users on macOS, Windows, Linux, and mobile who want a working Rime setup without building one from scratch.

**Mintimate/oh-my-rime** — The Simple Config Template Of Rime By Mintimate.  

- Repository: https://github.com/Mintimate/oh-my-rime
- Website: https://www.mintimate.cc
- Stars: 4,953 · Forks: 317
- Language: Lua
- License: GPL-3.0
- Published: 2026-09-23 · Updated: 2026-09-23 · Language: en
- Canonical page: https://hysenlabs.com/projects/mintimate-oh-my-rime

## What oh-my-rime Is and Who It Targets

Rime is a cross-platform input method framework that can be configured to support virtually any Chinese input scheme. Its flexibility comes at a cost: a fresh Rime installation does nothing useful until you supply configuration files, schema definitions, and word libraries. oh-my-rime fills that gap. The repository name draws from oh-my-zsh, and the README describes the same intent: providing the experience of omz for Rime users.

The project ships under two names. "oh-my-rime" is the repository name. "薄荷输入法" (Mint Input) is the brand name used in documentation and the community. Both refer to the same set of configuration files.

The primary audience is Chinese-language users on any platform where Rime runs: macOS (via Squirrel or Fcitx5 macOS), Windows (via Weasel), Linux (via iBus-Rime or Fcitx5), and Android (via Fcitx5 Android, known as 小企鹅输入法). iOS users can use the nine-key input scheme with the Hamster app. Rime itself is a prerequisite; oh-my-rime does not bundle or install Rime.

## The Seven Input Schemes and What Distinguishes Each

oh-my-rime ships seven distinct input schemes that activate through a single Rime installation:

- 薄荷拼音-全拼输入: Standard full pinyin, the default scheme after installation. This covers the widest user base.
- 小鹤双拼-薄荷定制: Xiaohe double pinyin, customized to support 形码 (shape codes), 自然码 auxiliary codes, and 墨奇 auxiliary codes as supplementary input.
- 薄荷拼音-小鹤混输: A hybrid that accepts both full pinyin and Xiaohe double pinyin simultaneously.
- 地球拼音-薄荷定制: Terra Pinyin customized with an extended word library.
- 五笔98-五笔小筑: A simplified version of 98wubi, the 1998-standard Wubi table.
- 五笔86-极点五笔: A simplified version of the 86-standard Wubi based on the wubi86-jidian code table.
- 仓九宫格-全拼输入: A nine-key grid layout for pinyin input on iOS via the Hamster app.

Switching between schemes at runtime uses Ctrl+~. The default active scheme after deployment is 薄荷拼音-全拼输入. The Wubi schemes included here are described as simplified versions; the README recommends using the upstream 98wubi and rime-wubi86-jidian repositories for users who want the full Wubi experience with mixed Wubi-pinyin input.

## Installation: Copy Files, Redeploy Rime

Installation follows the same steps on Linux, macOS, and Windows:

1. Install Rime and log out or restart the computer.
2. Download all configuration files from this repository to the local Rime configuration directory.
3. Redeploy Rime.
4. Start using the default scheme.
5. Customize as needed.

The configuration directory path differs by platform and Rime frontend:

- Windows (Weasel): %APPDATA%\Rime
- macOS (Squirrel): ~/Library/Rime
- macOS (Fcitx5 macOS): ~/.local/share/fcitx5/rime
- Linux (iBus): ~/.config/ibus/rime
- Linux (Fcitx5): ~/.local/share/fcitx5/rime
- Android (Fcitx5): /storage/emulated/0/Android/data/org.fcitx.fcitx5.android/files/data/rime/

For users who have trouble reaching GitHub, the repository maintains a mirror at cnb.cool/Mintimate/rime/oh-my-rime. A prepackaged ZIP is available at cnb.cool/Mintimate/rime/oh-my-rime/-/releases/download/latest/oh-my-rime.zip for users who do not want to use Git.

Windows 7 and Windows XP can only run Weasel 0.14.3, which does not support the full feature set of oh-my-rime. Those users must manually update the librime support library; the project documentation covers the procedure.

## Dictionary Architecture and the July 2025 Word Library Migration

oh-my-rime maintains its word libraries in the dicts/ directory. The main dictionary configuration file is rime_mint.dict.yaml, which imports from several sub-libraries:

```yaml
---
name: rime_mint                  # 注意name和文件名一致
version: "2025.07.06"
sort: by_weight
use_preset_vocabulary: false
import_tables:
  - dicts/custom_simple          # 自定义
  - dicts/rime_mint.chars        # 单字词库（万象拼音词库基础版本）
  - dicts/rime_mint.base         # 基础词库（万象拼音词库基础版本）
  - dicts/rime_mint.correlation  # 关联词库（万象拼音词库基础版本）
  - dicts/rime_mint.compatible   # 多音兼容词库（万象拼音词库基础版本）
  - dicts/rime_mint.places       # 地名词库（万象拼音词库基础版本）
  - dicts/rime_mint.ext          # 联想词库（万象拼音词库基础版本）
  - dicts/other_kaomoji          # 颜文字表情（按`VV`呼出)
```

On July 9, 2025, the project switched from the 白霜词库 (Rime Frost) library to the 万象词库 (RIME-LMDG) library. This was a breaking change. The README lists two impacts: first, existing user dictionaries (.userdb files) require a migration script to rewrite tonal data; without it, tone marks will not display correctly. The project provides an offline migration tool. Second, a conflict between the 万象 pre-editing script and the error-correction script was resolved, though the visual style of error-corrected and 万象-sourced candidates remains the same, making them hard to distinguish.

The rime_mint.* files in dicts/ are automatically updated by GitHub Actions from the upstream 万象词库 source. The one file you should not overwrite when updating the word libraries is custom_simple.dict.yaml, which holds personal additions.

## Customizing Without Touching the Core Configuration

oh-my-rime follows a configuration override pattern to keep personal settings separate from the upstream files. Instead of editing squirrel.yaml or weasel.yaml directly, you create a squirrel.custom.yaml or weasel.custom.yaml file in the same directory. Rime merges the custom file on top of the base file during redeployment.

The same pattern applies to default.yaml, which controls scheme switching, paging behavior, and hotkeys. The recommended approach is to create default.custom.yaml with only the settings you want to change.

The project ships two built-in theme series: 水鸭 and 青涩. To activate one, you add the appropriate selection to your squirrel.custom.yaml (macOS) or weasel.custom.yaml (Windows). The README also notes that any custom color scheme can be defined in the custom file.

For iOS nine-key input with Hamster, two settings must be activated together: the nine-key scheme (via input scheme settings) and the nine-key layout (via Keyboard Settings, Keyboard Layout, Chinese 9-key). Enabling only one of the two does not produce nine-key input.

## Limitations Worth Knowing Before You Deploy

The Wubi schemes are simplified versions of their upstream counterparts. The README states this directly for both 五笔98-五笔小筑 and 五笔86-极点五笔, and points to the respective upstream repositories for users who want the full experience including Wubi-pinyin mixed input. If your workflow depends on features that the simplified Wubi schemes omit, oh-my-rime is the wrong starting point for Wubi.

The July 2025 dictionary migration is a one-time manual step that existing users must complete. If you upgrade from a pre-2025-07-09 installation without running the migration tool, existing .userdb entries will have broken tone display. New installations are not affected because they have no legacy .userdb data.

The repository uses GPL-3.0. This is a stronger copyleft license than MIT. If you distribute a modified version of the oh-my-rime configuration, the terms require that you distribute it under GPL-3.0 as well. Personal use and internal use are not restricted.

The repository has no GitHub releases. Users track the main branch and pull updates manually. There is no semantic versioning for the configuration schemas; the word library version (visible in rime_mint.dict.yaml as the version field) is the closest indicator of when the dictionary was last updated.

## Conclusion

oh-my-rime is the right starting point for anyone who wants Rime running quickly with a sensible default configuration and a broad word library. Users who need complete control over every Rime schema or who rely heavily on an existing custom .userdb should test the July 2025 dictionary migration before deploying it in a production typing environment. The GPL-3.0 license applies to the configuration itself, which matters if you redistribute a modified version of the scheme.

## FAQ

### How do I switch between input schemes in oh-my-rime?

After deploying oh-my-rime, press Ctrl+~ to open the scheme selector and switch between the available input methods. The default active scheme on a fresh deployment is 薄荷拼音-全拼输入.

### What do I need to do if I already had Rime installed before switching to oh-my-rime's 万象词库?

If you have an existing user dictionary (.userdb files) from before July 9, 2025, you must run the migration tool provided on the oh-my-rime documentation site to rewrite the tonal data. Without the migration, tone marks will not display correctly. New installations without a prior .userdb are not affected.

### Does oh-my-rime work on iOS?

oh-my-rime includes a nine-key grid input scheme (仓九宫格-全拼输入) for use with the Hamster iOS app. You must enable both the nine-key scheme in input scheme settings and the nine-key layout in Keyboard Settings under Chinese 9-key. Enabling only one of the two settings will not produce nine-key input.

## Sources

- [Issues](https://github.com/Mintimate/oh-my-rime/issues)
- [License: GPL-3.0](https://github.com/Mintimate/oh-my-rime/blob/main/LICENSE)
- [Mintimate/oh-my-rime on GitHub](https://github.com/Mintimate/oh-my-rime)
- [Project website](https://www.mintimate.cc)
- [README](https://github.com/Mintimate/oh-my-rime/blob/main/README.md)

---

Hysen Labs editorial analysis, written from the project's own repository and release notes. Cite the canonical page: https://hysenlabs.com/projects/mintimate-oh-my-rime