wshot

Screenshot Tool for Wayland/GNOME

Take screenshots of specific windows by app name, PID, title, or window ID.

Usage

# List all windows (returns JSON)
uv run ${CLAUDE_PLUGIN_ROOT}/skills/wshot/wshot.py list

# Capture by app name
uv run ${CLAUDE_PLUGIN_ROOT}/skills/wshot/wshot.py capture firefox -o /tmp/shot.png

# Capture by PID
uv run ${CLAUDE_PLUGIN_ROOT}/skills/wshot/wshot.py capture --pid 1234 -o /tmp/shot.png

# Capture by title substring
uv run ${CLAUDE_PLUGIN_ROOT}/skills/wshot/wshot.py capture --title "GitHub" -o /tmp/shot.png

Capture by window ID

uv run ${CLAUDE_PLUGIN_ROOT}/skills/wshot/wshot.py capture --id 2889387148 -o /tmp/shot.png

## Workflow

1. First run `list` to see available windows and their properties
2. Pick the target window by app name, PID, title, or ID
3. Run `capture` with the appropriate selector and output path
4. The output path is printed on success

## Output Format

The `list` command returns JSON:
```json
[
  {
    "id": 2889387148,
    "app": "Alacritty",
    "title": "Terminal",
    "pid": 12711,
    "x": 0, "y": 29,
    "w": 1920, "h": 1051,
    "focused": true
  }
]

Requirements

• GNOME with Wayland
• window-calls extension (script will prompt to install if missing)
• If GNOME blocks the screenshot, a dialog appears - user clicks "Share"

When to Use

Use this skill when the user asks to:

• Take a screenshot of a window or application
• Capture what's on screen
• Get an image of a running app
• Screenshot something by name or PID