XDG portals
Set up screen sharing, clipboard, keyring, and file pickers using XDG portals.
Portal Configuration
You can customize portal settings via the following paths:
- User Configuration (Priority):
~/.config/xdg-desktop-portal/mango-portals.conf - System Fallback:
/usr/share/xdg-desktop-portal/mango-portals.conf
If you previously added dbus-update-activation-environment --systemd WAYLAND_DISPLAY XDG_CURRENT_DESKTOP=wlroots to your config, remove it. Mango now handles this automatically.
Screen Sharing
To enable screen sharing (OBS, Discord, WebRTC), you need xdg-desktop-portal-wlr.
Install Dependencies
pipewire, pipewire-pulse, xdg-desktop-portal-wlr
Restart your computer to apply changes.
Known Issues
-
Window screen sharing issue:
https://github.com/mangowm/mango/pull/184 -
Screen recording lag or stuttering:
https://github.com/emersion/xdg-desktop-portal-wlr/issues/351
Clipboard Manager
Use cliphist to manage clipboard history.
Dependencies: wl-clipboard, cliphist, wl-clip-persist
Autostart Config:
# Keep clipboard content after app closes
wl-clip-persist --clipboard regular --reconnect-tries 0 &
# Watch clipboard and store history
wl-paste --type text --watch cliphist store &GNOME Keyring
If you need to store passwords or secrets (e.g., for VS Code or Minecraft launchers), install gnome-keyring.
Configuration:
Create ~/.config/xdg-desktop-portal/portals.conf:
[preferred]
default=gtk
org.freedesktop.impl.portal.Secret=gnome-keyringFile Picker (File Selector)
- Dependencies
xdg-desktop-portal,xdg-desktop-portal-gtk - Reboot your computer once to apply.