- Home
- Skills
- Testing & Debugging
- Screenshare Doctor: fix screen sharing on Linux Wayland
More screenshots
Works with the AI Agents you already use
Screenshare Doctor: fix screen sharing on Linux Wayland
Finds out why screen sharing fails on GNOME, KDE Plasma or Hyprland (no picker, black screen, missing windows) and which layer is at fault.
Free
Screenshare Doctor: fix screen sharing on Linux Wayland
Example session with this skill installed
When I click Share screen in Discord on my GNOME laptop, no picker appears. What's wrong?
- Read your context and instructions
- Compiled the screenshare doctor
Summary
Ran uvx screenshare-doctor troubleshoot screenshare --app discord --symptom no-picker. Session: Wayland, desktop GNOME, xdg-desktop-portal 1.21.1. Most likely cause: SSD-PORTAL-002, ScreenCast is disabled by a portals.conf.
| Check | Status | Result |
|---|---|---|
| SSD-SESSION-004 | PASS | Portals see the same desktop and display |
| SSD-DBUS-001 | PASS | The session bus answers |
| SSD-SERVICE-001 | PASS | xdg-desktop-portal.service is active |
| SSD-PORTAL-001 | PASS | The portal frontend offers ScreenCast (version 5) |
| SSD-PORTAL-002 | FAIL | ScreenCast is disabled by a portals.conf |
| SSD-DESKTOP-001 | FAIL | The setup differs from GNOME's defaults (because of the above) |
| SSD-COMPOSITOR-001 | PASS | org.gnome.Mutter.ScreenCast is running |
What's going on
~/.config/xdg-desktop-portal/portals.conf sets ScreenCast to none. The running portal reads its configuration only when it starts, so it still keeps its old choice until it is restarted.
Fix
- Remove the
noneentry from~/.config/xdg-desktop-portal/portals.conf, unless you meant to disable screen sharing. - Restart the portal:
systemctl --user restart xdg-desktop-portal.service - Check:
screenshare-doctor routes explain ScreenCast
Nothing was started, changed or recorded, and no screen-sharing request was made. Want me to make the edit and restart the portal?
Connects securely to your tools. The creator never sees your data.
About this skill
You click Share screen and get a black frame, no picker, the wrong windows or a permission error. On Wayland the cause can be the app, how it was launched (native, Flatpak, XWayland), xdg-desktop-portal routing, the desktop's portal backend, PipeWire, WirePlumber or the compositor.
This skill has your agent start from the app and the symptom and run the open-source screenshare-doctor checks. It names the most likely cause first, with the evidence and the fix.
What it does
troubleshoot screenshare --app discord --symptom no-pickerchecks the layers that explain what you see, most likely cause first- Symptoms: no picker, black screen, a missing window, permission denied, only some apps
- Hints for Firefox, Chrome and Chromium-based browsers, Electron apps (Discord, Slack, Signal, VS Code) and OBS, each with a source
routes explain ScreenCastnames the portal backend that handles screen sharing and theportals.confline that decides it- A redacted report you can paste into a bug tracker
Tested on real GNOME, KDE Plasma and Hyprland sessions.
Safety
Passive: no command opens a screen-sharing request or picker, records anything, starts, restarts or stops a service, or changes configuration, and it never needs sudo. When a fix needs a restart or a config edit, the skill tells your agent to show the command and wait for your yes.
Network
The first run downloads screenshare-doctor from PyPI through uvx. The tool itself is offline.
MIT licensed. Source and docs: https://github.com/BhuwanJoshi-01/screenshare-doctor
Requires Linux desktop session with Python 3.11+. Does not work over SSH or in containers. Passive only; cannot fix issues without user approval to run suggested commands.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Free forever
No account required to browse
Trust & safety
Security scan
Security scan passed 11 days ago
- Free with an Agensi account
Requires
Permissions
Runs the passive screenshare-doctor CLI in the terminal. It reads the session's environment variables (XDG_CURRENT_DESKTOP, WAYLAND_DISPLAY and similar), portal configuration files, and the services and D-Bus names that are already running, without starting any. Network: one package download from PyPI through uvx.