This documentation is for Macro Recorder v4 beta. Click here the for current production version 3 documentation.

Wait functions

Macro Recorder can pause the macro playback for a defined time in milliseconds, wait for a keypress, text input, file change event, pixel color change or appearance of a bitmap or text in a customizable area of the computer desktop.

Wait time

Pauses macro playback for the specified time in milliseconds (msec), allowing the computer to complete operations.

The time required to load a web page or to perform a computation may vary significantly, depending on the current CPU load and other factors, such as power saving schemes and other tasks running in the background. The wait time must be long enough to support the slowest computer under worst conditions.

Consider using the image, OCR text or pixel color detection as it significantly minimizes proceeds with the automation in the very moment, the computer completed the current task instead of waiting a static time.

1 second = 1,000 msec. 1 minute = 60,000 msec.1 hour = 3.600.000 msec.

Wait for hotkey press

Pauses macro playback until the specified hotkey is pressed by the user.

The time required to load a web page or to perform a computation may vary significantly, depending on the current CPU load and other factors, such as power saving schemes and other tasks running in the background. The action allows you to add break points within your script.

You can also use this action to loop through a number of the same wait for hotkey actions to use several hotkeys to branch to different sections of your script.

Consider using the pixel color detection as it significantly minimizes proceeds with the automation in the very moment, the computer completed the current task instead of waiting until you manually press a hotkey.

Wait for text input

Pauses macro playback until the specified text has been entered by the user.

Wait for file event

Pauses macro playback until the specified file exist or alternatively if the file changed or if the file attributes changed:

Wait for pixel color change

Video tutorial

Pauses the macro playback until a specified display pixel changes to the specified color:

Macro Recorder often needs to pause until a process is finished, a calculation is done or a website is loaded before the macro script can proceed. However, there is no direct communication of the controlled applications which could tell Macro Recorder to continue.

But there is a trick: As most operations on your computer cause program windows, buttons, labels or images to appear, to disappear or to change, this visual clue can be used as a trigger by Macro Recorder ProEdition . Any such change on the monitor cause pixels to change to a specific color. Colors may change depending on the actual image or state of a button (which reflects the state of a program).

Example: If you want Macro Recorder to automate your browser, it has to wait until a web page has loaded. A good indicator would be the web page icon ("favicon") in the to left of the browser title bar.

The "pixel color detection" action monitors the color change of a specific pixel. If the pixel changes to the defined color, the macro continues with the action, specified by the label (default is the next step).

A customizable timeout cancels or restart the recording or jump to a another section of the recording, specified by a label.

This function maximizes the automation speed while assuring that even the slowest computers is able to keep up with the macro.

If you don't want to affect the underlying application with a mouse click, press the customizable capture hotkey (default is the space bar) to capture the pixel position.

To check for multiple different pixel colors, check out this step-by-step video tutorial.

Wait for change on desktop

This function waits for any change in the defined region of the desktop.

If a change has been detected, it can either click on the changed area of the screen, save the XY coordinates of the screen change or branch to a specified section of your script which is defined by its label.

If no change has been detected in the defined time period, the function can option branch to another section of your script.

Table of Contents


Table of Contents