Bitmap/text detection

Macro Recorder can search a customizable region of the desktop for an image pattern or any text (with OCR text recognition) and jump to a specified section of the macro script.

Find image

This action pauses the macro playback until Macro Recorder finds the specified image in the specified search area:

The search scope can be restricted to a region relative to either the desktop or the active program window. Restricting the search region increases performance as less screen real estate needs to be monitored. It also excludes unwanted screen areas, where Macro Recorder shall not look for the image.

You can adjust the color tolerance, allowing Macro Recorder to detect images which are not 100% identical with the search image, e.g. if font rasterization slightly alters the desktop.

If the image is detected, Macro Recorder can position the mouse pointer to the center (or any edge) of the detected image.

If a click action follows the image recognition, make sure to configure a click action with relative mouse coordinates with X and Y set to zero (or an intentional offset of your choice).

Macro Recorder then proceeds with the next action or alternatively branch to the action of your macro script you specified by its label.

If the image does not appear within a specifed time-out, Macro Recorder can cancel the script or jump to any other section of your script.

This action uses a custom high-performance pattern matching algorithm. Keep the search image and search region small to maximize image recognition performance. The search image only needs to be as large to be distinguishable from the rest of the search region. For example, if waiting for an icon you don't need to search for an entire button but just a fraction of it.

Find text on screen (OCR)

Video tutorial

This action performs an on-screen text recognition to find the specified text in the specified search area. This can also be text within a bitmap in any program:

The search scope can be restricted to a region relative to either the desktop or the active program window. Restricting the search region increases performance as less screen real estate needs to be monitored. It also excludes unwanted screen areas, where Macro Recorder shall not look for the text.

Experienced users can also use Perl RegEx to search for complex text patterns.

If the text is found, Macro Recorder can position the mouse pointer to the center (or any edge) of the detected text.

If a click action follows the text recognition, make sure to configure a click action with relative mouse coordinates with X and Y set to zero (or an intentional offset of your choice).

Macro Recorder then proceeds with the next action or alternatively branch to the action of your macro script you specified by its label.

If the text does not appear within a specifed time-out, Macro Recorder can cancel the script or jump to any other section of your script.

This action uses a custom high-performance text recognition algorithm. Keep the text and search region small to maximize text recognition performance.