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

Fix screen share showing a black rectangle or no picker at all

omarchyarchendeavouroscachyosmanjarohyprlandwaylandpipewiredesktoplaptop
AUDITED Audited against its sources and confirmed accurate.

Symptom

Screen sharing does nothing, or shares a black rectangle. In Google Meet / Discord / Zoom the "share screen" dialog either never appears or shows an empty source list. No picker window pops up at all. Sometimes apps also take 20+ seconds to launch.

Cause

xdg-desktop-portal-hyprland (XDPH) is not running, or it is running but cannot talk to the compositor because XDG_CURRENT_DESKTOP / WAYLAND_DISPLAY were never imported into the systemd user session and the D-Bus activation environment. XDPH is D-Bus-activated, so it appears "installed" while being completely non-functional. Screen capture on Wayland goes app -> xdg-desktop-portal -> XDPH -> PipeWire. If any link is missing you get silence or black frames.

Fix

Install the whole chain and make sure PipeWire is up:


sudo pacman -S --needed pipewire wireplumber xdg-desktop-portal xdg-desktop-portal-hyprland xdg-desktop-portal-gtk qt6-wayland
systemctl --user enable --now pipewire.service pipewire-pulse.service wireplumber.service

Check the systemd user session actually has the XDG variables (this is the usual culprit):


systemctl --user show-environment | grep -E 'XDG_CURRENT_DESKTOP|WAYLAND_DISPLAY'

If either is missing, import them and restart the portals:


systemctl --user import-environment WAYLAND_DISPLAY XDG_CURRENT_DESKTOP
dbus-update-activation-environment --systemd WAYLAND_DISPLAY XDG_CURRENT_DESKTOP=Hyprland
systemctl --user restart xdg-desktop-portal-hyprland.service xdg-desktop-portal.service

Make it permanent in your Hyprland config so it happens before the portals start.

Hyprland 0.55+ / Omarchy 4.x (~/.config/hypr/autostart.lua):


hl.on("hyprland.start", function()
  hl.exec_cmd("systemctl --user import-environment $(env | cut -d'=' -f 1)")
  hl.exec_cmd("dbus-update-activation-environment --systemd --all")
end)

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


env = XDG_CURRENT_DESKTOP,Hyprland
env = XDG_SESSION_TYPE,wayland
env = XDG_SESSION_DESKTOP,Hyprland
exec-once = dbus-update-activation-environment --systemd WAYLAND_DISPLAY XDG_CURRENT_DESKTOP

Omarchy already ships exactly this in /usr/share/omarchy/default/hypr/envs.lua and autostart.lua, so on a stock Omarchy the fault is nearly always a stopped/crashed portal. Restart it with the systemctl --user restart line above.

Verify

systemctl --user status xdg-desktop-portal-hyprland shows active (running) with log lines [screencopy] Registered for toplevel export and [screenshot] init successful. Then open https://mozilla.github.io/webrtc-landing/gum_test.html and click the screen-share button. A Qt/GTK picker listing your monitors must appear.

Sources

screenshare-black-screen-no-portal