Keyboard Maestro supports calculations in almost any numeric text fields. For example you can Pause for “60*Time in Minutes”. Calculations can also use comma separated lists of numbers as arrays, and can return such arrays, so you can operate on frames and points. Numeric fields often start small with up/down step arrows, but if you type anything other than a number they will expand to allow a more complex expression to be entered. You can tell that a field accepts calculations because a small C shows in the field while editing it.
will result in the mouse being placed at the center of the front window.
Note: You must use commas for this purpose, and full stops (.) for decimal numbers, and never use any thousands separators, regardless of your desired language.
Keyboard Maestro’s expressions include precedence, nested bracketed expressions, many built-in functions, various numeric bases, so you should be able to write almost any expressions you might like to use, as well as use it as a general purpose calculator if desired.
Operators based on precedence from lowest to highest are:
|array separator (,)||separates elements of an array|
|ternary operator (?)||a=b ? 3 : 4|
|bitwise or (|), bitwise and (&) and bitwise xor||operators|
|comparison operators (<, ≤, =, >, ≥, ≠)||compare for (in)equality and return 0 or 1|
|shift operators (≪, ≫)||shift a number left or right|
|addition operators (+, -)||add or subtract|
|multiplication operators (*, /, MOD)||multiply, divide or Modulo|
|power operator (^)||exponentiation|
|unary prefix operators (√ (Option-V), -, brackets)||square root, negation, sub-expressions|
|functions||a large variety of functions|
|numbers and variables or array accesses (5,$5A,0x50,8#007,Variable,Variable)||identifiers and values|
|unary postfix operators (!,%,° (Option-Shift-8))||factorial, percent, degrees|
You can use either
== (v8+) for testing for equality.
Operators and functions must be in uppercase to minimize conflict with variables.
The available functions are listed on the wiki Functions page.
Variables are used unadorned in numeric calculations. Do not try to use tokens (like
%Variable%MyVar%) in numeric calculation fields, just use MyVar by itself. The variable must contain a valid numeric value, or an expression (v8+) that evaluates to a valid numeric value. So for example, if MyVar contains a text value of
2*3, then the calculation
4*MyVar will return 24.
Keyboard Maestro refers to screen coordinates as two or four comma separated numbers in the text of a Keyboard Maestro Variable (which is always a string).
If a variable contains a sequence of numbers separated by comma (,) then you can access that variable using array notation (eg
MyVar). So if variable MyVar has a text value of
10,20,30,40,50,60, MyVar will return 50.
The index is itself an expression, so it can be arbitrarily complex.
Indices are 1-based, so MyVar is the first element. If the index is 0, the size of the array is returned (so MyVar would be
6). If the index is less than zero, the array is indexed from the end (so MyVar[-5] would be
In a Calculation field you can reference the numbers in a Keyboard Maestro Variable (which is always a string) using dot notation:
|Variable.left||the left coordinate of a rectangle|
|Variable.top||the top coordinate of a rectangle|
|Variable.right||the right coordinate of a rectangle|
|Variable.bottom||the right coordinate of a rectangle|
|Variable.width||the width of a rectangle or size|
|Variable.height||the height of a rectangle or size|
|Variable.fuzz||the fuzz of an image match (rectangle,fuzz)|
|Variable.MidX||the horizontal middle of a rectangle|
|Variable.MidY||the vertical middle of a rectangle|
The Variable Name and Dot reference are case insensitive.
In calculation fields, you can express a calculation as you would normally write an expression, for example:
3 * Count + 7
However in a text field, since any text is allowed, you must use percent encoded tokens to indicate where more processing is required. You can include a variable in the text by using the %Variable% token, or you can use a calculation by using the %Calculate% token, or any number of other Tokens.
The result is %Calculate%3 * Count + 7%.
Some example expressions might be:
Amount in Dollars * 100 MJD() > 55928 NOW() > TIME(2012,3,23,12,2,1) DOW(TIME(2012,4,4)) = 4 Radius*SIN(20°),Radius*COS(20°) Window Frame+Window Frame/2,Window Frame.MidY MOUSEBUTTON() + 2 * MOUSEBUTTON(4) SCREEN(Internal,Left,10%)