OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
apps-services low occasional DISPUTE

Make Han characters use Japanese or Chinese glyph forms instead of Korean

omarchyarchfontsfontconfig
CORRECTED An auditor found the fix wrong or incomplete and rewrote it. · checked against Omarchy omarchy 4.0.4-1 on 2026-10-05
AUDIT NOTE

Reproduced on this 4.0.4-1 workstation (fontconfig 2.18.3, noto-fonts-cjk 20240730): fc-match 'sans-serif:charset=5168' gives Noto Sans CJK KR, 'monospace:charset=5168' gives Noto Sans Mono CJK KR, and even 'sans-serif:lang=ja:charset=5168' gives KR. /usr/share/fontconfig/conf.avail/65-nonlatin.conf names only KR CJK faces, commented as Hangul. omacom/omarchy#9580 is open and describes the same thing. The record's cause claims a user <alias><prefer> for the generic families has no effect because of 50-omarchy.conf's strong assign. That is false: with XDG_CONFIG_HOME pointed at a scratch fontconfig/fonts.conf (which 50-user.conf loads exactly as it loads ~/.config/fontconfig/fonts.conf) holding prefer aliases for sans-serif, serif and monospace, fc-match returned Noto Sans CJK JP, Noto Serif CJK JP and Noto Sans Mono CJK JP for Han, 'JetBrainsMono Nerd Font:charset=5168' also became Noto Sans Mono CJK JP, and plain sans-serif and monospace still resolved to Liberation Sans and JetBrainsMono Nerd Font. The record's append_last rule also works in the same test, but it gives terminals the proportional Noto Sans CJK JP instead of the Mono face and covers serif with a sans face, so the corrected fix uses the aliases and keeps the append rule as the alternative. Not tested: rendering inside Chromium, only fc-match.

The cause above was rewritten on 2026-10-05 to match this note; the fix was corrected by the audit itself.

Symptom

Kanji or hanzi such as 全, 骨 and 円 look subtly wrong: they are drawn in the Korean style in the terminal, the bar, the Chromium address bar and untagged web pages. fc-match 'sans-serif:charset=5168' prints Noto Sans CJK KR.

Cause

Arch's fontconfig 65-nonlatin.conf lists Noto Serif CJK KR, Noto Sans CJK KR and Noto Sans Mono CJK KR in its generic-family fallback lists (commented there as Hangul fonts) and no JP, SC, TC or HK face. With noto-fonts-cjk installed (Omarchy installs it), the KR face is therefore the first one fontconfig offers for Han text. Omarchy's /etc/fonts/conf.d/50-omarchy.conf maps sans-serif, serif and monospace to Liberation Sans, Liberation Serif and JetBrainsMono Nerd Font, none of which has Han glyphs, so every Han character falls through to that list. Checked on Omarchy 4.0.4-1 under LANG=en_US.UTF-8: fc-match 'sans-serif:charset=5168' prints Noto Sans CJK KR, and so does fc-match 'sans-serif:lang=ja:charset=5168', so even text tagged Japanese gets Korean forms. Reported as omacom/omarchy#9580, open as of 2026-10-05.

Fix

Add aliases to ~/.config/fontconfig/fonts.conf that offer the Japanese CJK faces first for each generic family. If the file already exists, add only the three <alias> blocks inside its <fontconfig> element:


mkdir -p ~/.config/fontconfig

<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
<fontconfig>
  <!-- Prefer the Japanese forms of Han characters over the Korean default -->
  <alias>
    <family>sans-serif</family>
    <prefer><family>Noto Sans CJK JP</family></prefer>
  </alias>
  <alias>
    <family>serif</family>
    <prefer><family>Noto Serif CJK JP</family></prefer>
  </alias>
  <alias>
    <family>monospace</family>
    <prefer><family>Noto Sans Mono CJK JP</family></prefer>
  </alias>
</fontconfig>

This works on Omarchy 4 despite 50-omarchy.conf: Liberation Sans, Liberation Serif and JetBrainsMono Nerd Font still come first, so Latin text is unchanged, and the aliases only decide which CJK face supplies the characters those fonts lack. Restart the apps (terminal, browser) to pick it up.

For Simplified Chinese, Traditional Chinese or Hong Kong forms use SC, TC or HK in all three names instead of JP, for example Noto Sans CJK SC, Noto Serif CJK SC and Noto Sans Mono CJK SC.

These aliases also override Han text explicitly tagged Korean, and Hangul is then drawn from the JP face, which includes it.

Alternative: a single rule that appends one face to every pattern also works, but it gives the terminal the proportional face rather than the Mono one:


<match target="pattern">
  <edit name="family" mode="append_last" binding="strong">
    <string>Noto Sans CJK JP</string>
  </edit>
</match>

Verify

fc-match 'sans-serif:charset=5168' prints Noto Sans CJK JP, fc-match 'monospace:charset=5168' and fc-match 'JetBrainsMono Nerd Font:charset=5168' print Noto Sans Mono CJK JP, and fc-match 'serif:charset=5168' prints Noto Serif CJK JP, while fc-match sans-serif still prints Liberation Sans and fc-match monospace still prints JetBrainsMono Nerd Font.

Sources

cjk-han-characters-render-korean-variant