This documentation is for Macro Recorder v3 beta. Click here the for current production version 2 documentation.

Mouse & keyboard 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

Clicks or double-clicks at the specified position with the left/middle/right/X1/X2 mouse button:

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

You can also configure a mouse click with an relative offset of the current mouse pointer position.

To capture the mouse pointer position without affecting 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.

Macro Recorder clicks relative to the program window *if* the focus change action is used. It uses the desktop coordinate system otherwise.


In many cases, you know what to click but not the exact position as items may appear at slightly different locations, e.g. buttons shifted by dynamic advertisements on a webpage.

SmartClick solves the problem by clicking on a defined bitmap area instead of static X/Y coordinates.

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 performing the actual 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:

Video tutorial

  1. Select the SmartClick buttonin the main menu bar or press hotkey S to 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.

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.

Two consecutive move actions are merged into one single move actions.

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.


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 a long key press that outputs the same letter over and over, use the key press action with key down(!) and use the Repeat action to repeat the key down event. After that, use the key press action with the option key up to release the key (video tutorial).

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.

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.


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:

Table of Contents

Table of Contents