Fix screen sharing showing a black window or no sources on Wayland
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-capturerand 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.