OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
wayland-compat high common DISPUTE

Fix an XWayland app that can only offer other X11 windows to share

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

Cause and overall strategy are correct. Three concrete defects: (1) ~/.config/hypr/windows.lua does not exist in Omarchy 4.x and nothing requires it: config/hypr/hyprland.lua only requires hypr.monitors, hypr.input, hypr.bindings, hypr.looknfeel, hypr.autostart, so a rule written there is silently never loaded. (2) In the Lua window-rule schema the opacity effect takes a STRING (e.g. "0.8", with an optional " override" suffix). opacity = 0.0 is the wrong type and drops the override that the hyprlang version correctly has, so the rule will not fully hide the bridge. (3) On Omarchy, ELECTRON_OZONE_PLATFORM_HINT=wayland is already exported globally in default/hypr/envs.lua, so the ELECTRON_OZONE_PLATFORM_HINT=wayland discord line is a no-op there. Also worth flagging: xwaylandvideobridge is AUR-only and currently marked out-of-date.

The cause above was not rewritten and may still contain the error described. The fix below is the corrected version.

Symptom

In Discord (native app), Skype, or any other X11/XWayland app, the screen-share source list only shows a couple of other X11 windows: your Wayland apps and "Entire Screen" are missing, or sharing the whole screen gives a black/frozen image. The same site works fine in Firefox.

Cause

An app running under XWayland talks to the X server, not to the Wayland compositor. X11 screen capture can only see the XWayland root window and other XWayland clients. Native Wayland surfaces are simply not part of that X screen. This is a structural limitation, not a bug in Hyprland.

Fix

Best fix: make the app run natively on Wayland so it uses the XDG ScreenCast portal:


# Discord / any Electron app
ELECTRON_OZONE_PLATFORM_HINT=wayland discord

On Omarchy this variable is already exported globally in /usr/share/omarchy/default/hypr/envs.lua, so the app is already native Wayland and this line changes nothing. Skip to the bridge below.

Or use a Wayland-native client (vesktop for Discord) or the web app in Firefox/Chromium.

If the app cannot be moved off XWayland, install KDE's xwaylandvideobridge from the AUR (note: currently flagged out-of-date, build may need attention):


yay -S xwaylandvideobridge

Hyprland does not support the way it hides its own window, so hide it with window rules.

Hyprland 0.55+ / Omarchy 4.x: Omarchy has no windows.lua, so either append this to the bottom of ~/.config/hypr/hyprland.lua, or create ~/.config/hypr/windows.lua AND add require("hypr.windows") to ~/.config/hypr/hyprland.lua:


hl.window_rule({
    name = "xwayland-video-bridge-fixes",
    match = { class = "xwaylandvideobridge" },
    no_initial_focus = true,
    no_focus = true,
    no_anim = true,
    no_blur = true,
    max_size = {1,1},
    opacity = "0.0 override"
})

(opacity is a string effect. A bare 0.0 is the wrong type and loses the override.)

Hyprland <=0.54 / Omarchy 3.x (~/.config/hypr/hyprland.conf):


windowrulev2 = opacity 0.0 override, class:^(xwaylandvideobridge)$
windowrulev2 = noanim, class:^(xwaylandvideobridge)$
windowrulev2 = noinitialfocus, class:^(xwaylandvideobridge)$
windowrulev2 = maxsize 1 1, class:^(xwaylandvideobridge)$
windowrulev2 = noblur, class:^(xwaylandvideobridge)$

Verify

hyprctl clients -j | grep -A2 xwayland for the sharing app shows "xwayland": false, or the share source list now offers your monitors and Wayland windows.

Sources

xwayland-app-cannot-share-wayland-windows