https://wiki.keyboardmaestro.com/ 2026-05-01T00:08:07+00:00 https://wiki.keyboardmaestro.com/ https://wiki.keyboardmaestro.com/_media/wiki/logo.png text/html 2023-09-20T04:35:17+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/ABS?rev=1695184517&do=diff ABS Function The ABS(x) function takes a number and returns the absolute value of it. Eg: ABS(5) === ABS(-5) === 5 See Also Functions * See all Functions text/html 2025-11-27T08:39:24+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/ACOS?rev=1764232764&do=diff ACOS Function The ACOS(x) function returns the arccosine of its argument which must be in the range -1 to 1 inclusive. If ACOS(x)=y, then COS(y)=x. See Also Functions * See all Functions text/html 2023-09-20T04:02:52+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/APPLICATIONS?rev=1695182572&do=diff APPLICATIONS Function The APPLICATIONS() function returns the number of running applications. See Also Functions * See all Functions text/html 2023-09-20T04:02:49+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/ASIN?rev=1695182569&do=diff ASIN Function The ASIN(x) function returns the arcsine of its argument which must be int he range -1 to 1 inclusive. If ASIN(x)=y, then SIN(y)=x. See Also Functions * See all Functions text/html 2023-09-20T04:02:46+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/ATAN?rev=1695182566&do=diff ATAN Function The ATAN(x) function returns the arctangent of its argument. If ATAN(x)=y, then TAN(y)=x. See Also Functions * See all Functions text/html 2023-09-20T04:02:42+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/ATAN2?rev=1695182562&do=diff ATAN2Function The ATAN2(y,x) function returns the arctangent of its two arguments. The purpose of using two arguments instead of one is to to return the appropriate quadrant of the resulting angle, which is not possible for the single argument ATAN function. For arguments y,x, not both zero, this function returns the angle in radians between the x-axis and the point (x,y). Note that the arguments to ATAN2 are y,x, not the usual x,y order. Also note that y is in the mathematical direction, p… text/html 2023-09-20T04:07:23+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/BATTERY?rev=1695182843&do=diff BATTERY Function The BATTERY() function returns whether the Mac is currently running off battery power. It returns 0 if the Mac is connected to a power source or 1 if it is running off the battery. See Also Functions * See all Functions text/html 2023-09-20T04:08:31+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/BIN?rev=1695182911&do=diff BIN Function The BIN(t) function takes an arbitrary token text string, processes the text tokens, and then evaluates the result as a binary number. BIN(1000_1010) BIN(1101) See Also Actions * Set Variable to Calculation Action * See all Actions Functions * BIN * OCT * HEX * CALCULATE * See all Functions Tokens * %Bin% * %Oct% * %Hex% * %Calculate% * text/html 2023-09-20T04:08:37+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/CALCULATE?rev=1695182917&do=diff CALCULATE Function The CALCULATE(t) function takes an arbitrary token text string, processes the text tokens, and then calculates value of the resulting numeric expression. CALCULATE(%ICUDateTime%yyyyMMdd%/10000) CALCULATE(%CurrentClipboard%) See Also Actions text/html 2023-09-20T08:39:27+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/CEIL?rev=1695199167&do=diff CEIL Function The CEIL(x) function takes a number and returns the first integer that is greater than or equal to the argument: CEIL(5.5) === CEIL(5.1) === CEIL(6) === 6 CEIL(-5.5) === CEIL(-5.1) === CEIL(-5) === -5 The CEIL() function (v11.0+) takes a second optional parameter to indicate the number of decimal digits to operate to: text/html 2025-07-18T07:58:19+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/CHARACTERS?rev=1752825499&do=diff CHARACTERS Function The CHARACTERS(t) function takes an arbitrary token text string, processes the text tokens, and then returns the number of characters in the string. CHARACTERS(%CurrentClipboard%) CHARACTERS(%Variable%MyVar%) Example See Also Actions text/html 2023-09-20T04:09:53+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/CHROMEISCOMPLETE?rev=1695182993&do=diff CHROMEISCOMPLETE Function The CHROMEISCOMPLETE() function returns whether Google Chrome has currenlty finished loading the current tab. See Also Actions * actions:Click Browser Link * actions:Browser Form Actions * actions:Browser Window Actions * See all Actions Functions * CHROMETABCOUNT() * CHROMETABINDEX() * See all Functions text/html 2023-09-20T04:09:59+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/CHROMETABCOUNT?rev=1695182999&do=diff CHROMETABCOUNT Function The CHROMETABCOUNT() function returns the number of tabs in the front Google Chrome window. See Also Actions * actions:Click Browser Link * actions:Browser Form Actions * actions:Browser Window Actions * See all Actions Functions * CHROMEISCOMPLETE() * CHROMETABINDEX() * See all Functions text/html 2023-09-20T04:10:06+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/CHROMETABINDEX?rev=1695183006&do=diff CHROMETABINDEX Function The CHROMETABINDEX() function returns the index of the selected tab in the front Google Chrome window. See Also Actions * actions:Click Browser Link * actions:Browser Form Actions * actions:Browser Window Actions * See all Actions Functions * CHROMEISCOMPLETE() * CHROMETABCOUNT() * See all Functions text/html 2023-09-20T04:10:18+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/CLIPBOARDSEED?rev=1695183018&do=diff CLIPBOARDSEED Function The CLIPBOARDSEED() function returns an integer that changes when the clipboard changes. It will never repeat, so you can use this to test when the clipboard has changed. See Also Functions * See all Functions text/html 2023-09-20T04:10:32+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/CONCEALEDPALETTES?rev=1695183032&do=diff CONCEALEDPALETTES Function The CONCEALEDPALETTES() function returns whether the Keyboard Maestro palettes are currently concealed. It returns 1 if the palettes are concealed, or 0 if they are being displayed normally (v7.0+). See Also Functions * text/html 2023-09-20T04:10:42+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/COS?rev=1695183042&do=diff COS Function The COS(x) function returns the cosine of its argument which is an angle in radians from the x-axis. See Also Functions * See all Functions text/html 2023-09-20T04:10:52+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/COSH?rev=1695183052&do=diff COSH Function The COSH(x) function returns the hyperbolic cosine of its argument which is a hyperbolic angle. See Also Functions * See all Functions text/html 2023-09-20T04:11:49+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/COUNT?rev=1695183109&do=diff COUNT Function The COUNT() (v9.0+) function returns the size of the enclosing JSON array. This function is a special context sensitive function that only works while evaluating a JSON path. See Also See the JSON user manual section for more details on JSON. Actions text/html 2023-09-20T04:12:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/DARKMODE?rev=1695183167&do=diff DARKMODE Function The DARKMODE() function (v9.0+, OS X 10.14+) returns 1 is the system is in Dark Mode, 0 otherwise. The function will always return 0 in systems before OS X 10.14 Mojave. See Also Actions * Set Keyboard Maestro Dark Mode * Set System Dark Mode * See all Actions Functions * DARKMODE * See all Functions text/html 2023-09-20T07:18:14+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/DAY?rev=1695194294&do=diff DAY Function The DAY([unixtime]) function returns the day of the month (1-31), either the current day, or the day of the specified unixtime. DAY() === the current day DAY( unixtime ) === the day of the month of the unix time Unix Time (also known as POSIX time or Epoch time) is a system for describing instants in time, defined as the number of seconds that have elapsed since 00:00:00 Coordinated Universal Time (UTC), Thursday, 1 January 1970 text/html 2021-10-15T06:11:02+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/DOUBLECLICKINTERVAL?rev=1634278262&do=diff DOUBLECLICKINTERVAL Function The DOUBLECLICKINTERVAL() function returns (v10.0+) the system double click period. This is the time between clicks that the system switches from being a double-click, to two successive clicks. See Also Functions * KEYREPEATDELAY function text/html 2023-09-20T07:23:58+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/DOW?rev=1695194638&do=diff DOW Function The DOW([unixtime]) function returns the day of the week (1=Sunday, 7=Saturday) component from the current time or an optional unixtime. See Also Actions * Filter (Process Text Tokens) * See all Actions Functions * YEAR * MONTH * DAY * DOW * HOUR * MINUTE * SECOND * TIME * See all Functions Tokens text/html 2023-09-20T07:39:16+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/DPI?rev=1695195556&do=diff DPI Functions The DPI(X|Y) and SOURCEDPI(X|Y) functions return the horizontal or vertical DPI of the images that the action is operating on in actions like the Resize Image or the Composite onto Image actions. See Also Functions * See all Functions Actions * Resize Image * Composite onto Image * See all Actions text/html 2023-09-20T04:16:22+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/EXP?rev=1695183382&do=diff EXP Function The EXP(x) function returns exponentiation of e. EXP(1) ~ 2.71828183 See Also Functions * See all Functions text/html 2023-09-20T08:41:55+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/FLOOR?rev=1695199315&do=diff FLOOR Function The FLOOR(x) function takes a number and returns the first integer that is less than or equal to the argument: FLOOR(5.5) === FLOOR(5.1) === FLOOR(5) === 5 FLOOR(-5.5) === FLOOR(-5.1) === FLOOR(-6) === -6 The FLOOR() function (v11.0+) takes a second optional parameter to indicate the number of decimal digits to operate to: text/html 2023-09-20T04:15:23+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/FONTSIZE?rev=1695183323&do=diff FONTSIZE Function The FONTSIZE() function returns the font size of the text that the action is operating on in actions like the Apply Style to Clipboard action. See Also Functions * See all Functions text/html 2025-04-18T03:32:19+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/FRONTBROWSERISCOMPLETE?rev=1744947139&do=diff FRONTBROWSERISCOMPLETE Function The FRONTBROWSERISCOMPLETE() function (v8+) returns 1 if the active tab of the front browser (the most recently front web browser of Safari or Google Chrome) has completed loading (as far as Keyboard Maestro can tell), and 0 otherwise. text/html 2023-09-20T04:14:53+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/FRONTBROWSERTABCOUNT?rev=1695183293&do=diff FRONTBROWSERTABCOUNT Function The FRONTBROWSERTABCOUNT() function (v8+) returns the number of tabs in the front browser (the most recently front web browser of Safari or Google Chrome). See Also Actions * actions:Click Browser Link * actions:Browser Form Actions * actions:Browser Window Actions * See all Actions Functions * FRONTBROWSERISCOMPLETE() * FRONTBROWSERTABINDEX() * See all Functions Forum text/html 2023-09-20T04:14:40+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/FRONTBROWSERTABINDEX?rev=1695183280&do=diff FRONTBROWSERTABINDEX Function The FRONTBROWSERTABINDEX() function (v8+) returns the index of the selected tab in the front browser (the most recently front web browser of Safari or Google Chrome). See Also Actions * actions:Click Browser Link * actions:Browser Form Actions * actions:Browser Window Actions * See all Actions Functions * FRONTBROWSERISCOMPLETE() text/html 2023-09-19T02:42:12+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/GMTOFFSET?rev=1695091332&do=diff GMTOFFSET function The GMTOFFSET() function returns the number of seconds from GMT. For example, to display the current GMT time, use token string like this: %ICUDateTimeFor%NOW()-GMTOFFSET()%HH:mm% See Also Actions * Filter (Process Text Tokens) text/html 2023-09-20T04:32:04+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/HEX?rev=1695184324&do=diff HEX Function The HEX(t) function takes an arbitrary token text string, processes the text tokens, and then evaluates the result as a hex number. HEX(0A) HEX(0x12AB) [ HEX function ] See Also Actions * Set Variable to Calculation Action * See all Actions Functions * BIN * OCT * CALCULATE * See all Functions Tokens * %Bin% * %Oct% * %Hex% * %Calculate% * See all Tokens text/html 2023-09-20T07:25:03+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/HOUR?rev=1695194703&do=diff HOUR Function The HOUR([unixtime]) function returns the hour (0-23) in the local time zone, either the current hour, or the hour of the specified unixtime. HOUR() === the current hour HOUR( unixtime ) === the hour of the unix time See Also Actions * Filter (Process Text Tokens) text/html 2023-09-20T04:32:41+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/IDLE?rev=1695184361&do=diff IDLE Function The IDLE() function returns the number of (fractional) seconds the Mac has been idle. The IDLE time is based on the Human Interface (HID) system, and so it notices only HID device activity like mouse movement or keyboard presses, not things like disk access or movies playing or network activity. text/html 2023-09-20T07:39:38+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/IMAGE?rev=1695195578&do=diff IMAGE Functions The IMAGE(Width|Height) and SOURCEIMAGE(Width|Height) functions return the width or height of the images that the action is operating on in actions like the Resize Image or the Composite onto Image actions. See Also Functions * See all Functions Actions * Resize Image * Composite onto Image * See all Actions text/html 2023-09-20T04:33:21+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/JD?rev=1695184401&do=diff JD Function The JD() function returns the JulianDate. JD() === the current JulianDate JD( year, month, day ) === the JulianDate of the start of the year/month/day JD( year, month, day, hour, minute, second ) === the JulianDate of the specified moment See Also text/html 2023-09-20T04:34:39+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/JD2MJD?rev=1695184479&do=diff JD2MJD Function The JD2MJD(x) function converts a time from JulianDate to MJD. See Also Functions * DAY * DOW * GMTOFFSET * NOW (unixtime) * TIME (unixtime) * TIME2JD * TIME2MJD * JD * JD2TIME * MJD * MJD2JD * MJD2TIME * See all Functions text/html 2023-09-20T04:34:48+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/JD2TIME?rev=1695184488&do=diff JD2TIME Function The JD2TIME(x) function converts a time from JulianDate to unixtime. See Also Actions * Filter (Process Text Tokens) * See all Actions Functions * DAY * DOW * GMTOFFSET * NOW (unixtime) * TIME (unixtime) * TIME2JD * TIME2MJD * JD * JD2MJD * MJD * MJD2JD * MJD2TIME * See all Functions Tokens * %ICUDateTime% (local) * %ICUDateTimeFor% (local) * %ICUDateTimeMinus% (local) text/html 2023-09-20T04:19:58+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/JSONVALUE?rev=1695183598&do=diff JSONVALUE Function The JSONVALUE(t) function takes a JSON path and returns the numeric result. JSONVALUE(jsonpath) is more or less equivalent to CALCULATE(%JSONValue%jsonpath%). Examples If a Keyboard Maestro variable J contains the JSON object: {"a":9, "b":"bravo", "c":null, "d":[11,"two",33]} text/html 2021-10-15T06:10:27+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/KEYREPEATDELAY?rev=1634278227&do=diff KEYREPEATDELAY Function The KEYREPEATDELAY() function returns (v10.0+) the system key repeat delay. This is the time before the system starts repeating a key. Modern macOS typically do not repeat keys when held down, instead it displays a popup for some keys (eg text/html 2021-10-15T06:09:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/KEYREPEATINTERVAL?rev=1634278190&do=diff KEYREPEATINTERVAL Function The KEYREPEATINTERVAL() function returns (v10.0+) the system key repeat interval. This is the time between repeating keys when the the system is repeating a key. Modern macOS typically do not repeat keys when held down, instead it displays a popup for some keys (eg text/html 2023-09-20T06:22:08+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/KMDARKMODE?rev=1695190928&do=diff KMDARKMODE Function The KMDARKMODE() function (v9.0+, OS X 10.14+) returns 1 if Keyboard Maestro is in Dark Mode (either explicitly, or because the system is), 0 otherwise. The function will always return 0 in systems before OS X 10.14 Mojave. See Also text/html 2023-09-20T06:31:03+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/LENGTH?rev=1695191463&do=diff LENGTH Function The LENGTH() function returns the length of text that the action is operating on. The LENGTH() function is a special context sensitive function that only works in a few actions, like the Substring or Apply Style actions, returning the length of the processed text (so, for example, you could have the text size be dependent on the length of the text). text/html 2025-07-17T07:29:05+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/LINES?rev=1752737345&do=diff LINES Function The LINES(t) function takes an arbitrary token text string, processes the text tokens, and then returns the number of lines in the string. LINES(%CurrentClipboard%) LINES(%Variable%MyVar%) Example See Also Actions * Set Variable to Calculation Action * See all Actions Functions * CALCULATE * text/html 2023-09-20T06:24:56+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/LOG?rev=1695191096&do=diff LOG Function The LOG(x) function returns natural logarithm. LOG(2.71828183) ~ 1.00 See Also Functions * LOG2 * LOG10 * See all Functions text/html 2023-09-20T06:24:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/LOG2?rev=1695191090&do=diff LOG2 Function The LOG2(x) function returns logarithm with base two. LOG2(128) === 7 See Also Functions * LOG * LOG10 * See all Functions text/html 2023-09-20T06:24:54+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/LOG10?rev=1695191094&do=diff LOG10 Function The LOG10(x) function returns logarithm with base ten. LOG10(1000) === 3 See Also Functions * LOG * LOG2 * See all Functions text/html 2023-09-20T06:35:59+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/MAILDATERECEIVED?rev=1695191759&do=diff MAILDATERECEIVED Function The MAILDATERECEIVED() function returns the unixtime of the currently selected mail message. See Also Functions * MAILDATESENT * MAILFLAG * MAILFLAGGED * MAILJUNKSTATUS * MAILREADSTATUS * MAILWASFORWARDED * MAILWASREDIRECTED * MAILWASREPLIEDTO * See all Functions text/html 2023-09-20T06:36:11+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/MAILDATESENT?rev=1695191771&do=diff MAILDATESENT Function The MAILDATESENT() function returns the unixtime of the currently selected mail message. See Also Functions * MAILDATERECEIVED * MAILFLAG * MAILFLAGGED * MAILJUNKSTATUS * MAILREADSTATUS * MAILWASFORWARDED * MAILWASREDIRECTED * MAILWASREPLIEDTO * See all Functions text/html 2023-09-20T06:36:21+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/MAILFLAG?rev=1695191781&do=diff MAILFLAG Function The MAILFLAG() function returns the flag of the currently selected mail message. See Also Functions * MAILDATERECEIVED * MAILDATESENT * MAILFLAGGED * MAILJUNKSTATUS * MAILREADSTATUS * MAILWASFORWARDED * MAILWASREDIRECTED * MAILWASREPLIEDTO * See all Functions text/html 2023-09-20T06:36:32+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/MAILFLAGGED?rev=1695191792&do=diff MAILFLAGGED Function The MAILFLAGGED() function returns the flagged status of the currently selected mail message. See Also Functions * MAILDATERECEIVED * MAILDATESENT * MAILFLAG * MAILJUNKSTATUS * MAILREADSTATUS * MAILWASFORWARDED * MAILWASREDIRECTED * MAILWASREPLIEDTO * See all Functions text/html 2023-09-20T06:36:58+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/MAILJUNKSTATUS?rev=1695191818&do=diff MAILJUNKSTATUS Function The MAILJUNKSTATUS() function returns the junk status of the currently selected mail message. See Also Functions * MAILDATERECEIVED * MAILDATESENT * MAILFLAG * MAILFLAGGED * MAILREADSTATUS * MAILWASFORWARDED * MAILWASREDIRECTED * MAILWASREPLIEDTO * See all Functions text/html 2023-09-20T06:37:10+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/MAILREADSTATUS?rev=1695191830&do=diff MAILREADSTATUS Function The MAILREADSTATUS() function returns the read status of the currently selected mail message. See Also Functions * MAILDATERECEIVED * MAILDATESENT * MAILFLAG * MAILFLAGGED * MAILJUNKSTATUS * MAILWASFORWARDED * MAILWASREDIRECTED * MAILWASREPLIEDTO * See all Functions text/html 2023-09-20T06:37:26+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/MAILWASFORWARDED?rev=1695191846&do=diff MAILWASFORWARDED Function The MAILWASFORWARDED() function returns the was forwarded status of the currently selected mail message. See Also Functions * MAILDATERECEIVED * MAILDATESENT * MAILFLAG * MAILFLAGGED * MAILJUNKSTATUS * MAILREADSTATUS * MAILWASREDIRECTED * MAILWASREPLIEDTO * See all Functions text/html 2023-09-20T06:37:35+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/MAILWASREDIRECTED?rev=1695191855&do=diff MAILWASREDIRECTED Function The MAILWASREDIRECTED() function returns the was redirected status of the currently selected mail message. See Also Functions * MAILDATERECEIVED * MAILDATESENT * MAILFLAG * MAILFLAGGED * MAILJUNKSTATUS * MAILREADSTATUS * MAILWASFORWARDED * MAILWASREPLIEDTO * See all Functions text/html 2023-09-20T06:37:45+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/MAILWASREPLIEDTO?rev=1695191865&do=diff MAILWASREPLIEDTO Function The MAILWASREPLIEDTO() function returns the was replied to status of the currently selected mail message. See Also Functions * MAILDATERECEIVED * MAILDATESENT * MAILFLAG * MAILFLAGGED * MAILJUNKSTATUS * MAILREADSTATUS * MAILWASFORWARDED * MAILWASREDIRECTED * See all Functions text/html 2023-09-20T07:03:25+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/MAX?rev=1695193405&do=diff MAX Function The MAX(x,y) function returns the maximum of its parameters. MAX(96,12) === 96 See Also Functions * MIN * See all Functions text/html 2023-09-21T04:00:03+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/MEMORY?rev=1695268803&do=diff MEMORY Function The MEMORY() function returns the amount of RAM in the Mac. See Also Functions * PROCESSORS * See all Functions text/html 2021-10-15T06:16:09+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/MENUBARHEIGHT?rev=1634278569&do=diff MENUBARHEIGHT Function The MENUBARHEIGHT() function returns the height of the menu bar in pixels, generally 22. See Also Actions * Manipulate a Window action * Move or Click Mouse action * See all Actions Functions * MOUSEBUTTON function * MOUSEX function * MOUSEY function * SCREEN function * SCREENVISIBLE function * SCREENCOUNT function * text/html 2023-09-20T07:01:38+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/MICROSECONDS?rev=1695193298&do=diff MICROSECONDS Function The MICROSECONDS() function returns the time in microseconds since the Mac started. See Also Functions * MILLISECONDS * SECONDS * See all Functions text/html 2023-09-20T07:01:24+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/MILLISECONDS?rev=1695193284&do=diff MILLISECONDS Function The MILLISECONDS function returns the time in fractional milliseconds since the Mac started. See Also Functions * MICROSECONDS * SECONDS * See all Functions text/html 2023-09-20T07:03:12+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/MIN?rev=1695193392&do=diff MIN Function The MIN(x,y) function returns the minimum of its parameters. MIN(96,12) === 12 See Also Functions * MAX * See all Functions text/html 2023-09-20T07:24:59+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/MINUTE?rev=1695194699&do=diff MINUTE Function The MINUTE([unixtime]) function returns the minutes (0-59) in the local time zone, either the current minutes, or the minutes of the specified unixtime. MINUTE() === the current minutes MINUTE( unixtime ) === the minutes of the unix time See Also text/html 2023-09-20T06:33:34+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/MJD?rev=1695191614&do=diff MJD Function The MJD() function returns the MJD (Modified Julian Date). MJD() === the current Modified Julian Date MJD( year, month, day ) === the Modified Julian Date of the start of the year/month/day MJD( year, month, day, hour, minute, second ) === the Modified Julian Date of the specified moment text/html 2023-09-20T04:33:37+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/MJD2JD?rev=1695184417&do=diff MJD2JD Function The MJD2JD(x) function converts a time from MJD to JulianDate. See Also Functions * DAY * DOW * GMTOFFSET * NOW (unixtime) * TIME (unixtime) * TIME2JD * TIME2MJD * JD * JD2MJD * JD2TIME * MJD * MJD2TIME * See all Functions text/html 2023-09-20T04:33:46+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/MJD2TIME?rev=1695184426&do=diff MJD2TIME Function The MJD2TIME(x) function converts a time from MJD to unixtime. See Also Functions * DAY * DOW * GMTOFFSET * NOW (unixtime) * TIME (unixtime) * TIME2JD * TIME2MJD * JD * JD2MJD * JD2TIME * MJD * MJD2JD * See all Functions text/html 2023-09-20T07:18:02+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/MONTH?rev=1695194282&do=diff MONTH Function The MONTH([unixtime]) function returns the month (1-12), either the current month, or the month of the specified unixtime. MONTH() === the current month MONTH( unixtime ) === the month of the unix time See Also Actions * Filter (Process Text Tokens) text/html 2021-10-15T06:18:17+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/MOUSEBUTTON?rev=1634278697&do=diff MOUSEBUTTON Function The MOUSEBUTTON() function returns whether the Mac's mouse button is pressed. It returns 1 if the button is pressed or 0 otherwise. It takes an optional parameter indicating the desired mouse button. MOUSEBUTTON() === MOUSEBUTTON(1) === whether the left mouse button is pressed MOUSEBUTTON(2) === whether the right mouse button is pressed MOUSEBUTTON(3) === whether the middle mouse button is pressed text/html 2021-10-15T06:27:11+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/MOUSEX?rev=1634279231&do=diff MOUSEX Function The MOUSEX() function returns the x location of the mouse pointer relative to the top left corner of the main screen. See Also Actions * Manipulate a Window action * Move or Click Mouse action * See all Actions Functions * MENUBARHEIGHT function * MOUSEBUTTON function * MOUSEY function * SCREEN function * SCREENVISIBLE function text/html 2021-10-15T06:27:28+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/MOUSEY?rev=1634279248&do=diff MOUSEY Function The MOUSEY() function returns the y location of the mouse pointer relative to the top left corner of the main screen. See Also Actions * Manipulate a Window action * Move or Click Mouse action * See all Actions Functions * MENUBARHEIGHT function * MOUSEBUTTON function * MOUSEX function * SCREEN function * SCREENVISIBLE function text/html 2023-09-20T07:30:20+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/NOW?rev=1695195020&do=diff NOW Function The NOW function returns the current time in unixtime, being seconds since the start of 1970 GMT. NOW() === TIME() == the current unix time It is the same as TIME(). See Also Actions * Filter (Process Text Tokens) * See all Actions Functions * YEAR * MONTH * DAY * DOW * HOUR * text/html 2023-09-20T07:32:33+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/OCT?rev=1695195153&do=diff OCT Function The OCT(t) function takes an arbitrary token text string, processes the text tokens, and then evaluates the result as an octal number. OCT(045) OCT(177) See Also Actions * Set Variable to Calculation Action * See all Actions Functions * BIN * OCT * HEX * CALCULATE * See all Functions Tokens * %Bin% * %Oct% * %Hex% * %Calculate% * See all Tokens text/html 2023-09-20T07:32:51+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/ONLINE?rev=1695195171&do=diff ONLINE Function The ONLINE() function returns whether the Mac is currently connected to the Internet. It returns 1 if the Mac is connected to the Internet or 0 otherwise. See Also Functions * See all Functions text/html 2023-09-20T07:33:15+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/PIXEL?rev=1695195195&do=diff PIXEL Function The PIXEL(component,x,y) function returns the color component at a given location on the screen (absolute coordinates relative to the top left corner of the main screen). The component parameter can be any of: * Red * Green * Blue text/html 2023-09-21T03:59:15+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/PROCESSORS?rev=1695268755&do=diff PROCESSORS Function The PROCESSORS() function returns the number of processors in the Mac. See Also Functions * MEMORY * See all Functions text/html 2023-09-20T07:35:35+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/RAND?rev=1695195335&do=diff RAND Function The RAND() functions return a random integer number. * RAND(N) returns a random integer from 0 to, but not including, N. * RAND(A,B) returns (v9.0+) a random integer number from A to, including, B. In the one parameter version, N must be greater than or equal to 1. text/html 2023-09-20T07:36:40+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/RANDOM?rev=1695195400&do=diff RANDOM Function The RANDOM() functions return a random real number. * RANDOM() returns a random real number from 0 to, but not including, 1. * RANDOM(N) returns a random real number from 0 to, but not including, N. * RANDOM(A,B) returns (v9.0+) a random real number from A to, but not including, B. text/html 2023-09-20T08:42:19+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/ROUND?rev=1695199339&do=diff ROUND Function The ROUND() function takes a number and returns the nearest integer to the argument. Numbers that are exactly half way (ie, end in “.5”) round away from zero. ROUND(5.4) === ROUND(5.1) === ROUND(4.5) === 5 ROUND(-5.5) === ROUND(-5.9) === ROUND(-6.3) === -6 text/html 2023-09-20T07:48:57+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/SAFARIISCOMPLETE?rev=1695196137&do=diff SAFARIISCOMPLETE Function The SAFARIISCOMPLETE() function returns whether Safari has currenlty finished loading the current tab. See Also Actions * actions:Click Browser Link * actions:Browser Form Actions * actions:Browser Window Actions * See all Actions Functions * SAFARITABCOUNT() * SAFARITABINDEX() * See all Functions Forum * MACRO: Select Previously USED Safari Tab (not previous tab) * Keyboard Maestro Forum topics about SAFARIISCOMPLETE() function text/html 2023-09-20T07:48:35+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/SAFARITABCOUNT?rev=1695196115&do=diff SAFARITABCOUNT Function The SAFARITABCOUNT() function returns the number of tabs in the front Safari window. See Also Actions * actions:Click Browser Link * actions:Browser Form Actions * actions:Browser Window Actions * See all Actions Functions * SAFARIISCOMPLETE() * SAFARITABINDEX() * See all Functions Forum * MACRO: Select Previously USED Safari Tab (not previous tab) * Keyboard Maestro Forum topics about SAFARITABCOUNT() function text/html 2023-09-20T07:48:23+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/SAFARITABINDEX?rev=1695196103&do=diff SAFARITABINDEX Function The SAFARITABINDEX() function returns the index of the selected tab in the front Safari window. See Also Actions * actions:Click Browser Link * actions:Browser Form Actions * actions:Browser Window Actions * See all Actions Functions * SAFARIISCOMPLETE() * SAFARITABCOUNT() * See all Functions Forum * MACRO: Select Previously USED Safari Tab (not previous tab) * Keyboard Maestro Forum topics about SAFARITABINDEX() function text/html 2026-02-10T06:26:56+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/SCREEN?rev=1770704816&do=diff SCREEN Functions The SCREEN() and SCREENVISIBLE() functions return the position or size of a screen. SCREENVISIBLE() refers to the visible section of the screen, excluding the menu bar and the dock. The SCREENINDEX() function (v10.0+) returns the actual index of the specified screen, counting from left to right. text/html 2021-10-15T06:15:36+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/SCREENCOUNT?rev=1634278536&do=diff SCREENCOUNT Function The SCREENCOUNT() function returns the number of screens (displays). See Also Actions * Manipulate a Window action * Move or Click Mouse action * See all Actions Functions * MENUBARHEIGHT function * MOUSEBUTTON function * MOUSEX function * MOUSEY function * SCREEN function * SCREENVISIBLE function * SCREENINDEX function * WINDOW function text/html 2021-10-15T06:33:08+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/SCREENINDEX?rev=1634279588&do=diff text/html 2023-09-20T07:41:08+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/SCREENSAVER?rev=1695195668&do=diff SCREENSAVER Function The SCREENSAVER() function returns whether the Mac is currently displaying the screen saver (or the display is off). It returns 1 if the screen saver is running, or the display is sleeping or locked. Generally, if it returns 1 it is probably not safe to perform UI. text/html 2015-07-13T10:10:04+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/SCREENVISIBLE?rev=1436782204&do=diff text/html 2023-09-20T07:25:52+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/SECOND?rev=1695194752&do=diff SECOND Function The SECOND([unixtime]) function returns the seconds (0-59) in the local time zone, either the current seconds, or the seconds of the specified unixtime. SECOND() === the current seconds SECOND( unixtime ) === the seconds of the unix time See Also text/html 2023-09-21T04:03:32+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/SECONDS?rev=1695269012&do=diff SECONDS Function The SECONDS() function returns the time in fractional seconds since the Mac started. See Also Functions * MILLISECONDS * MICROSECONDS * UPTIME * See all Functions Forum * MACRO: Timing a Macro text/html 2021-10-15T06:05:29+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/SECUREINPUT?rev=1634277929&do=diff SECUREINPUT Function The SECUREINPUT() function returns whether the Mac is currently in Secure Input Mode. It returns 1 if the Mac is in Secure Input Mode or 0 otherwise. See Also Functions * See all Functions text/html 2023-09-20T07:40:56+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/SIN?rev=1695195656&do=diff SIN Function The SIN(x) function returns the sine of its argument which is an angle in radians from the x-axis. See Also Functions * See all Functions text/html 2023-09-20T07:40:46+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/SINH?rev=1695195646&do=diff SINH Function The SINH(x) function returns the hyperbolic sine of its argument which is a hyperbolic angle. See Also Functions * See all Functions text/html 2017-09-05T09:01:52+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/SOURCEDPI?rev=1504602112&do=diff text/html 2015-07-13T10:47:12+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/SOURCEIMAGE?rev=1436784432&do=diff text/html 2023-09-20T07:40:32+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/SYSTEMVOLUME?rev=1695195632&do=diff SYSTEMVOLUME Function The SYSTEMVOLUME() function returns the current system volume from 0-100. (i) Note that it does not reflect the Mute state. See Also Functions * See all Functions text/html 2023-09-20T08:34:23+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/TAN?rev=1695198863&do=diff TAN Function The TAN(x) function returns the tangent (ratio of the opposite over the adjacent) of its argument which is an angle in radians from the x-axis. See Also Functions * See all Functions text/html 2023-09-20T08:34:31+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/TANH?rev=1695198871&do=diff TANH Function The TANH(x) function returns the hyperbolic tangent of its argument which is a hyperbolic angle. See Also Functions * See all Functions text/html 2023-09-20T07:31:46+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/TIME?rev=1695195106&do=diff TIME Function The TIME() function returns the time in unixtime, being seconds since the start of 1970 GMT. TIME() === NOW() === the current unix time (GMT). TIME( year, month, day ) === the unix time of the start of the year/month/day (GMT). TIME( year, month, day, hour, minute, second ) === the unix time of the specified moment (GMT). text/html 2023-09-20T04:34:16+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/TIME2JD?rev=1695184456&do=diff TIME2JD Function The TIME2JD(x) function converts a time from unixtime to JulianDate. See Also Functions * DAY * DOW * GMTOFFSET * NOW (unixtime) * TIME (unixtime) * TIME2MJD * JD * JD2MJD * JD2TIME * MJD * MJD2JD * MJD2TIME * See all Functions text/html 2023-09-20T04:34:27+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/TIME2MJD?rev=1695184467&do=diff TIME2MJD Function The TIME2MJD(x) function converts a time from unixtime to MJD. See Also Functions * DAY * DOW * GMTOFFSET * NOW (unixtime) * TIME (unixtime) * TIME2JD * JD * JD2MJD * JD2TIME * MJD * MJD2JD * MJD2TIME * See all Functions text/html 2023-09-20T08:34:39+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/TRIGGERTIME?rev=1695198879&do=diff TRIGGERTIME Function The TRIGGERTIME() function returns the unixtime that this macro instance was triggered. See Also Functions * See all Functions text/html 2023-09-20T08:37:52+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/TRUNC?rev=1695199072&do=diff TRUNC Function The TRUNC() function takes a number and returns the first integer that is equal to or closer to zero than the argument: TRUNC(5.5) === TRUNC(5.1) === TRUNC(5) === 5 TRUNC(-5.5) === TRUNC(-5.1) === TRUNC(-5) === -5 The TRUNC() function (v11.0+) takes a second optional parameter to indicate the number of digits to truncate to. text/html 2023-09-21T04:03:10+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/UPTIME?rev=1695268990&do=diff UPTIME Function The UPTIME() function returns the time in fractional seconds since the Mac booted. See Also Functions * SECONDS * See all Functions text/html 2026-01-05T11:13:53+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/WINDOW?rev=1767611633&do=diff WINDOW Function The WINDOW() function returns the desired coordinate of the specified window, and can have one or two parameters. Usage * WINDOW(Coordinate) * WINDOW(Index, Coordinate) With two parameters, the first parameter specifies which window in the front application to operate on. With only one parameter, the text/html 2023-09-20T08:33:27+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/WINDOWCOUNT?rev=1695198807&do=diff WINDOWCOUNT Function The WINDOWCOUNT() function returns the number of windows in the front application. See Also Actions * Manipulate a Window action * Move or Click Mouse action * See all Actions Functions * MENUBARHEIGHT() function * MOUSEBUTTON() function * MOUSEX() function * MOUSEY() function * SCREEN() function * SCREENCOUNT()] function] * [[function:SCREENVISIBLE|SCREENVISIBLE() function * SCREENINDEX() function text/html 2025-07-18T07:58:51+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/WORDS?rev=1752825531&do=diff WORDS Function The WORDS(t) function takes an arbitrary token text string, processes the text tokens, and then returns the number of words in the string. WORDS(%SystemClipboard%) WORDS(%Variable%MyVar%) Example See Also Actions * Set Variable to Calculation Action * See all Actions Functions * CALCULATE * text/html 2023-09-20T07:17:40+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/YEAR?rev=1695194260&do=diff YEAR Function The YEAR([unixtime]) function returns the year, either the current year, or the year of the specified unixtime. YEAR() === the current year YEAR( unixtime ) === the year of the unix time See Also Actions * Filter (Process Text Tokens) * See all Actions Functions