Keyboard Maestro Wiki

**This is an old revision of the document!**

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.

You can test the result of executing the script:

• returns success (that is, the script ran without errors).
• returns an error (the script returned some sort of error code).
• returns a specific status code (unlike almost all other numeric fields, this cannot be a calculation).
• returns not text. (v8+)
• returns some text. (v8+)
• returns text that is exactly a specified string.
• returns text that is not exactly a specified string.
• returns text that is contains a specified string.
• returns text that is does not contain a specified string.
• returns text that starts with (case insensitively) a specified string. (v8+)
• returns text that ends with (case insensitively) a specified string. (v8+)
• returns text that is alphabetically before a specified string. (v7.2+)
• returns text that is alphabetically after a specified string. (v7.2+)
• returns text that is matches a specified regular expression.
• returns text that is does not matches a specified regular expression.
• returns text that is numerically less than a specified calculation. (v8+)
• returns text that is numerically less than or equal to a specified calculation. (v8+)
• returns text that is numerically equal to a specified calculation. (v8+)
• returns text that is numerically greater than or equal to a specified calculation. (v8+)
• returns text that is numerically greater than a specified calculation. (v8+)
• returns text that is numerically not equal to a specified calculation. (v8+)

The script will receive the Keyboard Maestro variables in its environment as usual for any executed script in Keyboard Maestro.

See Also

Actions

Conditions