wayland-portal-e2e

Approves GNOME XDG Desktop Portal screen-sharing prompts remotely during Wayland display-capture E2E tests.

14|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/intendant-dev/Intendant --skill wayland-portal-e2e-intendant-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wayland-portal-e2e
Source: https://github.com/intendant-dev/Intendant/tree/main/skills/wayland-portal-e2e
Command: npx skills add https://github.com/intendant-dev/Intendant --skill wayland-portal-e2e-intendant-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? GNOME's XDG Desktop Portal screen-sharing dialog cannot be approved with sudo, D-Bus calls, or shell input tools, which blocks automated Intendant Wayland display-capture E2E tests on remote VMs where no operator sits at the console. ## Core Features & Use Cases - Remote Portal Approval: Sets up GNOME Remote Desktop with temporary TLS credentials, tunnels RDP over SSH, and wraps FreeRDP in a signed macOS app bundle so Computer Use can see and click the real portal dialog. - Headed Browser Validation: Runs Station/dashboard headed Chromium validation on remote Wayland hosts by importing the graphical session environment from systemctl --user show-environment, including dual-GPU Vulkan/WebGPU configuration. - Troubleshooting & Cleanup: Documents known traps (wtype, grim, portal input errors, missing Allow Remote Interaction toggle) and provides verification and cleanup commands. - Use Case: Trigger an Intendant display grant on a remote GNOME Wayland VM, then approve the portal dialog through the FreeRDP window and verify the PipeWire stream starts. ## Quick Start Set up GNOME Remote Desktop on the Wayland VM, tunnel RDP to my Mac, and approve the Intendant screen-sharing portal dialog through the FreeRDP window.

Frequently Asked Questions about wayland-portal-e2e

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I approve the GNOME screen-sharing portal dialog remotely?▼

Enable GNOME Remote Desktop on the Wayland VM with grdctl, tunnel RDP over SSH to the local machine, and open the session in FreeRDP. Then trigger the display grant and click Share in the real portal dialog inside the RDP window.

Why can't I approve the XDG Desktop Portal prompt with sudo or wtype?▼

GNOME portal approval is compositor and session policy, not Unix file permission, so sudo, direct D-Bus calls, and wtype do not grant screen-sharing consent. wtype also fails because GNOME does not support the virtual keyboard protocol.

Why does execute_cu_actions fail after the portal was approved?▼

The portal was likely approved for screen sharing without enabling Allow Remote Interaction, causing errors like Session is no longer active. Revoke and re-grant the display, then toggle Allow Remote Interaction on before clicking Share.

How do I run headed Chromium validation on a remote Wayland host?▼

Import the graphical session variables from systemctl --user show-environment before launching, since non-login SSH shells lack DISPLAY and WAYLAND_DISPLAY. The validate-dashboard.cjs helper does this automatically for Linux --headed runs.

How do I get hardware WebGPU working on a dual-GPU Intel and NVIDIA Wayland host?▼

Set VK_ICD_FILENAMES and VK_DRIVER_FILES to the NVIDIA ICD and launch Chromium with --ozone-platform=x11 and --enable-features=Vulkan, since Wayland-ozone is incompatible with Chromium's Vulkan path. Verify adapter.info.vendor reports nvidia.