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

Make LocalSend float again: Omarchy's window rule does not match class `org.localsend.localsend_app`

omarchyhyprlandwaylandlocalsend
CORRECTED An auditor found the fix wrong or incomplete and rewrote it.
AUDIT NOTE

Checked on this workstation, which runs omarchy 4.0.2-1, Hyprland 0.56.2 and has localsend 1.18.2-1 installed, and against issues 8817 and 7482 and pull requests 8878 and 7736, all read in full with comments. Confirmed here: /usr/share/omarchy/default/hypr/apps/localsend.lua is still the two unfixed rules the record quotes, /usr/share/omarchy/default/hypr/helpers.lua assigns a string match to rules.match.class and calls hl.window_rule, the installed /usr/bin/Hyprland exports only RE2's FullMatchN with no PartialMatchN, and /usr/share/omarchy/default/hypr/apps/terminals.lua states The class is matched in full, so the full-match mechanism is confirmed on this machine and not only asserted upstream. The app id is confirmed here too: strings -a /usr/lib/localsend/localsend_app and the same on /usr/lib/localsend/lib/libapp.so both return org.localsend.localsend_app. hyprctl clients -j on this session has floating and size as real fields, so the verify block is well formed, and hyprctl reload is in hyprctl --help. The comment in /usr/share/omarchy/config/hypr/hyprland.lua confirms a user rule appended after the require lines is loaded after Omarchy's defaults, and in this case there is no conflict to resolve because the shipped rule matches nothing for that app id. The fix's Lua is correct: org\\. in the record renders as org\. in the file, which reaches RE2 as a literal dot, and it is byte-identical to the change in both pull requests, which I read as diffs.

The cited issues do support the claim. 7482 gives the class, the tiled window and the dead clicks, with a working anchored workaround, although its own root-cause hypothesis about unanchored matching is wrong and the record correctly does not repeat it. 8817 gives the same class with the same diagnosis. Corrected rather than ok on three points of fact. 8817 is now closed, on 2026-09-03, by the reporter as a duplicate rather than by a fix, and a reader who saw only a closed issue would draw the wrong conclusion. The record's date line stopped at 2026-09-07 while both pull requests are still open on 2026-09-11 and tag v4.0.3 of 2026-09-08 still ships the unfixed file, which I checked on both refs with gh api. And the version pairing in the symptom was wrong: 7482 reports localsend 1.18.1-1 on Omarchy 4.0.0-1, while 1.18.2-1 belongs to the 4.0.1-1 report. The stronger evidence was also under-credited, so the cause now names peteonrails' reproduction with the real application and says plainly that the bot's reproduction used a relabelled terminal. Not exercised: I did not launch LocalSend and did not reload the running config, so the floating and 1100x700 result comes from those reports rather than from this machine.

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

Symptom

LocalSend opens tiled in the active layout instead of as a centered 1100x700 floating window. The older report 7482 adds that clicks do not reach the window's buttons while it is tiled, and that floating the window fixes that too. Reported on Omarchy 4.0.0-1 with localsend 1.18.1-1 and on Omarchy 4.0.1-1 with localsend 1.18.2-1, both from the Arch repos, on Hyprland 0.56.2. hyprctl clients shows the window's class:


{
  "class": "org.localsend.localsend_app",
  "initialClass": "org.localsend.localsend_app",
  "title": "LocalSend"
}

Cause

/usr/share/omarchy/default/hypr/apps/localsend.lua matches the class with (Share|localsend) and localsend:


-- Float LocalSend and fzf file picker.
o.window("(Share|localsend)", { float = true, center = true })
o.window("localsend", { size = { 1100, 700 } })

o.window in default/hypr/helpers.lua puts that string straight into rules.match.class and hands it to hl.window_rule, and Hyprland 0.56 matches a class against the whole string, so (Share|localsend) cannot match org.localsend.localsend_app and the window gets no rule at all. Anchors were never the missing piece, the app id was.

That app id is the installed package's own. The binary /usr/lib/localsend/localsend_app and /usr/lib/localsend/lib/libapp.so from localsend 1.18.2-1 both carry the string:


strings -a /usr/lib/localsend/localsend_app | grep org.localsend

Three people report the same class. peteonrails reproduced it with the real application on Hyprland 0.56.2, stock rules giving floating: false at 656x1167 and an anchored rule giving floating at 1100x700. The repository's review bot reached the same result on a disposable worker, though with a terminal relabelled to that app id rather than LocalSend itself.

Nothing has shipped. Issue 7482 is open, issue 8817 was closed on 2026-09-03 by its own reporter as a duplicate of 7482 and not because a fix landed, and the two pull requests that make the byte-identical change to default/hypr/apps/localsend.lua, 7736 and 8878, were both still open on 2026-09-11. quattro and tag v4.0.3 of 2026-09-08 both still carry the unfixed rule, as does omarchy 4.0.2-1 on disk.

Fix

Until the fix ships, add the corrected rules to your own config. ~/.config/hypr/hyprland.lua loads Omarchy's defaults first, so a rule placed after the require lines wins. Append at the end of the file:


-- LocalSend's Wayland app id is org.localsend.localsend_app, which the
-- shipped (Share|localsend) rule cannot match. Same rules as omarchy PR #8878.
o.window("^(Share|localsend|org\\.localsend\\.localsend_app)$", { float = true, center = true })
o.window("^(localsend|org\\.localsend\\.localsend_app)$", { size = { 1100, 700 } })

Reload and relaunch LocalSend:


hyprctl reload

Remove the two lines once an update ships a localsend.lua that names the app id:


grep -n localsend_app /usr/share/omarchy/default/hypr/apps/localsend.lua

Verify


hyprctl clients -j | jq '.[] | select(.class == "org.localsend.localsend_app") | {floating, size}'

Expect "floating": true and "size": [1100, 700]. The collaborator's reproduction on Hyprland 0.56.2 gave exactly that with the fixed rules and floating=false at the layout's size without them.

Sources

localsend-opens-tiled-window-rule-class-mismatch