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

Fix top-bar icons rendering at roughly half size after changing the system font

omarchyomarchy-4hyprlandwayland
CORRECTED An auditor found the fix wrong or incomplete and rewrote it.
AUDIT NOTE

Read the shipped Quickshell shell on this workstation (omarchy 4.0.2-1, quickshell 0.3.1-1, Hyprland 0.56.2-1) and every mechanical claim about the shell held exactly. Confirmed locally in /usr/share/omarchy/shell/Commons/Style.qml: Style.bar.iconFont is barToken("icon-font", 13), barToken multiplies by fontScale, which is fontBaseSize / 12, barScaleWithFont defaults to true, and applyShellValues parses only scale-with-font, size-horizontal and size-vertical from the [bar] section, so icon-font, icon-canvas, icon-slot and status-slot really are unreachable from shell.toml. Also confirmed locally: /usr/share/omarchy/shell/Ui/BarIconButton.qml sets fontSize: Style.bar.iconFont, OpticalGlyph.qml renders that into font.pixelSize and corrects only the horizontal centre, and Color.qml reads ~/.config/omarchy/shell.toml with watchChanges: true and merges it over the theme with user keys winning. Both cited issues were read in full and both support the record, with 8608 carrying the glyph measurement table the cause paraphrases and 7305 being a weaker corroborating report. Four things were wrong or missing. The symptom claimed bar text is fine and only icons shrink, which contradicts the record's own second source, 7305, whose title is that text and icons are both very small, so I made the symptom honest about the narrow face. The cause stated the 50 percent figure as a property of how Iosevka patches glyphs, without the reason, so I added the Nerd Fonts variant mechanism from upstream's own patcher documentation, where --single-width-glyphs is documented as "generate the glyphs as single-width not double-width (default is double-width)" and named as Nerd Font Mono, and --variable-width-glyphs as Nerd Font Propo, which is what makes every Mono row in 8608's table exactly 500 units on a 1000-unit em. The fix told the user to run omarchy restart shell after omarchy font set, which is redundant because omarchy-font-set already calls omarchy-restart-shell, and to set [bar] scale-with-font = true, which is already the default, and it missed omarchy display text size, the supported CLI that writes [font] base-size and accepts 9 to 20. The danger covered only shell text and missed that omarchy-font-set rewrites the fontconfig monospace alias and the alacritty, kitty, ghostty and foot font families, so abandoning the Mono variant changes icon cell width in the terminal too. I dropped frequency from common to occasional because the fault needs a specific non-default font variant to be chosen, and there are two open issues rather than a broad pattern. NOT exercised, and this is the main gap: Iosevka is not installed on this machine, fc-list here reports only JetBrainsMono Nerd Font, and the pacman files database is not synced, so I could not re-measure any glyph bounding box or confirm the exact family names ttf-iosevka-nerd 3.5.1-2 installs. Those numbers and names come from issue 8608 and are consistent with the upstream patcher documentation, not from a local measurement. I also changed no font, no theme and no setting on this machine.

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

Two costs. omarchy display text size deliberately moves GTK apps and terminal font size along with the shell, and editing [font] base-size by hand scales every piece of shell text rather than only the bar icons. And omarchy font set rewrites the fontconfig monospace alias and the alacritty, kitty, ghostty and foot font families, so leaving the Mono variant also changes how icons occupy cells in your terminal. The plain Iosevka Nerd Font draws icon glyphs double-width, which can misalign a TUI prompt or status line that assumed one cell.

Symptom

After omarchy font set "Iosevka Nerd Font Mono", the top-bar icons (Wi-Fi, volume, Bluetooth, power, monitor) render at roughly half the size they did with JetBrainsMono Nerd Font. Bar text also reads a little smaller, because Iosevka is a narrow face drawn at the same pixel size, but the icons are the striking part and the only thing that changes by a factor of two.

Cause

The bar draws each icon as a single Nerd Font glyph at a fixed pixel size. shell/Ui/BarIconButton.qml sets fontSize: Style.bar.iconFont, shell/Ui/OpticalGlyph.qml renders that straight into font.pixelSize and corrects only the horizontal centring, and Style.bar.iconFont is barToken("icon-font", 13), so 13px by default, multiplied by fontScale, which is [font] base-size divided by 12. Nothing measures the glyph, so the painted size is whatever the font draws inside that box.

Nerd Fonts patches each family in three widths, and the variant is the whole story. Upstream's patcher documents --single-width-glyphs as "generate the glyphs as single-width not double-width (default is double-width)" and names that build Nerd Font Mono, while --variable-width-glyphs, "do not adjust advance width", is Nerd Font Propo. So the Mono variant squeezes every icon into one character cell. Iosevka's cell is unusually narrow: in the measurements on omacom/omarchy#8608, every icon under Iosevka Nerd Font Mono is exactly 500 units wide on a 1000-unit em, which is that single-cell advance, against 750 to 970 units for the same codepoints in Iosevka Nerd Font, Iosevka Nerd Font Propo and JetBrainsMono Nerd Font. At a fixed 13px that is roughly 6.5px painted against 12.6px.

There is no per-icon config knob. Style.qml's applyShellValues reads only size-horizontal, size-vertical and scale-with-font out of the [bar] section, so icon-font, icon-canvas, icon-slot and status-slot are not settable from shell.toml at all. The only lever that moves them is [font] base-size, which scales the whole shell.

Fix

Switch to a variant that does not force icons into a single cell:


omarchy font set "Iosevka Nerd Font"

omarchy-font-set calls omarchy-restart-shell itself, so no separate restart is needed. Check first what the ttf-iosevka-nerd package actually gave you, because the variant names are what fc-list reports and nothing else:


fc-list : family | tr ',' '\n' | grep -i iosevka | sort -u

omarchy font list will not necessarily show every variant. It runs fc-list :spacing=100, which lists only fonts fontconfig considers monospaced, so a Propo build can be missing from that list even though omarchy font set accepts it, since omarchy-font-set only tests fc-list | grep -Fqi.

If you want to keep the Mono variant, the only knob that moves the icons is the shell base font size. The supported command is:


omarchy display text size 16

It accepts 9 to 20, writes [font] base-size into ~/.config/omarchy/shell.toml, and moves GTK's text-scaling-factor and the terminal point size in lockstep with it. To move the shell alone, edit the same file by hand:


[font]
base-size = 18

The shell watches ~/.config/omarchy/shell.toml and re-reads it on change, so this takes effect live with no restart, and a user key there wins over the theme's own shell.toml. Do not bother setting [bar] scale-with-font: it is already true by default, which is what makes base-size reach the icons at all.

Omarchy 4 versus plain Arch: all of the above is Omarchy-specific, because the bar is the Omarchy Quickshell shell. On plain Arch with another bar, the same Nerd Font Mono single-width behaviour applies, but the fix is whatever font size that bar exposes.

Verify

Confirm which font the shell resolved and compare the two variants:


omarchy font current
fc-match monospace -f '%{family[0]}\n'

Then set "Iosevka Nerd Font Mono" and "Iosevka Nerd Font" in turn and look at the Wi-Fi, volume and Bluetooth icons. Under the non-Mono variant they should be the same optical size they were on JetBrainsMono Nerd Font, and the jump between the two settings should be obvious rather than subtle.

Sources

bar-icons-half-size-with-iosevka-nerd-font-mono