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

Add a working PipeWire screen capture source to OBS

omarchyarchendeavouroscachyosmanjarohyprlandwaylandpipewire
AUDITED Audited against its sources and confirmed accurate.

Symptom

OBS has no working screen capture. There is no "Screen Capture (PipeWire)" source in the Add Source list, or adding it shows a black preview. Or OBS refuses to start at all with a Qt platform plugin error.

Cause

OBS 28+ is a Qt 6 app and needs qt6-wayland to run natively on Wayland. Screen capture on Wayland goes through the PipeWire source, which needs the portal chain up and running. Without it OBS falls back to nothing.

Fix


sudo pacman -S --needed obs-studio qt6-wayland pipewire wireplumber xdg-desktop-portal xdg-desktop-portal-hyprland
systemctl --user enable --now pipewire.service wireplumber.service
systemctl --user restart xdg-desktop-portal-hyprland.service

In OBS: Sources -> + -> **Screen Capture (PipeWire)**. The Hyprland share picker appears. Pick a monitor or a window.

Check OBS actually found the PipeWire capture backend by launching it from a terminal:


obs

You should see:


info: Platform: Wayland
info: [pipewire] Available capture sources:
info: [pipewire]     - Monitor source
info: [pipewire]     - Window source

If Platform: says X11, OBS is on XWayland and will only capture X11 windows.

For capturing Vulkan/OpenGL games without portal overhead, use the direct hook instead:


yay -S obs-vkcapture lib32-obs-vkcapture

Verify

OBS log shows info: [pipewire] Available capture sources: with a Monitor source, and a Screen Capture (PipeWire) source shows live video in the preview.

Sources

obs-no-screen-capture-source