Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Universal HiDPI mouse click handling for Linux desktop automation. Auto-detects scale factor or allows calibration for any screen resolution/DPI. Converts Claude display coordinates to xdotool screen coordinates.
Universal HiDPI mouse click handling for Linux desktop automation. Auto-detects scale factor or allows calibration for any screen resolution/DPI. Converts Claude display coordinates to xdotool screen coordinates.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Universal mouse coordinate handling for desktop automation across different screen configurations.
# Click at Claude display coordinates (auto-scales) ./scripts/click.sh 500 300 # First time? Run calibration for best accuracy ./scripts/calibrate.sh
When Claude displays a screenshot, it scales it down. This skill converts coordinates: Claude Display Coords โ Scale Factor โ xdotool Screen Coords The scale factor depends on: Screen resolution (1080p, 1440p, 4K, etc.) DPI settings (96, 144, 192, etc.) Claude's display viewport
./scripts/click.sh <x> <y> # Auto-scaled click ./scripts/click.sh --raw <x> <y> # No scaling (screen coords) ./scripts/click.sh --double <x> <y> # Double click ./scripts/click.sh --right <x> <y> # Right click
./scripts/calibrate.sh # Interactive calibration ./scripts/calibrate.sh info # Show current config ./scripts/calibrate.sh test # Test current scale ./scripts/calibrate.sh set 2.08 # Manually set scale ./scripts/calibrate.sh reset # Reset to auto-detect
./scripts/detect-scale.sh # Returns scale (e.g., 2.08)
./scripts/move.sh <x> <y> # Move mouse ./scripts/drag.sh <x1> <y1> <x2> <y2> # Drag ./scripts/reliable_click.sh <x> <y> [--window "Name" --relative]
For best accuracy on your specific system: ./scripts/calibrate.sh This will: Create a calibration image with markers at known positions Ask you where the markers appear in Claude's display Calculate and save the exact scale factor
ScreenDPITypical Scale1920ร1080961.0 - 1.22560ร1440961.3 - 1.53024ร17721922.083840ร21601922.0 - 2.5
# Run calibration ./scripts/calibrate.sh # Or manually adjust ./scripts/calibrate.sh set 2.1 # Try different values
./scripts/calibrate.sh info
./scripts/calibrate.sh reset rm -f /tmp/hidpi_scale_cache
~/.config/hidpi-mouse/scale.conf - User-set scale (highest priority) /tmp/hidpi_scale_cache - Auto-detected scale cache (1 hour TTL)
This skill auto-adapts to: โ Different screen resolutions (1080p to 4K+) โ Different DPI settings (96, 120, 144, 192, etc.) โ HiDPI/Retina displays โ Multi-monitor setups (primary display)
Always calibrate on a new system for 100% accuracy Re-calibrate if you change display settings Use --raw if you already have screen coordinates Check calibrate.sh info to see current settings
# 1. Take screenshot scrot /tmp/screen.png # 2. View in Claude, identify button at display coords (500, 300) # 3. Click it ./scripts/click.sh 500 300 # 4. If off-target, calibrate ./scripts/calibrate.sh Tested on: Ubuntu/Debian with X11, various resolutions and DPI settings
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.