Error Codes Wiki

Wayland Display Errors — Screen Sharing, Scaling, and Application Compatibility

Warningsystem

Overview

Fix Wayland display errors including screen sharing not working, XWayland scaling issues, application compatibility problems, and NVIDIA Wayland support.

Key Details

  • Wayland is the modern display protocol replacing Xorg, used by default in GNOME and KDE on most distros
  • XWayland provides backward compatibility for X11 applications running on Wayland
  • Screen sharing requires PipeWire and xdg-desktop-portal for Wayland-native screen capture
  • Some applications (Electron apps, older toolkits) may have blurry rendering or input issues under XWayland
  • NVIDIA Wayland support improved significantly since driver 535+ but may still have issues

Common Causes

  • Application not supporting Wayland natively and running via XWayland with scaling issues
  • Screen sharing in video calls failing because the app uses X11 capture methods
  • Missing xdg-desktop-portal for the desktop environment preventing screen capture
  • NVIDIA driver version too old to support Wayland properly
  • Fractional scaling causing blurry XWayland applications

Steps

  1. 1Check if an app runs on Wayland or XWayland: xprop command works only on XWayland windows
  2. 2For Electron apps: set --enable-features=UseOzonePlatform --ozone-platform=wayland
  3. 3Install screen sharing support: sudo apt install xdg-desktop-portal-gnome pipewire
  4. 4For Firefox screen sharing: set widget.use-xdg-desktop-portal.screen-share to true in about:config
  5. 5For NVIDIA: update to driver 535+ and ensure nvidia-drm modeset is enabled in kernel parameters
  6. 6If scaling is blurry: set GDK_SCALE=2 for GTK apps or QT_SCALE_FACTOR=2 for Qt apps using XWayland

Tags

waylandxwaylanddisplayscreen-sharingscaling

Related Items

More in System

Frequently Asked Questions

Wayland isolates applications for security — X11 capture methods do not work. Install xdg-desktop-portal and PipeWire, then use a portal-aware screen sharing method.