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

Fix the Activity window (Super+Ctrl+T) saying btop "Terminal size too small"

omarchyhyprlandbtoplaptop
AUDITED Audited against its sources and confirmed accurate. · checked against Omarchy omarchy 4.0.4-1 on 2026-10-05
AUDIT NOTE

Checked /usr/share/omarchy/default/hypr/apps/system.lua on 4.0.4-1: the floating-window tag gets size = { 875, 600 } and org.omarchy.btop is in the tagged class list. Super+Ctrl+T is { tui = "btop" } in utilities.lua line 103, and omarchy-launch-tui sets app-id org.omarchy.btop. shown_boxes is "cpu mem net proc" in the shipped btop.conf. Issue #8702 (open) supports every specific: the 80x24 floor, Foot 13 giving exactly 80x24, Ghostty 11 at 79x24 with the exact error text, the tag removal being required because a later size rule does not override, Hyprland not clamping to the monitor, and the 1040x672 measurements (97x26 and 94x27). o.window is the helper the user hyprland.lua already uses after require("default.hypr.omarchy"). The Hyprland wiki confirms misc:disable_autoreload defaults to false, so the config reloads on save. PR #8768 with the same size is still open, so the default is unchanged. The rule was not applied here.

Symptom

Super+Ctrl+T opens a floating window, but btop refuses to draw and shows:


Terminal size too small: Width = 79 Height = 24
Needed for current config: Width = 80 Height = 24

It started after I raised my terminal font size, or happens on a small or scaled laptop screen.

Cause

org.omarchy.btop gets the shared floating-window tag. In /usr/share/omarchy/default/hypr/apps/system.lua (4.0.4-1) that tag is sized { 875, 600 } in pixels. btop with Omarchy's shown_boxes needs at least 80x24 character cells, and how many cells 875x600 holds depends on the terminal font size. At stock size 9 it is about 117x33. Foot at 13 gives exactly 80x24, and Ghostty at 11 gives 79x24, so one point more and btop refuses to start. A later size rule does not override the tag's size, so the tag has to be removed first.

Fix

Give btop its own float. Add this at the end of ~/.config/hypr/hyprland.lua:


o.window("org.omarchy.btop", { tag = "-floating-window" })
o.window("org.omarchy.btop", { float = true })
o.window("org.omarchy.btop", { center = true })
o.window("org.omarchy.btop", { size = { 1040, 672 } })

Save the file. Hyprland reloads the Lua config on save, so do not run hyprctl reload yourself. Close and reopen Activity.

1040x672 was measured at 97x26 cells with Foot at 13 on 1536x864 and at 94x27 with Ghostty at 11 on 1280x720. It still fits a 1280x720 logical screen with a 30 px bar. Hyprland does not clamp a window rule to the monitor, so do not go much larger on small screens. For fonts larger still, let btop tile by removing the tag and leaving out the three other lines.

Verify


hyprctl clients | grep -A12 'class: org.omarchy.btop' | grep size

It reports the new size, and btop draws its boxes.

Sources

btop-activity-terminal-size-too-small