Hyprland Wiki
Contribute to the Wiki!Toggle Dark/Light/Auto modeToggle Dark/Light/Auto modeToggle Dark/Light/Auto modeBack to homepage


XWayland is the bridging mechanism between legacy Xorg programs and Wayland compositors.

HiDPI XWayland

XWayland currently looks pixelated/blurry on HiDPI screens, due to Xorg’s inability to scale. There are attempts to add a standard scaling mechanism, such as MR 733.

You can use this MR’s wlroots implementation in Hyprland by making a few changes.

The following instructions assume you know how to patch programs, either manually or using your favourite package manager.

See instructions for manual patching and Pacman patching.

  1. Have the latest xwayland package patched with at least the HiDPI patch (based on the MR’s implementation, but updated).

  2. Make sure you have the required Hyprland wlroots, patched with the HiDPI xwayland patch and this commit reverted. This is important, as not reverting it will make opening XWayland programs crash Hyprland.

  3. Add this line to your configuration:


    and configure toolkits to scale using their specific mechanisms, such as

    export GDK_SCALE=2
    export XCURSOR_SIZE=32
    The GDK_SCALE variable won't conflict with wayland-native GTK programs.