More screenshots

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIDeepSeekDeepSeekMuseMuse+22 more

    Screenshare Doctor: fix screen sharing on Linux Wayland

    2

    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

    Security scanned
    Screenshare Doctor: fix screen sharing on Linux Wayland

    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.

    CheckStatusResult
    SSD-SESSION-004PASSPortals see the same desktop and display
    SSD-DBUS-001PASSThe session bus answers
    SSD-SERVICE-001PASSxdg-desktop-portal.service is active
    SSD-PORTAL-001PASSThe portal frontend offers ScreenCast (version 5)
    SSD-PORTAL-002FAILScreenCast is disabled by a portals.conf
    SSD-DESKTOP-001FAILThe setup differs from GNOME's defaults (because of the above)
    SSD-COMPOSITOR-001PASSorg.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

    1. Remove the none entry from ~/.config/xdg-desktop-portal/portals.conf, unless you meant to disable screen sharing.
    2. Restart the portal: systemctl --user restart xdg-desktop-portal.service
    3. 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-picker checks 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 ScreenCast names the portal backend that handles screen sharing and the portals.conf line 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

    Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for Testing & Debugging.

    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. 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. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before buying a skill.

    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 to use

    No account required to browse

    Trust & safety

    Security scan

    Security scan passed 11 days ago

    • Free with an Agensi account

    Software
    Pythonuv (Python tool runner)

    Permissions

    Terminal / Shell
    Write Files
    Network Access
    Read Files
    Environment Variables

    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.

    Listed11 days ago

    What's inside

    Frequently Asked Questions

    No picker when you click Share, a black or frozen frame, a window that isn't offered, a permission error, and only some apps' windows being shareable. It has sourced hints for Firefox, Chrome and Chromium-based browsers, Electron apps such as Discord, Slack, Signal and VS Code, and OBS.

    No. It never opens a sharing request or picker, records anything, starts, restarts or stops a service, or changes configuration, and never needs sudo. When the fix is a restart or an edit, the skill tells your agent to show the command and wait for your yes.

    It is tested on real GNOME, KDE Plasma and Hyprland sessions, and compares your setup with what GNOME, KDE Plasma, Hyprland and wlroots ship by default. A desktop is listed as supported only after such a test.

    Python 3.11 or newer and uv or pipx, run inside the Linux desktop session you want to diagnose (not over SSH or in a container). The first run downloads the tool from PyPI.

    Generic advice can't see your machine. screenshare-doctor reads your actual session, the portal routing (the portals.conf line that picks the backend, using your portal version's rules), and the running services and D-Bus names, then points at the layer that fails, with the evidence.

    Yes. screenshare-doctor report --output screenshare-report.md writes a redacted report that is safe to paste.

    New in Testing & Debugging

    Free