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

Fix screen sharing showing a black window or no sources on Wayland

archomarchyendeavouroscachyoshyprlandwaylandpipewirexdg-desktop-portal
AUDITED Audited against its sources and confirmed accurate.
AUDIT NOTE

Chain and package names are correct and current (pipewire, pipewire-pulse, wireplumber, xdg-desktop-portal, xdg-desktop-portal-hyprland all in extra), the ScreenCast backend attribution matches xdph's declared interfaces, chrome://flags/#enable-webrtc-pipewire-capturer / --enable-features=WebRTCPipeWireCapturer and ELECTRON_OZONE_PLATFORM_HINT=wayland are the right knobs, and the webrtc-landing verify URL is a real test page. On Omarchy 4 the packages and services are already in place (base package list ships wireplumber and both portals), so the install step is a no-op rather than wrong.

Symptom

On a Google Meet / Teams / Discord call, clicking "Share screen" either shows an empty source list or shares a completely black rectangle. Works for other people on X11.

Cause

On Wayland, screen capture goes through the ScreenCast portal plus PipeWire, not X11. Either PipeWire/pipewire-pulse and wireplumber are not running, or the compositor's ScreenCast backend (xdg-desktop-portal-hyprland) is not running, or the browser is old enough that the PipeWire capturer is behind a flag.

Fix

Make sure the whole chain is installed and running:


sudo pacman -S pipewire pipewire-pulse wireplumber xdg-desktop-portal xdg-desktop-portal-hyprland
systemctl --user enable --now pipewire.service pipewire-pulse.service wireplumber.service
systemctl --user restart xdg-desktop-portal.service xdg-desktop-portal-hyprland.service

Firefox 84+ and Chromium 110+ support this out of the box. On older Chromium/Electron builds enable the capturer:

  • visit chrome://flags/#enable-webrtc-pipewire-capturer and set it to Enabled, or
  • launch with --enable-features=WebRTCPipeWireCapturer

For Electron apps also force native Wayland so the portal is used:


ELECTRON_OZONE_PLATFORM_HINT=wayland <app>

Verify

Open https://mozilla.github.io/webrtc-landing/gum_test.html and start a screen capture. The picker lists your monitors and the preview is not black. systemctl --user status xdg-desktop-portal-hyprland is active.

Sources

wayland-screen-share-black-or-empty