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 Image Find Image
🖼 Image

Automate clicks by image recognition in RunMacro

Applies to: RunMacro 3.x • Updated September 2026

Find Image searches for a visual template in a screen region, retries as configured, and acts when it finds a match.

Prerequisites#

  • A clear sample image matches the target interface.
  • The target screen or Browser tab is ready.

Supported modes#

  • Desktop Mode
  • Browser Mode

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.

Screenshots & video#

RunMacro Find Image command configuration dialog showing parameter fields
Configuration dialog and parameter fields for the Find Image command in RunMacro.

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.

When not to use it#

  • The interface has a stable HTML selector and should be targeted through the DOM.
  • The sample changes substantially between runs.

Configuration steps#

  1. Add an Image › Find Image command.
  2. Add one or more sample images (crop the button/icon to find).
  3. (Optional) draw a search region for faster, more accurate matching.
  4. Choose the action when found: none / move / click / double-click / right click.
  5. Set retries and delay between tries if the image appears slowly.
  6. 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.

Expected result#

RunMacro reports whether the image was found and performs the configured branch or action.

Real example#

Example: wait for a "Download" button then click#

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

Limitations and failure cases#

  • Resolution, DPI, theme, and image quality affect matching.
  • Full-screen searches can be slower than a restricted region.

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.

Verification details#

  • commands/capture.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