Learn RunMacro from basics to advanced.

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

Ctrl K

🖼 Image

Automate clicks by image recognition in RunMacro

What it does

The Find Image command screenshots the screen and checks whether a sample image (a button, an icon...) appears. If found, RunMacro can move to it, click it, or branch on the result. It is the reliable way to click when element positions shift.

When to use it

A button/icon moves around, so a fixed coordinate click will not work.
Wait for an image to appear before acting (e.g. a "Continue" button).
Branch: if the image is found do A, otherwise do B.
Automate games/apps that have no selectors.

Configuration steps

Add an Image › Find Image command.
Add one or more sample images (crop the button/icon to find).
(Optional) draw a search region for faster, more accurate matching.
Choose the action when found: none / move / click / double-click / right click.
Set retries and delay between tries if the image appears slowly.
Set IF/ELSE labels to branch. Save.

Every option explained

Sample images (one or more)

The images to look for on screen. Add several; matching any one counts as found.

Search region

Limit the search area for speed and accuracy. Leave empty to scan the whole screen.

Action when found

None (just check), move to it, click, double-click, or right-click at the image center.

Confidence

Minimum match level (e.g. 0.9). Higher = stricter but may miss; lower = looser but may mismatch.

Scale range (min/max)

Lets the sample match even if a bit larger/smaller — useful across resolutions.

Retries + delay between tries (ms)

Retries until the image appears. Use it when an element loads slowly.

IF label / ELSE label

If found, jump to the IF label; if not found after all retries, jump to ELSE.

Click jitter + micro-delay

Adds small wobble/delay on click for a human feel (when the action is click).

Browser Mode target tab (title/URL)

In Browser Mode, choose which Chrome tab to capture by title or URL.

Real example

Example: wait for a "Download" button then click

Crop the "Download" button as the sample image.
Add Find Image, choose the click action.
Set 25 retries, 200ms between tries.
Point the ELSE label to a fallback when the button is missing.

Tips & common mistakes

Crop the sample tight to the distinctive part (icon/text) — avoid changing backgrounds for stable matching.

Set a search region to scan much faster and reduce false matches.

If confidence is too high and the resolution/theme changes, it may not match — loosen confidence a bit or use the scale range.