From 761f1d76536c996c6be43448c6adb1d611fde44f Mon Sep 17 00:00:00 2001 From: Kovid Goyal Date: Wed, 16 Jul 2025 08:55:58 +0530 Subject: [PATCH] ... --- docs/kittens/desktop-ui.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/kittens/desktop-ui.rst b/docs/kittens/desktop-ui.rst index 35b9cc03d..92bfc4d65 100644 --- a/docs/kittens/desktop-ui.rst +++ b/docs/kittens/desktop-ui.rst @@ -113,3 +113,14 @@ Read the ``portals.conf`` man page and run:: this will output a lot of debug information, which should tell you which backend is chosen for which service. Read the debug output carefully to determine why the kitten is not being selected. + +If some GUI applications are not using the choose-files kitten for their file +select dialogs, then make sure the environment variables mentioned above are +set, you can also try running the the GUI application with them set explicitly, +as:: + + QT_QPA_PLATFORMTHEME=xdgdesktopportal GTK_USE_PORTAL=1 my-gui-app + +Note that not all applications use portals, so if some particular application +is failing to use the portal but others work, report the issue to that +applications' developers.