RunMacro™
Download
HomeFeaturesPricingDocsFree ToolsDownloadManagerBlogFAQAbout
Docs

RunMacro Documentation

Create your first robot, then go further as needed.

Clear step-by-step guides to create, run, and improve robots for repetitive computer work.

Docs Mouse Mouse Click
🖱 Mouse

Automate mouse clicks in RunMacro

Applies to: RunMacro 3.x • Updated September 2026

Mouse Click presses the left, right, or middle mouse button at given coordinates — it runs in both Desktop Mode (system pointer) and Browser Mode (dispatched into the page through Chrome CDP). 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.
  • Browser Mode — Runs in the background through Chrome CDP: the click is sent into the page using viewport coordinates without taking over the real mouse. Jitter and Random X/Y are skipped in this mode.

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. There is also a Move option that only moves the pointer there without pressing. This is the most basic and most-used command in automation.

Screenshots & video#

RunMacro Mouse Click command configuration dialog showing parameter fields
Configuration dialog and parameter fields for the Mouse Click command in RunMacro.

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#

  1. In RunMacro, click add-command and choose Mouse › Mouse Click.
  2. Click Pick target (or press F2) — the screen dims.
  3. Move the cursor to the exact spot to click, then press the mouse — the X, Y coordinates fill in automatically.
  4. Choose the mouse button: Left / Right / Middle / Move (Left by default).
  5. Optionally enable Double Click or adjust the natural-timing options (below).
  6. 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 / Move)#

Which button to press. Left to select/click; Right for the context menu; Middle is rare (open in new tab, scroll); Move only moves the pointer to the coordinates without pressing — useful when a hover is needed to reveal a menu.

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#

  1. Add a Mouse Click command.
  2. Press F2, aim at the "Sign in" button, then click to capture the coordinates.
  3. Keep the Left button, leave Double Click off.
  4. Set Delay after run = 800ms to wait for the page.
  5. 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
RunMacro robot

Robots do the work. Your time is yours.

Create a robot in minutes, no coding needed. Reliable execution, remote management, transparent costs — and you always stay in control.

Download for WindowsExplore Docs