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 specified by its label.

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:

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.

Macro Recorder can detect within a bitmap but the text must be regular text like on this web page. For "picturesque" text, please rather try the image recognition.

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 specified time-out, Macro Recorder can cancel the script or jump to any other section of your script, specified by its label.

The on screen text recognition feature uses a high-performance text recognition algorithm. Keep the text and search region small to maximize text recognition performance.

Experienced users only: Tick the "RegEx term" checkbox to search for complex text patterns. Macro Recorder checks against the entire text found in the specified search region on your desktop. Using ^ and $ in your Regex query will only match if the entire desktop consists of the search term only.

Adding languages

By default, the OCR feature supports a selection of languages. As the OCR feature is based on the project Tesseract, you can download and add additional languages offered at the Tesseract project page.

To add additional languages:
  1. Download the desired *.traineddata language file(s).
  2. Exit Macro Recorder.
  3. Copy the downloaded *.traineddata file into the Macro Recorder program folder "%programfiles(x86)%\MacroRecorder\tessdata\" (without "").
  4. Restart Macro Recorder.

The added languages should now be offered in the language selector of the OCR action dialog.