Skip to main content
MangoWCMangoWC
Configuration

XDG portals

Set up screen sharing, clipboard, keyring, and file pickers using XDG portals.

Screen Sharing

To enable screen sharing (OBS, Discord, WebRTC), you need xdg-desktop-portal-wlr.

Install Dependencies

pipewire, pipewire-pulse, xdg-desktop-portal-wlr

Update Autostart

Add this to your autostart.sh or exec-once config to ensure dbus knows about the environment.

Environment Variables:

dbus-update-activation-environment --systemd WAYLAND_DISPLAY XDG_CURRENT_DESKTOP=wlroots

Portal Service:

The portal service line is not necessary. It only avoids situations where the service may not start automatically.

# The path may be /usr/lib/ or /usr/libexec/ depending on distribution
/usr/lib/xdg-desktop-portal-wlr

After configuration, restart your computer once to apply all changes properly.

Known Issues

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-keyring

File Picker (File Selector)

  • Dependencies xdg-desktop-portal, xdg-desktop-portal-gtk
  • Reboot your computer once to apply.

Input Devices

Configure keyboard layouts, mouse sensitivity, and touchpad gestures.

Miscellaneous

Advanced settings for XWayland, focus behavior, and system integration.

On this page

Screen Sharing
Known Issues
Clipboard Manager
GNOME Keyring
File Picker (File Selector)