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 color detection on screen in RunMacro

What it does

The Multi Color command scans the screen for pixels matching hex colors you specify (one or several). If found, RunMacro can move/click there or branch — handy when state is shown by color.

When to use it

Detect state by color (green = ready, red = error).
Find a button/bar with a distinctive color.
Check if a region changed color before acting.
Automate games based on color (health, mana...).

Configuration steps

Add an Image › Multi Color command.
Enter one or more hex colors (e.g. #FF0000). Up to 10.
Adjust tolerance to accept near shades.
(Optional) draw a region for faster scanning.
Choose the action when found and set IF/ELSE labels. Save.

Every option explained

Colors (one or more, hex)

The colors to detect as #RRGGBB. Matching any one counts. Up to 10 colors.

Tolerance

Allowed color difference. Larger = catches near shades; smaller = requires a close match.

Search region

Limit where to scan. Leave empty for the whole screen.

Action when found

None, move to it, click, double-click, or right-click at the matched pixel.

Retries + delay between tries (ms)

Retries until the color appears. Use it when the state changes slowly.

IF label / ELSE label

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

Real example

Example: wait for a green light then continue

Get the green status color (e.g. #22C55E).
Add Multi Color, enter the hex, moderate tolerance.
Action none, IF label = ready.
Put the next steps under the ready label.

Tips & common mistakes

Grab the exact color with a color picker first, then paste it into the command.

On-screen colors can drift due to theme/brightness — raise tolerance slightly if it misses.