โ† All skills
Tencent SkillHub ยท Developer Tools

HiDPI Mouse

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.

skill openclawclawhub Free
0 Downloads
0 Stars
0 Installs
0 Score
High Signal

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.

โฌ‡ 0 downloads โ˜… 0 stars Unverified but indexed

Install for OpenClaw

Quick setup
  1. Download the package from Yavira.
  2. Extract the archive and review SKILL.md first.
  3. Import or place the package into your OpenClaw setup.

Requirements

Target platform
OpenClaw
Install method
Manual import
Extraction
Extract archive
Prerequisites
OpenClaw
Primary doc
SKILL.md

Package facts

Download mode
Yavira redirect
Package format
ZIP package
Source platform
Tencent SkillHub
What's included
SKILL.md, scripts/move.sh, scripts/calibrate.sh, scripts/reliable_click.sh, scripts/click.sh, scripts/detect-scale.sh

Validation

  • Use the Yavira download entry.
  • Review SKILL.md after the package is downloaded.
  • Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

  1. Download the package from Yavira.
  2. Extract it into a folder your agent can access.
  3. Paste one of the prompts below and point your agent at the extracted folder.
New install

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.

Upgrade existing

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.

Trust & source

Release facts

Source
Tencent SkillHub
Verification
Indexed source record
Version
1.0.0

Documentation

ClawHub primary doc Primary doc: SKILL.md 16 sections Open source page

HiDPI Mouse Skill

Universal mouse coordinate handling for desktop automation across different screen configurations.

๐Ÿš€ Quick Start

# Click at Claude display coordinates (auto-scales) ./scripts/click.sh 500 300 # First time? Run calibration for best accuracy ./scripts/calibrate.sh

๐Ÿ“ How It Works

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

click.sh - Click at coordinates

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

calibrate.sh - Setup & Configuration

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

detect-scale.sh - Get scale factor

./scripts/detect-scale.sh # Returns scale (e.g., 2.08)

Other scripts

./scripts/move.sh <x> <y> # Move mouse ./scripts/drag.sh <x1> <y1> <x2> <y2> # Drag ./scripts/reliable_click.sh <x> <y> [--window "Name" --relative]

๐ŸŽฏ Calibration (Recommended for New Systems)

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

๐Ÿ“Š Common Scale Factors

ScreenDPITypical Scale1920ร—1080961.0 - 1.22560ร—1440961.3 - 1.53024ร—17721922.083840ร—21601922.0 - 2.5

Clicks are offset

# Run calibration ./scripts/calibrate.sh # Or manually adjust ./scripts/calibrate.sh set 2.1 # Try different values

Check current configuration

./scripts/calibrate.sh info

Reset everything

./scripts/calibrate.sh reset rm -f /tmp/hidpi_scale_cache

๐Ÿ“ Configuration Files

~/.config/hidpi-mouse/scale.conf - User-set scale (highest priority) /tmp/hidpi_scale_cache - Auto-detected scale cache (1 hour TTL)

๐ŸŒ Universal Compatibility

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)

๐Ÿ’ก Usage Tips

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

๐Ÿ“ Example Workflow

# 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

Category context

Code helpers, APIs, CLIs, browser automation, testing, and developer operations.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package
5 Scripts1 Docs
  • SKILL.md Primary doc
  • scripts/calibrate.sh Scripts
  • scripts/click.sh Scripts
  • scripts/detect-scale.sh Scripts
  • scripts/move.sh Scripts
  • scripts/reliable_click.sh Scripts