Fix Zoom offering no screens to share, or sharing a black window
Checked every claim against the current ArchWiki Zoom Meetings page, fetched 2026-09-13 via index.php?action=raw, and against this Omarchy 4.0.2-1 workstation. The wiki still documents all four of the record's client-side steps verbatim: enableWaylandShare=true in ~/.config/zoomus.conf for Wayland screen share, the Settings then Share Screen then Advanced then Screen capture mode PipeWire fallback, xwayland=false to run without XWayland with the ZoomWebviewHost 0MB caveat the record's danger reproduces, QT_SCALE_FACTOR=2 for the undersized UI, and the /j/ to /wc/join/ web client rewrite. So the record is not stale advice and it is not a duplicate of share-picker-never-appears-selection-minus-one: that record is about the picker binary itself returning selection -1, this one is about Zoom's own config gate, and they only share a symptom. Three defects were found. First, "Install the WebRTC screen-sharing prerequisites" is not a concrete fix and the corpus convention rejects that shape, and on Omarchy it is a no-op, confirmed here by pacman -Q: xdg-desktop-portal 1.22.1-2, xdg-desktop-portal-hyprland 1.4.1-1, pipewire 1:1.6.8-1, with both user units active since 2026-09-06 and org.freedesktop.impl.portal.desktop.hyprland owned on the session bus. Second, the verify line is wrong for Omarchy in two ways: the picker is hyprland-preview-share-picker 0.2.1-1, which readelf -d shows links libgtk-4 and libgtk4-layer-shell and no Qt at all, selected by custom_picker_binary in ~/.config/hypr/xdph.conf, and that same file sets allow_token_by_default = true, so a repeat share can be auto-restored with no picker at all and the old verify would read as a failure. Third, the record implies xwayland=false cures the black window, which https://bbs.archlinux.org/viewtopic.php?id=313237 contradicts: that thread, posts dated 2026-04, tracked window sharing going black on Hyprland and concluded the fault was Wayland-side rather than XWayland-specific, with the browser client the only thing that worked. Rewrote cause, fix and verify, kept symptom, danger, severity and frequency as they stand, since the danger matches the wiki's "Running on Wayland without Xwayland" and "Disable ZoomWebviewHost" sections. NOT exercised: Zoom itself is not installed here (pacman -Q zoom fails, ~/.config/zoomus.conf does not exist) and installing it is out of scope for an audit on the operator's workstation, so no zoomus.conf key and no share attempt was tested live. The AUR zoom package was confirmed to exist at 7.1.5.4332, last modified 2026-07-21, but its bundled Qt platform plugins were not inspected.
Setting xwayland=false is documented to make the ZoomWebviewHost process stop with 0MB memory, which disables whiteboard and some in-meeting features. Revert it if you lose functionality.
Symptom
In the Zoom desktop client, clicking "Share Screen" either shows no screens to pick, or shares a black/frozen window. Sharing works for other apps on the same machine.
Cause
Zoom's Linux desktop client does not use the XDG desktop portal for screen capture until its own Wayland share path is turned on. That path is gated behind enableWaylandShare in ~/.config/zoomus.conf, and until it is set Zoom falls back to X11 capture. Under XWayland on Hyprland, X11 capture sees only XWayland surfaces, so the picker offers nothing useful or the shared frame is black. On Omarchy 4 the rest of the chain is already correct and is not the cause: xdg-desktop-portal, xdg-desktop-portal-hyprland and pipewire are installed by default, both portal units run, and /usr/share/omarchy/default/hypr/envs.lua already exports the XDG_CURRENT_DESKTOP and XDG_SESSION_TYPE values the portal needs. Zoom's own capture mode can also sit on Automatic and never select PipeWire even when everything else is in place.
Fix
On Omarchy 4 the portal side of this already ships. Confirm it rather than installing anything:
pacman -Q xdg-desktop-portal xdg-desktop-portal-hyprland pipewire
systemctl --user status xdg-desktop-portal xdg-desktop-portal-hyprland
Measured on Omarchy 4.0.2-1: xdg-desktop-portal 1.22.1-2, xdg-desktop-portal-hyprland 1.4.1-1, pipewire 1:1.6.8-1, all installed and both units running. On plain Arch install xdg-desktop-portal, a wlroots backend such as xdg-desktop-portal-hyprland, and pipewire first.
- Turn on Zoom's Wayland share path in
~/.config/zoomus.conf:
enableWaylandShare=true
Quit Zoom completely from the tray, not just the window, then start it again.
- If Zoom still refuses to use PipeWire, force it in the GUI: Settings, then Share Screen, then Advanced, then set Screen capture mode to PipeWire instead of Automatic.
- Only if Zoom is still running under XWayland and you want it native, also set in
~/.config/zoomus.conf:
xwayland=false
Do not reach for this first. Omarchy already exports XDG_SESSION_TYPE=wayland, XDG_CURRENT_DESKTOP=Hyprland and QT_QPA_PLATFORM=wayland;xcb from /usr/share/omarchy/default/hypr/envs.lua, and XDG_CURRENT_DESKTOP=Hyprland is what makes xdg-desktop-portal pick hyprland.portal for ScreenCast, so do not set any of those by hand. Going native also does not cure a black shared window. The Arch forum thread cited below tracked window sharing going black on Hyprland and found it happened under native Wayland as well as under XWayland.
If the Zoom UI is then too small on a HiDPI screen:
QT_SCALE_FACTOR=2 zoom
- If no application can share, not Zoom and not Chromium and not OBS, the fault is the share picker rather than Zoom. See the record
share-picker-never-appears-selection-minus-one.
- If none of this works, the Zoom web client avoids the desktop client entirely. Replace
/j/with/wc/join/in the meeting URL:https://<subdomain>.zoom.us/wc/join/<meeting_id>?pwd=<password>
Verify
Start a meeting and click Share Screen. On Omarchy the window that appears is hyprland-preview-share-picker (package hyprland-preview-share-picker 0.2.1-1, a GTK4 program), not the stock Qt hyprland-share-picker from xdg-desktop-portal-hyprland, because ~/.config/hypr/xdph.conf sets custom_picker_binary = hyprland-preview-share-picker. Pick an output and check the shared preview shows live desktop content rather than black.
Omarchy also sets allow_token_by_default = true in that same file, so sharing the same target again can be restored from a token with no picker shown at all. A silent restore is expected on Omarchy and is not a failure. Changes to xdph.conf only take effect when the portal restarts, for example at next login.