OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
display-monitors low common DISPUTE

Make the text console readable on a HiDPI laptop

omarchyomarchy-4archendeavouroslaptophidpittymkinitcpio
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

Confirmed on this workstation: /etc/vconsole.conf has FONT=default8x16, the kernel has CONFIG_FONT_TER16x32=y, latarcyrheb-sun32 is owned by kbd 2.10.0-1, limine-mkinitcpio exists, and omarchy_hooks.conf includes consolefont. archinstall's locale.py defaults console_font to default8x16, and the Arch HiDPI page supports TER16x32 auto-selection, latarcyrheb-sun32 and the video= workaround. Three defects. The cause credits the drop-in's FILES+=(/etc/vconsole.conf) for the early-boot font, but that block exists for Plymouth's keyboard layout. /usr/lib/initcpio/install/consolefont reads FONT from /etc/vconsole.conf itself and embeds the font regardless of layout. The fix gives the video= parameter with no place to put it, and on Omarchy 4 kernel parameters go in /etc/limine-entry-tool.d/*.conf, the format omarchy-defaults.conf there uses. The danger calls a misspelt font harmless, but the consolefont install hook raises an error, mkinitcpio counts it and warns the image may not be complete. The verify step contained a placeholder 'Super+Alt+...', and loginctl here shows the Hyprland session on VTNr=1. No initramfs was rebuilt and no kernel parameter was exercised.

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

The initramfs rebuild writes to the ESP on Omarchy 4. Run df -h /boot first, because a full ESP produces a truncated image that does not boot, and Omarchy 4 has no fallback image. A misspelt font name is not harmless at build time: the consolefont hook fails with consolefont: requested font not found, and mkinitcpio warns that the image may not be complete. Correct the name and rebuild before rebooting. If a video= mode leaves the console blank, delete /etc/limine-entry-tool.d/console-mode.conf and run sudo limine-mkinitcpio again.

Symptom

On a 4K or other HiDPI laptop, the text console (Ctrl+Alt+F2, or the screen you land on when Hyprland crashes or an emergency shell opens) uses microscopic text that I can barely read.

Cause

The kernel picks its large built-in font, TER16x32, for high-resolution displays by itself. Userspace then overrides it. On an install made by archinstall, which Omarchy's installer uses, /etc/vconsole.conf contains FONT=default8x16, because archinstall's default console_font is default8x16. systemd-vconsole-setup loads that 8x16 font over the kernel's choice. On Omarchy 4 the consolefont hook is in the HOOKS set by /etc/mkinitcpio.conf.d/omarchy_hooks.conf, and that hook reads FONT from /etc/vconsole.conf when the initramfs is built and loads it in early userspace, so the small font is applied from early boot. Checked on this 4.0.4-1 workstation.

Fix

**Try a font on the current console.** Run this on the text console itself (Ctrl+Alt+F2, then log in). From a terminal inside Hyprland it has no console to change:


setfont latarcyrheb-sun32

latarcyrheb-sun32 ships in kbd, which is always installed. For Terminus, sudo pacman -S terminus-font and use ter-132b instead.

**Make it permanent:**


sudo sed -i 's/^FONT=.*/FONT=latarcyrheb-sun32/' /etc/vconsole.conf
grep -q '^FONT=' /etc/vconsole.conf || echo 'FONT=latarcyrheb-sun32' | sudo tee -a /etc/vconsole.conf
sudo systemctl restart systemd-vconsole-setup

Rebuild the initramfs so early boot uses it too, and read the output for consolefont: requested font not found before rebooting:

  • **Omarchy 4:** sudo limine-mkinitcpio
  • **Plain Arch:** sudo mkinitcpio -P

**If text turns garbled when you switch to other consoles,** the Arch wiki's fix is to force the native KMS mode with a video= kernel parameter, using your panel's resolution, for example video=2560x1600@60.

  • **Omarchy 4:** the kernel command line is inside the UKI and comes from /etc/limine-entry-tool.d/*.conf. Add a drop-in and rebuild:

echo 'KERNEL_CMDLINE[default]+=" video=2560x1600@60"' | sudo tee /etc/limine-entry-tool.d/console-mode.conf
sudo limine-mkinitcpio
  • **Plain Arch:** add video=2560x1600@60 to your boot loader's kernel command line, as described on the Arch wiki's Kernel parameters page.

Verify

grep ^FONT /etc/vconsole.conf prints the new font. Switch to Ctrl+Alt+F2 and the text is readable. After a reboot it is still large from early boot onwards. Ctrl+Alt+F1 returns you to the Hyprland session, which runs on tty1.

Sources

tty-console-font-tiny-on-hidpi