Actions

If you edit or add a macro action, Macro Recorder opens an action configuration window.

You can manually enter/adjust the parameters in the dialog or use the mouse to "point & click" on your desktop to define X/Y coordinates and additional parameters.

Actions can have a text label for a comment or as a jump mark for use with the Goto, Repeat, Focus and pixel color detection action.

To enter, edit or delete a label, click into the column "label".

The labels "Start", "End" and "Next" are reserved by Macro Recorder.

If you change a label, that is used as a jump mark, make sure to update all actions, that jumps to the corresponding action.

Mouse click

ClickClicks or double-clicks at the specified position with the left/middle/right/X1/X2 mouse button as defined.

To define the click position, enter the X/Y coordinates or simply click at the desired position.

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 mouse position.

"X1" / "X2" are extra mouse buttons of advanced 5 button mouse devices.

SmartClick

The SmartClick action first waits until a defined image area appears on the screen and then clicks in the center of the found image area.

To prepare the controlled program before the click, for example to remove the marking of an entry in a drop-down menu, which would otherwise falsify the image area detection, proceed as follows:

  1. Create a SmartClick action.
  2. With the SmartClick configuration window open, press the capture hotkey (the default is the space bar).
  3. Move the mouse to the desired click position and press the capture hotkey again.
  4. Now the click position is fixed, which is illustrated by a crosshair.
  5. If necessary, configure the program so that the image area is visible as desired at the click position.
  6. Press the hotkey capture for a last time to let Macro Recorder analyse the prepared screen area around the click position.

Choose a click position that differs graphically from the rest of the desktop. Otherwise, Macro Recorder may abort the image area analysis with a hint that the image area is not unique; for example, when clicking on a larger monochrome area. SmartClick is not suitable for this.

The click area is captured without the influence of the mouse pointer ("hover effects"). The capture takes about 1-3 seconds.

Mouse move

Moves the mouse pointer from the start to the end position:

Enter the start/end coordinates or define them by clicking the start point followed by the end point.

The mouse path shape can be configured in the playback properties.

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 mouse position.

Mouse scroll-wheel

Simulates turning the mouse scroll-wheel in "virtual" pixels. Playback may be affected/translated/changed by the mouse drivers.

We recommend to record the wheel action to get predictable results. Keep in mind that mouse driver settings may differ between computers.

Keypress

Simulates a single key press.

Macro Recorder sends the virtual key code, scan code and extended key flag to the operating system. You can specify a separate key-down and key-up event to allow adding automation in between.

To simulate pressing a keyboard shortcut "hotkey", consider using the dedicated "hotkey" action.

For longer text (vs single key presses), consider using the Text input action.

Hotkey

Simulates pressing a hotkey combination (such as CTRL+ALT+ D).

After defining the hotkey combination, Macro Recorder compiles the shortcut into individual key down and up events in the macro script.

Text input

This action item combines multiple key press events to a single text input event for easier macro editing.

To automate entering long phrases we strongly recommend to combine Macro Recorder with our Text Expander PhraseExpress.

Wait

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 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 fixed time.

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

Wait for hotkey

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

wait.pngPauses macro playback until the specified file exist or alternatively if the file changed or if the file attributes changed.

Pixel color detection

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 pixel colors, check out this step-by-step video tutorial.

Detect image

Detect image pauses the macro playback until Macro Recorder detects the specified image.

The search scope can be restricted to a defined search 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 out 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 optionally position the mouse pointer to the center (or any edge) of the detected image.

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. A smaller search image and smaller search region increases 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.

Window change

Waits for the appearance of a window, defined by its window title and class. You can leave either entry empty or use * as a placeholder in the window title/class text string.

If the window exist, Macro Recorder switches focus to that window and optionally restores the windows dimensions and position if it differs from the dimensions at the time of the macro recording to ensure that all recorded mouse actions fit.

Macro playback will cancel if the window cannot be restored to the required size.

Macro actions following a window change are visually grouped by a customizable background color for better readability.

The time-out section provides fallback options if the window does not appear within the configured wait time. The macro execution can either abort, repeat from scratch or ignore the no-show of the color and just continue.

Goto

Jumps to the action with the specified label. The macro plackback aborts if the label doesn't exist.

Repeat

Jumps to the specified label for the given number of repetitions or amount of time. After the last repetition it jumps to the action with the specified label.