Troubleshooting

Macro Recorder is very easy to use and should work fine "out-of-the-box". However, technical limitations and unavoidable inteferences may require to troubleshoot your recording. Please find tips and tricks to get your macro running as expected:

Window focus change

Make sure that the defined window title matches the actual title in the desired window.

Note, that the title may change dynamically:
  • The browser title shows the currently loaded web page title which is different on different web pages.
  • Editing programs show the current file name and path which is currently being edited.
  • Database programs may use the currently selected database item in the program title.

By the way, program names (vs titles) sometimes also have confusingly weird names. Microsoft UWP programs may show different titles than expected. The Microsoft browser "Edge" has the edgy program name "ApplicationFrameHost.exe".

Let Macro Recorder scan the program name and window title:
  1. In the window change action, click the the cross-hair button.
  2. Click the window you want Macro Recorder to switch focus to.

Use the wildcard for dynamically changing window titles: Replace "MyWonderfulDocument.doc - Word" with "* - Word" if you want to switch to Word, regardless of the name of the file currently loaded in Word.

Mouse clicks

The standard click action clicks a static X/Y coordinate. Keep in mind, that the position of click items may vary, especially in web browsers.

The position of items in a web browser is affected by:
  • Advertisement banners or dynamic contents.
  • The browser zoom (CTRL-+/-)
  • Activation/Deactivation of script blocker (Adblock, Ghostery, etc.).
  • Responsive webpage contents such as collapsing/expanding (navigation) menus.
  • Dynamic stylesheets (dark mode, mobile view, styling skins)
  • Different content depending on a logged in/out state.
Suggestions:
  • Use window change to let Macro Recorder restore the browser window position and size.
  • Double-check the "relative mouse coordinate" setting and disable it if you don't want to use it.
  • Automate a reset to achieve a consistent experience. E.g. CTRL-0 resets browser zoom.

SmartClick and Image Recognition

Step-by-Step video tutorial

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.

Make sure that the desired program window has focus if the action is configured to search the bitmap in the currently focussed program.

Clicked items which are captured by Smart Click must have consistent size, shape and color. Macro Recorder captures the item with the appearance at the time of the click. If its appearance change, SmartClick cannot find it anymore as it doesn't match the recorded bitmap around the click position.

Clicked links or button in a web browser may have a different color.

SmartClicks may not be detected if running the macro from a computer with different DPI setting ("Retina") or antialiasing settings as it slightly affect the appearance of user interface controls.

Ensure a consistent browser viewing scale. If you record a zoomed page, SmartClicks would not work with differing zoom settings. Consider resetting zoom with the browser hotkey CTRL-0.

Check if any blue-light filter software may affect the desktop color scheme.