OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
apps-services medium common DISPUTE

Make links from Flatpak apps open in the browser on Hyprland/wlroots

archomarchyendeavouroscachyoshyprlandwaylandflatpakxdg-desktop-portal
AUDITED Audited against its sources and confirmed accurate.
AUDIT NOTE

Verified against upstream: xdg-desktop-portal-hyprland's hyprland.portal declares only org.freedesktop.impl.portal.Screenshot;ScreenCast;GlobalShortcuts;InputCapture, no OpenURI, no FileChooser, so the cause is exactly right. The config path ~/.config/xdg-desktop-portal/<desktop>-portals.conf, the [preferred] section and the default=hyprland;gtk syntax match xdg-desktop-portal's documented lookup, and the Arch package xdg-desktop-portal-gtk exists (it is already in Omarchy 4's base package list, so the pacman step is usually a no-op there). The xdph package ships no hyprland-portals.conf of its own, so the user file is genuinely needed. One nit: the verify command is weak. org.freedesktop.portal.OpenURI is exposed by the portal *frontend* regardless of whether any backend implements it, so it will be listed even when broken. Verifying by actually clicking a link (or flatpak run --command=xdg-open <app> https://archlinux.org) is the real test.

Symptom

Clicking a hyperlink inside a Flatpak app (Discord, Element, Signal, a Flatpak IDE) does nothing at all. No browser window, no error dialog. Other apps open links fine.

Cause

Flatpak apps open URIs through the org.freedesktop.portal.OpenURI.OpenURI D-Bus interface. The wlroots-family backends (xdg-desktop-portal-wlr and xdg-desktop-portal-hyprland) do not implement the OpenURI / App-chooser / FileChooser portals: they only cover ScreenCast, Screenshot and Global Shortcuts. With no backend implementing the interface, the call silently fails.

Fix

Install the generic GTK backend to fill the gap and set it as the default fallback:


sudo pacman -S xdg-desktop-portal-gtk
mkdir -p ~/.config/xdg-desktop-portal
cat > ~/.config/xdg-desktop-portal/hyprland-portals.conf <<'EOF'
[preferred]
default=hyprland;gtk
org.freedesktop.impl.portal.FileChooser=gtk
org.freedesktop.impl.portal.OpenURI=gtk
org.freedesktop.impl.portal.ScreenCast=hyprland
org.freedesktop.impl.portal.Screenshot=hyprland
EOF
systemctl --user restart xdg-desktop-portal.service xdg-desktop-portal-gtk.service

Also make sure a default browser is registered:


xdg-settings set default-web-browser <your-browser>.desktop

Verify

Click a link in the Flatpak app. The browser opens. busctl --user introspect org.freedesktop.portal.Desktop /org/freedesktop/portal/desktop | grep OpenURI shows the interface is present.

Sources

flatpak-links-dont-open-on-wlroots