From 00361ef69a0bd805a15b9ced0b43a2c09059d05f Mon Sep 17 00:00:00 2001
From: Rdeisenroth <53945743+Rdeisenroth@users.noreply.github.com>
Date: Fri, 8 Mar 2024 17:36:34 +0100
Subject: [PATCH] document how to use the KDE file picker with XDPH (#512)

---
 pages/Useful Utilities/Hyprland-desktop-portal.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/pages/Useful Utilities/Hyprland-desktop-portal.md b/pages/Useful Utilities/Hyprland-desktop-portal.md
index 5fb0476..c64bf91 100644
--- a/pages/Useful Utilities/Hyprland-desktop-portal.md	
+++ b/pages/Useful Utilities/Hyprland-desktop-portal.md	
@@ -119,6 +119,16 @@ systemctl --user import-environment QT_QPA_PLATFORMTHEME
 
 If it works, add it to your config in an `exec-once`.
 
+## Using the KDE file picker with XDPH
+
+XDPH does not implement a file picker and uses the GTK one as a fallback by default (see `/usr/share/xdg-desktop-portal/hyprland-portals.conf`). If you want to use the KDE file picker but let XDPH handle everything else, create a file `~/.config/xdg-desktop-portal/hyprland-portals.conf` with the following content:
+```properties
+[preferred]
+default=hyprland;gtk
+org.freedesktop.impl.portal.FileChooser=kde
+```
+You can read more about this in the [xdg-desktop-portal documentation in the Arch Wiki](https://wiki.archlinux.org/title/XDG_Desktop_Portal). Note that some applications like Firefox might require additional configuration to use the KDE file picker.
+
 ## Debugging
 
 If you get long app launch times, or screensharing does not work, consult the logs.