Fix screen share showing a black rectangle or no picker at all
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.