https://wiki.keyboardmaestro.com/ 2026-05-07T09:45:37+00:00 https://wiki.keyboardmaestro.com/ https://wiki.keyboardmaestro.com/_media/wiki/logo.png text/html 2023-06-20T04:42:38+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/Action_Result?rev=1687236158&do=diff The Action Result condition (v8+) tests the %ActionResult% token containing the results of the last action to complete. This token contains either OK for a successful completion of the action, or an error message of some sort. Keep in mind the Action Result will be cleared at the end of any successful action, so if you want to know why the actions failed you will need to handle the Action Result immediately, or alternatively save the %ActionResult% in a variable and use the text/html 2017-09-06T04:54:19+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/Any_Window?rev=1504673659&do=diff The Any Window condition searches a specified application (or the front application) for a window with a title that: * is (case insensitively) exactly a specified string. * is not (case insensitively) exactly a specified string. * contains (case insensitively) a specified string. text/html 2019-07-01T05:53:55+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/Application?rev=1561960435&do=diff Application Condition The Application condition looks for an application and determines if it: * is currently running. * is not currently running. * is currently at the front. * is not currently at the front. * is currently running but not at the front. text/html 2017-09-06T04:54:12+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/Button?rev=1504673652&do=diff The Button condition looks for a standard Mac button in the front window. It can find a button with a name that is exactly a specified string, containing a specified string, or matching a specified regular expression. The condition can return true if: * a matching button exists. text/html 2017-09-06T04:51:00+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/Calculation?rev=1504673460&do=diff The Calculation condition evaluates a calculation which can include variables and functions and returns true if the result is valid and anything other than zero. For much more detail, see: Calculations in the Keyboard Maestro Manual See Also Actions * If Then Else * Pause Until Conditions Met * Execute Action Until Conditions Met * See all Actions Conditions * See all Conditions text/html 2019-07-15T04:03:35+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/Clipboard?rev=1563163415&do=diff Clipboard Condition The Clipboard condition looks at the current system clipboard, or in v8+, the Trigger Clipboard or a Named Clipboard, and determines if it currently meets any one of several criteria. You select the comparison criteria in the PopUp list. For more information about text/html 2017-11-14T05:32:03+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/Environment_Variable?rev=1510637523&do=diff The Environment Variable condition looks at the system environment variables that make up Keyboard Maestro Engine's environment and determines if the specified environment variable: * exists. * does not exist. * is empty. * is not empty. * is exactly (case insensitively) a specified string. text/html 2023-09-18T08:22:48+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/File_Attribute?rev=1695025368&do=diff File Attribute condition The File Attribute condition (v11.0+) checks a file attribute to see if it has a specified value. File Attributes Available * file type (Directory, Package, File, Symlink, Socket, Character Special, Block Special, or Unknown). text/html 2019-07-08T05:17:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/Found_Image?rev=1562563067&do=diff Found Image Condition The Found Image condition tests for a matching image on your screen(s) or windows. Example After an Action like this is executed, and an image was found, then the %FoundImage% token (v8+) will return the coordinates, size, and fuzz of the image. text/html 2022-12-03T18:23:21+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/Front_Window?rev=1670091801&do=diff The Front Window condition looks at the front window of a specified application (or the front application) to determine if: * It exists. * It does not exist. * The title is (case insensitively) exactly a specified string. * The title is not (case insensitively) exactly a specified string. text/html 2017-09-06T04:50:38+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/Key?rev=1504673438&do=diff The Key condition determines if a specified key on the keyboard is pressed or not. See Also Actions * If Then Else * Pause Until Conditions Met * Execute Action Until Conditions Met * See all Actions Conditions * See all Conditions text/html 2017-11-14T05:33:13+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/Location?rev=1510637593&do=diff The Network Location condition determines if the current network location name: * is exactly (case insensitively) a specified string. * is not exactly (case insensitively) a specified string. * contains (case insensitively) a specified string. * text/html 2023-09-18T07:46:46+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/Macro?rev=1695023206&do=diff Macro or Macro Group Condition Condition Values The Macro or Macro Group Condition determines if a specified macro or macro group is: * enabled * disabled * active * inactive * is executing (v11.0+) * is not executing (v11.0+) Definitions For a macro group to be active, it must be enabled, and the requirements of the macro group configuration must be met. Macro Groups can also be activated and deactivated manually. text/html 2017-09-06T04:54:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/Menu?rev=1504673687&do=diff The Menu condition looks for a matching menu in the system menu bar and tests its state. You can look for a menu with a name that: * exactly matches a specified string. * contains (case insensitively) a specified string. * matches a specified regular expression. text/html 2017-09-06T04:52:53+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/Modifiers?rev=1504673573&do=diff The Modifiers condition determines if the specified modifiers are pressed or not. You can check for whether any of the modifiers (Control, Option, Shift, Command or Caps Lock) are pressed, or are released. See Also Actions * If Then Else * Pause Until Conditions Met * Execute Action Until Conditions Met * Type Modifiers * See all Actions Conditions text/html 2017-09-06T04:52:45+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/Mounted_Volume?rev=1504673565&do=diff The Mounted Volume condition looks for a mounted volume with name that: * exactly matches a specified string. * contains (case insensitively) a specified string. * matches a specified regular expression. and then checks whether it: * is mounted. * is not mounted. text/html 2017-09-06T04:13:32+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/Mouse_Button?rev=1504671212&do=diff The Mouse Button condition (v8+) tests whether the specified mouse button is currently pressed or not pressed. See Also Actions * If Then Else * Pause Until Conditions Met * Execute Action Until Conditions Met * See all Actions Conditions * See all Conditions text/html 2023-09-13T03:07:30+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/OCR?rev=1694574450&do=diff OCR Condition The OCR condition (v9.0+) extracts the text from an image using OCR (Optical Character Recognition) (specifically using Apple Text Recognition (v11+ and macOS 10.15+) or the Tesseract OCR library) and determines if it currently meets the specified. [ OCR Condition ] The source image can be pasted into the action, or read from the System Clipboard, Trigger Clipboard, a Named Clipboard, or a file, or you can get the image from the screen. text/html 2023-09-18T07:48:58+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/Path?rev=1695023338&do=diff Path condition The Path condition checks the file system at a specified path to determine if: * nothing exists. * something exists. * a file exists. * a file does not exist. * a folder exists. * a folder does not exist. See Also Actions * text/html 2017-09-06T04:52:21+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/Pixel?rev=1504673541&do=diff The Pixel condition checks the color of a specified pixel on the screen. The location is defined by the X and Y coordinate relative to the top left corner of the main screen. As with all numeric fields, the numbers can be calculations including functions, and the fields expand to allow for longer expressions as soon as you type something other than a number. text/html 2021-10-18T08:52:24+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/Script?rev=1634547144&do=diff The Script condition executes a script and checks the result. The script can be in a file or text within the application, and can be: * an AppleScript. * a Shell script. * a Swift script. * a JavaScript for Automation (JXA) script. * a JavaScript in Front Browser script (v9.0+). text/html 2017-11-14T05:31:53+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/Text?rev=1510637513&do=diff The Text condition evaluates a text token string and then checks if it: * is empty. * is not empty. * is exactly (case insensitively) a specified string. * is not exactly (case insensitively) a specified string. * contains (case insensitively) a specified string. text/html 2017-09-06T04:52:13+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/Typed_String?rev=1504673533&do=diff The Typed String condition checks if the macro was triggered with a Typed String trigger that allowed case to affect actions, and then case was either: * uppercase * title case * otherwise For a typed string trigger to be uppercase, all the “letters text/html 2017-11-14T05:33:39+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/USB_Device?rev=1510637619&do=diff The USB Device condition looks for a USB Device with a name that: * is exactly (case insensitively) a specified string. * contains (case insensitively) a specified string. * matches a specified regular expression. and then checks whether it: * exists. * does not exist. text/html 2024-05-21T06:28:05+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/Variable?rev=1716272885&do=diff Variable condition The Variable condition looks at a Keyboard Maestro variables and determines if the variable: * exists. (deprecated and removed in v11.0.3+) * does not exist. (deprecated and removed in v11.0.3+) * is empty. * is not empty. * text/html 2025-07-09T09:11:19+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/Wireless_Network?rev=1752052279&do=diff The Wireless Network condition looks for a wireless network with: * a name that is exactly (case insensitively) a specified string. * a name that contains (case insensitively) a specified string. * a name that matches a specified regular expression. * a BSSID that exactly matches a specified string.