Keyboard Maestro 5 IconKeyboard Maestro 5

Conduct your Mac Like a Pro!

Conditions

Keyboard Maestro includes a variety of Control Flow Actions which perform actions depending on a set of conditions.

The condition clause of the flow control actions can be any of:

This is followed by a set of specific conditions. If there are no conditions in the set at all, the action will not execute anything except the Until action which will execute the actions once. Neither side of the If Then Else will execute.

The available conditions include:

Application
test if an application is running (or not) or at the front (or not).
Front Window
test if the front window exists or has a desired title (or not).
Button
test if a button exists (or not) or is enabled (or not).
Menu
test if a menu item exists (or not) or is enabled (or not).
Modifiers
test if particular modifiers are pressed or not pressed.
Key
test if a particular key is down or up.
Typed String
test if a typed string trigger with remember case was a particular case.
Disk
test if a disk is mounted or not.
Path
test if something, a file or folder exists at a particular path (or now).
Clipboard
test if the clipboard contains text or an image (or not) or specific text (or not).
Variable
test if a variable exists or is empty or contains specific text (or not).
Calculation
test if a calculation returns non zero.
Environment Variable
test if an envirnment variable exists or contains specific text (or not).
Pixel
test if a pixel on the screen is or is brighter/darker, more or less blue, etc that a particular color.
Location
test if the network name is or contains specific text (or not).
Script
test if a script succeeds or returns particular status or specific text (or not).

Generally, a pixel condition should be considered a last resort, but there are certain cases where it may be useful - keep in mind that you can use expresions for calculating the location of the pixel too.

See also the Control Flow, Variables and Calculations sections.

Continue on to Recording

Close

Feedback Form

Please provide any feedback you may have


Email Address:
Subject:
Feedback:


Your email address is appreciated but is not required and will not be saved.
It will be used only for responding to or clarifying this feedback.

Documentation

Old Documentation