Docs

RunMacro Documentation

Learn RunMacro from basics to advanced.

Everything you need to start and master RunMacro — from basic commands to advanced automation workflows.

Ctrl K

🖱 Mouse

Automate mouse clicks in RunMacro

Mouse Click is a Desktop Mode command that presses the left, right, or middle mouse button at screen coordinates. It works best for stable layouts; use Find Image or Smart HTML when the target moves.

Prerequisites

The target application is open on the screen to automate.
Coordinates were captured with F2 or verified manually.
Resolution, display scaling, and window position match the setup used to capture the point.

Supported modes

Desktop Mode — Controls the system pointer and can take over the cursor while running.

What it does

The Mouse Click command makes RunMacro automatically click the mouse (left, right, or middle) at a screen position you choose — it clicks for you, hands-free. This is the most basic and most-used command in automation.

When to use it

Click a button, input box, or icon in an app or website.
Open a menu, choose an item, or confirm a dialog.
Turn on Double Click to open a file/folder.
Use the right button to open a right-click context menu.

When not to use it

The web element frequently moves or the window may be repositioned.
You need to keep using the mouse while the workflow runs.
The target is too small for Random X/Y or Jitter to remain inside it.

Configuration steps

In RunMacro, click add-command and choose Mouse › Mouse Click.
Click Pick target (or press F2) — the screen dims.
Move the cursor to the exact spot to click, then press the mouse — the X, Y coordinates fill in automatically.
Choose the mouse button: Left / Right / Middle (Left by default).
Optionally enable Double Click or adjust the natural-timing options (below).
Click Save. The Mouse Click command is now ready in your script.

Every option explained

X, Y coordinates

The click position in pixels from the top-left corner of the screen. Prefer the Pick target button (F2) to capture it instead of typing.

Mouse button (Left / Right / Middle)

Which button to press. Left to select/click; Right for the context menu; Middle is rare (open in new tab, scroll).

Double Click

Enable to click twice quickly (open a file, folder, select a word...). Leave off for a single click.

Use current mouse position

When on, the command clicks wherever the cursor currently is and ignores X, Y. Useful when a previous command already moved the mouse there.

Random X, Y

Lets the click land a few pixels around the target (for example ±3px) to test targets with positional tolerance. Set 0 for an exact click.

Click jitter + jitter (px)

Adds a small natural-timing wobble right before pressing; jitter is the max pixel offset. Keep on for realism, off for pixel-perfect precision.

Micro-delay before click + Min/Max (ms)

Waits a tiny random moment (e.g. 30–150ms) just before pressing, mimicking human reaction time so the action looks more natural.

Delay after run

How long to wait after clicking before the next command runs. This is a random Min–Max range (default 500–1500ms) — each run picks a value in the range to look human.

Expected result

RunMacro presses the configured mouse button at the selected coordinates, then waits for the configured delay before continuing.

Real example

Example: auto-click a "Sign in" button

Add a Mouse Click command.
Press F2, aim at the "Sign in" button, then click to capture the coordinates.
Keep the Left button, leave Double Click off.
Set Delay after run = 800ms to wait for the page.
Save and test — RunMacro will click the Sign in button for you.

Limitations and failure cases

Fixed coordinates do not adapt to layout, DPI, or window-position changes.
The click may hit the wrong place if the target app is not foregrounded or ready.
Random X/Y and Jitter are unsuitable for targets with a narrow clickable area.

Tips & common mistakes

If a button moves around, use Find Image or Smart HTML instead of a fixed coordinate.

Coordinates depend on resolution, display scaling, and window position. Re-check them after moving to another machine or layout.

Enable Random X/Y or Jitter only when the full offset area remains a valid target.

Verification details

commands/mouse.py