Skip to content

Pinyin Tuning

This page covers how to bend pinyin to your habits. Daily keys and mixed Chinese-English typing are in Getting Started; the key list is in Keymap.


The default scheme is full pinyin (Settings → Pinyin → Scheme). Full pinyin already includes abbreviated pinyin (nh → 「你好」, bj → 「北京」), and the settings page says so directly: the full-pinyin option already carries the initial-abbreviation case and is not offered separately. There is no “enable abbreviated pinyin” switch.


Settings → Pinyin → set Scheme to Double pinyin, then pick a layout from the dropdown. There are six:

Microsoft, Ziranma, Smart ABC, Ziguang, Pinyin Jiajia, Xiaohe

Microsoft is the default. A separate “Show raw double-pinyin input” checkbox is off by default; when on, the composition area shows the double-pinyin letters you typed instead of the restored pinyin. A scheme change takes effect at once.


Settings → Pinyin → Pinyin correction, off by default. Once it is on, and without rewriting the pinyin you typed, it adds candidates for likely mistakes. Correct spelling still comes first.

Typical cases it can fix (single syllables, usually one difference):

TypeExample
Two adjacent letters swappedshagnhai → 「上海」
A missing lettershanhai → 「上海」
One extra or wrong letterA stray key that lands on a legal syllable

Three boundaries:

  • An unfinished initial, such as a lone c, only extends the abbreviated-pinyin path. It is never turned into another syllable.
  • Correction and fuzzy pinyin are two mechanisms: one handles wrong keystrokes, the other handles similar sounds.
  • On longer sentences correction backs off, so it does not slow down the output.

Settings → Fuzzy pinyin: one master switch plus 11 pairs you can tick individually.

InitialsFinals
zh = z, ch = c, sh = s, n = l, r = l, f = han = ang, en = eng, in = ing, ian = iang, uan = uang

Typing zongguo can also give 「中国」 (China) — that is the zh = z pair doing the work. Fuzzy pinyin only changes which similar sounds decoding accepts; it never rewrites the keys you pressed.

The default state, stated plainly: the master switch is on, and all 11 pairs are ticked by default. If you want only a few, open this page and untick the rest.


Every item in the settings window writes to ~/.config/auritype/config.toml immediately (you normally never edit it by hand; the system template is /usr/share/auritype/config/config.toml, the user file overrides it, and keys you never wrote keep their defaults).

A double-pinyin scheme change applies at once. If another setting does not show up in the candidates right away, reload the engine:

Terminal window
ibus restart

After a new package or new code you also need ibus restart; a GNOME caret-tracking extension change requires logging out and back in.