Fix an X11 app never receiving the file you picked in the GTK dialog
The first half is correct and useful: XDPH genuinely does not implement a file picker (the wiki carries an explicit warning to install xdg-desktop-portal-gtk alongside it), the 25-second figure is the real D-Bus timeout, and the Steam 'Add Library Folder' note is right. The DISPLAY drop-in is the problem. Portal results are returned to the caller over D-Bus via the Response signal. They do not travel over the X connection, so 'can show the dialog but cannot hand the result back to an XWayland client' is not a real mechanism. At most a DISPLAY lets the GTK portal make the dialog transient-for an X11 parent window. And hardcoding DISPLAY=:0 is a guess. Hyprland's XWayland can land on :1 or higher when another X server is present, in which case the drop-in points the portal at the wrong display. Telling a user to write a persistent systemd override on a false premise is the part worth removing.
Updated on 2026-09-13: this record pointed readers at xwayland-apps-blurry-hidpi, which was retired that day into xwayland-blurry-on-fractional-scale. The pointer now names the surviving record, which carries the toolkit environment variables this one sends the reader for.
Symptom
In an X11/XWayland application, clicking "Open File" pops up the GTK file dialog, you pick a file, the dialog closes, and nothing happens. The app never receives the file. Or the dialog takes ~25 seconds to appear at all.
Cause
xdg-desktop-portal-hyprland implements no file picker at all, so xdg-desktop-portal-gtk has to be installed alongside it. With nothing claiming org.freedesktop.impl.portal.FileChooser the call blocks for the 25-second D-Bus timeout and then gives up. Note that portal results are returned to the caller over D-Bus via the Response signal and do not travel over the X connection, so a missing DISPLAY in the portal user service's environment does not break the result path. At most it stops the GTK dialog being made transient-for an X11 parent window.
Fix
Make sure the GTK backend is installed and is the declared FileChooser provider, because XDPH does not implement a file picker at all:
sudo pacman -S --needed xdg-desktop-portal-gtk
Check what is actually claiming the interface, and whether a backend is timing out rather than missing:
ls /usr/share/xdg-desktop-portal/portals/
cat /usr/share/xdg-desktop-portal/hyprland-portals.conf
journalctl --user -u xdg-desktop-portal -u xdg-desktop-portal-gtk -b --no-pager | tail -50
default = hyprland;gtk with org.freedesktop.impl.portal.FileChooser = gtk is already the shipped default, so only write ~/.config/xdg-desktop-portal/hyprland-portals.conf if you are changing the routing (e.g. to kde).
Then restart the stack:
systemctl --user restart xdg-desktop-portal-gtk.service xdg-desktop-portal.service
Do NOT add a DISPLAY=:0 systemd drop-in for xdg-desktop-portal-gtk. Portal results are returned to the calling app over D-Bus, not over the X connection, so a missing DISPLAY cannot swallow your file selection. Hyprland's XWayland is also not guaranteed to be :0, so hardcoding it can point the portal at a display that does not exist. If you want the dialog to be modal over an X11 parent, import the real value instead of guessing it:
echo $DISPLAY
systemctl --user import-environment DISPLAY
systemctl --user restart xdg-desktop-portal-gtk.service
Better still, move the app off XWayland so the problem cannot occur. See the xwayland-blurry-on-fractional-scale record for the toolkit env vars.
Steam has its own broken internal picker. Installing xdg-desktop-portal-gtk is exactly what makes "Add Library Folder" work.
Verify
In an XWayland app, open a file dialog and pick a file. The app actually loads it, and the dialog appears in well under a second.