https://wiki.keyboardmaestro.com/ 2026-05-02T00:13:28+00:00 https://wiki.keyboardmaestro.com/ https://wiki.keyboardmaestro.com/_media/wiki/logo.png text/html 2022-01-06T03:10:11+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/AccessedVariables?rev=1641438611&do=diff AccessedVariablesToken The %AccessedVariables% token returns (v10.0+) a comma-separated list of variables accessed by this macro. Note that variables can be accessed for all manner of reasons, and sometimes implicitly by actions, so this token should generally be used for debugging purposes (eg, logging the values of all accessed variables), not for things like cleaning up/deleting used variables. text/html 2021-10-14T09:06:52+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ActionResult?rev=1634202412&do=diff ActionResult Token The %ActionResult% token returns text indicating the success or failure of the immediate past action. If the immediately past action was successful, then “OK” is returned, otherwise, a message describing the reason for failure is returned. text/html 2015-07-15T09:54:05+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/AddressBook?rev=1436954045&do=diff The %AddressBook%x% token returns information about your AddressBook entry (the “Me” card). You can ask for the: * %AddressBook%Name% - your AddressBook name. * %AddressBook%First% - your AddressBook first name. * %AddressBook%Last% - your AddressBook last name. text/html 2017-09-05T05:41:17+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/AlertButton?rev=1504590077&do=diff The %AlertButton% token (v8+) returns the name of the last selected Alert button in this execution instance. This deprecates the Alert Button special variable. See Also Actions * Alert action * Prompt for User Input action * Custom HTML Prompt action Tokens * %PromptButton% token * %HTMLResult% token text/html 2019-07-05T08:00:02+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/Application?rev=1562313602&do=diff text/html 2019-07-05T07:59:30+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ApplicationBundleID?rev=1562313570&do=diff text/html 2023-09-19T07:20:49+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ApplicationLongVersion?rev=1695108049&do=diff text/html 2023-09-19T07:25:33+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ApplicationName?rev=1695108333&do=diff text/html 2019-07-05T08:00:17+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ApplicationPath?rev=1562313617&do=diff text/html 2023-09-19T07:20:43+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ApplicationVersion?rev=1695108043&do=diff text/html 2024-07-16T05:12:03+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/Application_Tokens?rev=1721106723&do=diff Application Tokens You can get information about running applications using the variable Application tokens: TokenMeaning Application (or ApplicationName (v11.0+)) The name of the application ApplicationBundleID The bundle ID of the application ApplicationPath (v9.0+) text/html 2023-09-13T09:20:31+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/Ask?rev=1694596831&do=diff Ask Token The %Ask% tokens is a placeholder used in the Prompt for Snippet action to indicate locations where user input for the snippet is required. It takes the form: %Ask<Size><=Variable Name> or <:Default Value>% Where Size is the rough size in characters or the number of lines. text/html 2023-09-20T03:16:10+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/AudioDevice?rev=1695179770&do=diff Audio Device Tokens The audio device tokens (v11.0+) return the name or UID of the currently selected audio input, output or sound effects devices. The tokens are: * %AudioInputDevice% * %AudioInputDeviceUID% * %AudioOutputDevice% (available since v8.0) text/html 2023-09-20T03:14:55+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/AudioInputDevice?rev=1695179695&do=diff text/html 2023-09-20T03:19:21+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/AudioInputDevices?rev=1695179961&do=diff AudioInputDevices Token The AudioInputDevices token (v11.0+) returns a list of available audio input devices. See Also Actions * See all Actions Tokens * %AudioInputDevice% token * %AudioInputDeviceUID% token * %AudioOutputDevice% token * %AudioOutputDeviceUID% token * %AudioSoundEffectsDevice% token * %AudioSoundEffectsDeviceUID% token * %AudioOutputDevices% token * See all Tokens text/html 2023-09-20T03:14:59+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/AudioInputDeviceUID?rev=1695179699&do=diff text/html 2023-09-20T03:15:04+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/AudioOutputDevice?rev=1695179704&do=diff text/html 2023-09-20T03:19:52+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/AudioOutputDevices?rev=1695179992&do=diff AudioOutputDevices Token The AudioOutputDevices token (v11.0+) returns a list of available audio output devices. See Also Actions * See all Actions Tokens * %AudioInputDevice% token * %AudioInputDeviceUID% token * %AudioOutputDevice% token * %AudioOutputDeviceUID% token * %AudioSoundEffectsDevice% token * %AudioSoundEffectsDeviceUID% token * %AudioInputDevices% token * See all Tokens text/html 2023-09-20T03:15:09+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/AudioOutputDeviceUID?rev=1695179709&do=diff text/html 2023-09-20T03:15:13+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/AudioSoundEffectsDevice?rev=1695179713&do=diff text/html 2023-09-20T03:15:17+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/AudioSoundEffectsDeviceUID?rev=1695179717&do=diff text/html 2017-09-05T03:59:43+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/Bin?rev=1504583983&do=diff text/html 2023-11-10T03:29:21+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/Calculate?rev=1699586961&do=diff Calculate Token The %Calculate%<formula>% token returns the numeric result of performing a calculation, where <formula> may be any of the following: * Mathematical formula like (2 + 3)*12 * Use any Variable which may be evaluated as a number * :!: Just enter the Variable Name (without the text/html 2023-11-10T03:28:46+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/CalculateFormat?rev=1699586926&do=diff CalculateFormat Token The %CalculateFormat%<formula>%<format>% token (v8+) returns the numeric result of performing a calculation. The formula is the same as for the Calculate token. The <format> is either one of these specific localized formats: * Decimal text/html 2023-09-19T05:04:31+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ChromeBundleID?rev=1695099871&do=diff text/html 2023-09-19T05:04:59+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ChromeField?rev=1695099899&do=diff text/html 2023-09-19T05:04:52+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ChromeJavaScript?rev=1695099892&do=diff text/html 2023-09-19T05:04:14+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ChromeLongVersion?rev=1695099854&do=diff text/html 2023-09-19T05:04:37+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ChromeName?rev=1695099877&do=diff text/html 2023-09-19T05:04:25+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ChromePath?rev=1695099865&do=diff text/html 2023-09-19T05:05:10+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ChromeReadyState?rev=1695099910&do=diff text/html 2023-09-19T05:05:28+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ChromeTitle?rev=1695099928&do=diff text/html 2023-09-19T05:05:16+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ChromeURL?rev=1695099916&do=diff text/html 2023-09-19T05:04:19+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ChromeVersion?rev=1695099859&do=diff text/html 2023-09-19T05:05:22+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ChromeWindowName?rev=1695099922&do=diff text/html 2019-09-16T02:14:26+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/CurrentApplication?rev=1568600066&do=diff The %CurrentApplication% token returns the name of the current application (same as %Application%1%). text/html 2017-09-05T02:43:32+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/CurrentClipboard?rev=1504579412&do=diff text/html 2015-07-15T09:55:29+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/CurrentMouse?rev=1436954129&do=diff The %CurrentMouse% token returns the current mouse location. text/html 2023-09-20T03:23:38+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/CurrentTrack?rev=1695180218&do=diff CurrentTrack Token The CurrentTrack token returns information about the current iTunes name. You can ask for the: * %CurrentTrack%name% - the current iTunes track name. * %CurrentTrack%artist% - the current iTunes track artist. * %CurrentTrack%album% text/html 2017-09-05T03:59:34+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/Dec?rev=1504583974&do=diff text/html 2023-09-13T09:08:06+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/Delete?rev=1694596086&do=diff Delete Token The %Delete% tokens is not a real token. It returns nothing (the empty string) but if used by itself in some places it is used to signify that the recipient should be deleted rather than set to the empty string. For example, if you use it with the text/html 2023-09-13T03:48:20+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/Dictionary?rev=1694576900&do=diff Dictionary Token The %Dictionary[<Dict>,<Key>]% token (v8+) allows you to access dictionary values in a token text field, where <Dict> is the name of the dictionary and <Key> is the key. For Example, using the Insert Text Action: See Also * Text Fields * Tokens * Variables text/html 2021-10-20T04:33:44+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ExecutingInstance?rev=1634704424&do=diff ExecutingInstance Action The %ExecutingInstance% token returns (v9.0+) an opaque ID of the currently executing instance, including both the execution instance and the specific macro executing. It can be used to retrieve Local and Instance variables via AppleScript and to cancel the specific macro instance. text/html 2019-07-15T03:24:55+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ExecutingInstanceName?rev=1563161095&do=diff The %ExecutingInstanceName%instance% token returns (v9.0+) the name of an execution instance. Generally this will be the name of the parent macro that was triggered (or “Trying” if the actions are “Tried” from the editor). [ ExecutingInstanceName ] See Also Tokens text/html 2022-10-13T08:40:03+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ExecutingInstances?rev=1665650403&do=diff ExecutingInstances Action The %ExecutingInstances% token returns (v9.0+) a command-separated list of opaque IDs of the currently executing instance. It can be used to retrieve Local and Instance variables via AppleScript and to cancel the specific macro instances. text/html 2019-07-05T07:29:02+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ExecutingMacro?rev=1562311742&do=diff The %ExecutingMacro% token returns the name of the currently executing macro. See Also Tokens * %ExecutingMacro% * %ExecutingMacroUUID% * %ExecutingMacroGroup% * %ExecutingMacroGroupUUID% * %ExecutingThisMacro% * %ExecutingThisMacroUUID% * %ExecutingThisMacroGroup% * %ExecutingThisMacroGroupUUID% * %ExecutingInstance% * %ExecutingInstances% * %ExecutingInstanceName% * %MacroNameForUUID% * See all Tokens text/html 2019-07-05T07:29:23+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ExecutingMacroGroup?rev=1562311763&do=diff The %ExecutingMacroGroup% token returns the name of the macro group containing the currently executing macro. The %ExecutingMacroGroupUUID% token returns the UUID of the macro group containing the currently executing macro. See Also Tokens * %ExecutingMacro% * text/html 2016-09-12T05:29:13+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ExecutingMacroGroupUUID?rev=1473658153&do=diff text/html 2019-07-05T07:29:16+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ExecutingMacroUUID?rev=1562311756&do=diff The %ExecutingMacroUUID% token returns the unique ID of the currently executing macro. See Also Tokens * %ExecutingMacro% * %ExecutingMacroUUID% * %ExecutingMacroGroup% * %ExecutingMacroGroupUUID% * %ExecutingThisMacro% * %ExecutingThisMacroUUID% * %ExecutingThisMacroGroup% * %ExecutingThisMacroGroupUUID% * %ExecutingInstance% * %ExecutingInstances% * %ExecutingInstanceName% * %MacroNameForUUID% * See all Tokens text/html 2019-07-05T07:29:36+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ExecutingThisMacro?rev=1562311776&do=diff The %ExecutingThisMacro% token returns the name of the macro the action is within. See Also Tokens * %ExecutingMacro% * %ExecutingMacroUUID% * %ExecutingMacroGroup% * %ExecutingMacroGroupUUID% * %ExecutingThisMacro% * %ExecutingThisMacroUUID% * %ExecutingThisMacroGroup% * %ExecutingThisMacroGroupUUID% * %ExecutingInstance% * %ExecutingInstances% * %ExecutingInstanceName% * %MacroNameForUUID% * See all Tokens text/html 2019-07-05T07:30:11+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ExecutingThisMacroGroup?rev=1562311811&do=diff The %ExecutingThisMacroGroup% token returns the name of the macro group the action is within. The %ExecutingThisMacroGroupUUID% token returns the UUID of the macro group the action is within. See Also Tokens * %ExecutingMacro% * %ExecutingMacroUUID% * %ExecutingMacroGroup% * %ExecutingMacroGroupUUID% * %ExecutingThisMacro% * %ExecutingThisMacroUUID% * %ExecutingThisMacroGroup% * %ExecutingThisMacroGroupUUID% * %ExecutingInstance% * text/html 2016-09-12T05:30:39+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ExecutingThisMacroGroupUUID?rev=1473658239&do=diff text/html 2019-07-05T07:30:00+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ExecutingThisMacroUUID?rev=1562311800&do=diff The %ExecutingThisMacroUUID% token returns the UUID of the macro the action is within. See Also Tokens * %ExecutingMacro% * %ExecutingMacroUUID% * %ExecutingMacroGroup% * %ExecutingMacroGroupUUID% * %ExecutingThisMacro% * %ExecutingThisMacroUUID% * %ExecutingThisMacroGroup% * %ExecutingThisMacroGroupUUID% * %ExecutingInstance% * %ExecutingInstances% * %ExecutingInstanceName% * %MacroNameForUUID% * See all Tokens Forum * MACRO: Get Selected Macro UUID (and name) (without the cl… text/html 2021-12-07T05:49:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/FinderInsertionLocation?rev=1638856190&do=diff FinderInsertionLocation Token The %FinderInsertionLocation% token returns insertion location in the Finder, which is usually the path of the front window. See Also Actions * See all Actions Tokens * %FinderSelection% token * %FinderSelections% token * See all Tokens text/html 2024-12-16T04:38:20+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/FinderSelection?rev=1734323900&do=diff FinderSelection(s) Token The %FinderSelection% token returns (v10.0+) the path of the currently selected file in the Finder. If there is none or more than one file selected, then it returns the empty string. The %FinderSelections% token returns (v10.0+) the paths of the currently selected files in the Finder, one per line. text/html 2021-10-15T08:21:58+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/FinderSelections?rev=1634286118&do=diff text/html 2015-07-15T09:55:51+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/FindPasteboard?rev=1436954151&do=diff The %FindPasteboard% token returns the current system find pasteboard value. text/html 2018-01-19T02:57:42+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/FoundImage?rev=1516330662&do=diff FoundImage Token The %FoundImage% Token (v8+) returns the details of the last found image in this execution instance. The last found image could have been found by a number of Actions or Conditions, like Find Image on Screen Action. The token returns the same data about the last found image as the text/html 2019-07-05T07:24:11+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/FrontBrowser?rev=1562311451&do=diff The %FrontBrowser% token (v9+) returns the name of the front browser (the most recently front web browser of Safari or Google Chrome). See Also Tokens * %SafariField% * %SafariJavaScript% * %SafariReadyState% * %SafariTitle% * %SafariURL% * %ChromeField% * %ChromeJavaScript% * %ChromeReadyState% * %ChromeTitle% * %ChromeURL% * %FrontBrowserField% * %FrontBrowserJavaScript% * %FrontBrowserReadyState% * %FrontBrowserTitle% * %FrontBrowserURL% * %FrontBrowser% * %FrontBrowserBun… text/html 2023-09-19T05:03:24+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/FrontBrowserBundleID?rev=1695099804&do=diff text/html 2023-09-19T05:03:45+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/FrontBrowserField?rev=1695099825&do=diff text/html 2023-09-19T05:03:38+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/FrontBrowserJavaScript?rev=1695099818&do=diff text/html 2023-09-19T05:02:46+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/FrontBrowserLongVersion?rev=1695099766&do=diff text/html 2023-09-19T05:03:32+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/FrontBrowserName?rev=1695099812&do=diff text/html 2023-09-19T05:03:04+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/FrontBrowserPath?rev=1695099784&do=diff text/html 2023-09-19T05:03:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/FrontBrowserReadyState?rev=1695099830&do=diff text/html 2023-09-19T05:04:09+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/FrontBrowserTitle?rev=1695099849&do=diff text/html 2023-09-19T05:03:56+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/FrontBrowserURL?rev=1695099836&do=diff text/html 2023-09-19T05:02:52+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/FrontBrowserVersion?rev=1695099772&do=diff text/html 2023-09-19T05:04:01+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/FrontBrowserWindowName?rev=1695099841&do=diff text/html 2023-09-19T07:19:31+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/FrontDocumentPath?rev=1695107971&do=diff FrontDocumentPath Token The %FrontDocumentPath % token returns (v11.0+) the path of the document associated with the front window if the Application supports this property. See Also Actions * See all Actions Tokens * %FinderSelection% token * %FinderSelections% token * %FinderInsertionLocation% token * See all Tokens text/html 2019-07-05T07:47:20+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/FrontWindowFrame?rev=1562312840&do=diff text/html 2016-11-23T05:44:31+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/FrontWindowName?rev=1479879871&do=diff text/html 2016-11-23T05:41:31+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/FrontWindowPosition?rev=1479879691&do=diff text/html 2019-07-05T07:47:55+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/FrontWindowSize?rev=1562312875&do=diff text/html 2017-09-05T03:59:31+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/Hex?rev=1504583971&do=diff text/html 2017-09-05T05:40:37+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/HTMLResult?rev=1504590037&do=diff The %HTMLResult% token (v8+) returns the result of the last Custom HTML Prompt action in this execution instance. This deprecates the HTML Result Button special variable. See Also Actions * Alert action * Prompt for User Input action * Custom HTML Prompt action Tokens * %AlertButton% token * %PromptButton% token text/html 2023-01-03T05:19:44+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ICUDateTime?rev=1672723184&do=diff ICU Date/Time Tokens The %ICUDateTime%, %ICUDateTimePlus%, %ICUDateTimeMinus% and %ICUDateTimeFor% tokens return the a date formatted in a specific format. More details are provided in the Dates and Times article. Required Parameters for ICUDateTime Tokens The parameters are specified between text/html 2015-07-15T10:27:57+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ICUDateTimeFor?rev=1436956077&do=diff text/html 2015-07-15T10:28:03+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ICUDateTimeMinus?rev=1436956083&do=diff text/html 2015-07-15T10:28:07+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ICUDateTimePlus?rev=1436956087&do=diff text/html 2019-06-25T03:38:37+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/JSONFromDictionary?rev=1561433917&do=diff JSONFromDictionary The %JSONFromDictionary%dictionary% token returns the JSON object constructed from the specified dictionary. The dictionary keys are used as field names for the resulting JSON object, and the dictionary values are the corresponding values. text/html 2025-01-13T02:51:01+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/JSONFromVariables?rev=1736736661&do=diff JSONFromVariables The %JSONFromVariables%prefix% token returns the JSON object constructed from the variables with the specified prefix. The variables with names starting with the specified prefix (with the prefix removed) are used as field names for the resulting JSON object, and the variable values are the corresponding values. text/html 2024-04-22T02:23:16+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/JSONValue?rev=1713752596&do=diff JSONValue The %JSONValue%jsonpath% token returns the JSON value from the specified JSON path). The token has Pretty and Compact variants (by appending either to the token name), as well as a Strict variant (appending Strict) (for example %JSONValueStrictCompact%jsonpath% text/html 2017-09-05T03:47:27+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/KeyboardLayout?rev=1504583247&do=diff The %KeyboardLayout% token (v8+) returns the current keyboard layout name. text/html 2023-09-19T07:29:36+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/KeyboardMaestroLongVersion?rev=1695108576&do=diff text/html 2023-09-19T07:29:25+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/KeyboardMaestroVersion?rev=1695108565&do=diff KeyboardMaestroVersion Token The %KeyboardMaestroVersion% and %KeyboardMaestroLongVersion% tokens (v11.0+) return the version of Keyboard Maestro that is currently running. See Also Actions * See all Actions Tokens * See all Tokens text/html 2023-09-19T08:15:05+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/LastAbortedActionID?rev=1695111305&do=diff LastAbortedActionIDToken The %LastAbortedActionID% token returns (v11.0+) the ID of the most recently aborted action. See Also Actions * See all Actions Tokens * See all Tokens text/html 2022-02-01T01:33:53+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/LastApplication?rev=1643679233&do=diff LastApplication Token The %LastApplication% token returns the name of the last application (same as %Application%2%). See Also Tokens * %Application% * %ApplicationBundleID% * %ApplicationPath% * See all Tokens text/html 2023-11-13T02:51:59+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/LastWindowID?rev=1699843919&do=diff LastWindowID Token The %LastWindowID% token returns (v10.0+) the window ID of the last Keyboard Maestro Engine window opened by this macro. See Also Actions * Manipulate a Window action * See all Actions Tokens * See all Tokens text/html 2023-09-19T08:26:01+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/LineFeed?rev=1695111961&do=diff LineFeed Token The %LineFeed% token returns the linefeed (0x0A) character. See Also Tokens * %Return% * %Space% * %Tab% * %OptionReturn% * See all Tokens Topics * Text Fields * FAQ text/html 2019-07-01T06:58:54+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/LongDate?rev=1561964334&do=diff LongDate The %LongDate% token returns the current date in a localized long format. Localization Prior to Mojave, and after Keyboard Maestro 9.0, dates should be in your chosen language. Unfortunately Apple changed Mojave and later to make the system return dates only in the Keyboard Maestro localized language (ie, English), regardless of your chosen locale. Keyboard Maestro 9.0 works around this by claiming to be in all locales, even though it is really only localized for English itself. text/html 2024-02-19T06:07:08+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/LongSystemVersion?rev=1708322828&do=diff text/html 2019-07-01T06:59:31+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/LongTime?rev=1561964371&do=diff LongTime The %LongTime% token returns the current time with seconds in a localized format. Localization Prior to Mojave, and after Keyboard Maestro 9.0, dates should be in your chosen language. Unfortunately Apple changed Mojave and later to make the system return dates only in the Keyboard Maestro localized language (ie, English), regardless of your chosen locale. Keyboard Maestro 9.0 works around this by claiming to be in all locales, even though it is really only localized for English it… text/html 2015-07-15T09:16:20+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/MacIPAddress?rev=1436951780&do=diff The %MacIPAddress% token returns the current Mac IP Address. text/html 2015-07-15T09:16:03+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/MacName?rev=1436951763&do=diff The %MacName% token returns the current Mac name. text/html 2017-09-07T04:14:20+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/MacroNameForUUID?rev=1504757660&do=diff MacroNameForUUID Token This token returns the name of the macro or macro group with the specified UUID. If the macro does not exist, then this will return “Not Found” so you can use it as a simple test for the existence of a particular macro. How To Use text/html 2023-08-17T03:23:48+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/MacUUID?rev=1692242628&do=diff The %MacUUID% token returns a unique ID for this Mac. You can test this with Macro Syncing to have your macro behave differently on different Macs. For example, use the Set Clipboard to Text action to copy the value of the %MacUUID% token on a specific Mac. Just “Try” the action to copy it, no need to create a macro, then you can delete the action. text/html 2015-07-15T10:14:44+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/MailBCCRecipients?rev=1436955284&do=diff The %MailBCCRecipients% token returns comma separated list of the bcc recipients in the currently selected mail message. text/html 2015-07-15T10:14:37+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/MailCCRecipients?rev=1436955277&do=diff The %MailCCRecipients% token returns comma separated list of the cc recipients in the currently selected mail message. text/html 2015-07-15T10:15:17+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/MailContents?rev=1436955317&do=diff The %MailContents% token returns the contents of the currently selected mail message. text/html 2015-07-15T10:15:24+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/MailRawSource?rev=1436955324&do=diff The %MailRawSource% token returns the raw source of the currently selected mail message. text/html 2015-07-15T10:14:26+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/MailRecipients?rev=1436955266&do=diff The %MailRecipients% token returns comma separated list of the recipients in the currently selected mail message. text/html 2015-07-15T10:14:58+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/MailReplyTo?rev=1436955298&do=diff The %MailReplyTo% token returns the reply to of the currently selected mail message. text/html 2015-07-15T10:14:51+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/MailSender?rev=1436955291&do=diff The %MailSender% token returns the sender of the currently selected mail message. text/html 2015-07-15T10:15:07+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/MailSubject?rev=1436955307&do=diff The %MailSubject% token returns the subject of the currently selected mail message. text/html 2015-07-15T10:14:31+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/MailToRecipients?rev=1436955271&do=diff The %MailToRecipients% token returns comma separated list of the to recipients in the currently selected mail message. text/html 2023-09-20T03:22:33+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/MusicPlayerState?rev=1695180153&do=diff MusicPlayerState Token The MusicPlayerState token (v11.0+) returns the current player state of the Music application. The possible result values are: * stopped * ‌playing * ‌paused * ‌fast forwarding * ‌rewinding * not running See Also text/html 2023-09-20T03:41:15+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/NamedClipboard?rev=1695181275&do=diff NamedClipboard Token The %NamedClipboard% token returns the text of a specified named clipboard. It has the form %NamedClipboard%<Name>% where <Name> specifies which past clipboard to use. See Also * Clipboards Tokens * %SystemClipboard% token * %PastClipboard% token * %TriggerClipboard% token * %SystemClipboardFlavors% token text/html 2023-09-20T03:46:41+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/NamedClipboardFlavors?rev=1695181601&do=diff NamedClipboardFlavorsToken The %NamedClipboardFlavors% token (v11.0+) returns the flavors of a specified named clipboard. It has the form %NamedClipboardFlavors%<Name>% where <Name> specifies which past clipboard to use. See Also * Clipboards Tokens * %SystemClipboard% token text/html 2015-07-15T09:56:29+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/NetworkLocation?rev=1436954189&do=diff The %NetworkLocation% token returns the current network location name. text/html 2019-07-01T06:59:56+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/NumberDate?rev=1561964396&do=diff NumberDate The %NumberDate% token returns the current date in a localized numeric format. Localization Prior to Mojave, and after Keyboard Maestro 9.0, dates should be in your chosen language. Unfortunately Apple changed Mojave and later to make the system return dates only in the Keyboard Maestro localized language (ie, English), regardless of your chosen locale. Keyboard Maestro 9.0 works around this by claiming to be in all locales, even though it is really only localized for English its… text/html 2017-09-05T03:59:38+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/Oct?rev=1504583978&do=diff text/html 2023-09-19T08:25:16+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/OptionReturn?rev=1695111916&do=diff OptionReturn Token The %OptionReturn% token (v11.0+) can be used in an Insert Text by Typing action to type an Option Return character. Anywhere else it will display as a unusual character (䷗) which hopefully no one ever tries to type. See Also Actions * Insert Text by Typing * See all Actions Tokens text/html 2023-09-20T03:36:29+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/PastClipboard?rev=1695180989&do=diff PastClipboard Token The %PastClipboard% token returns the text of a specified past clipboard. It has the form %PastClipboard%<Index>% where <Index> is a calculation which specifies which past clipboard to use. The indices start at 0 for the current system clipboard, 1 for the previous clipboard, and then onwards for as many clipboards as Keyboard Maestro has in its history (the default maximum is 200). text/html 2023-09-20T03:46:54+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/PastClipboardFlavors?rev=1695181614&do=diff PastClipboardFlavors Token The %PastClipboardFlavors% token (v11.0+) returns the flavors of a specified past clipboard. It has the form %PastClipboardFlavors%<Index>% where <Index> is a calculation which specifies which past clipboard to use. The indices start at 0 for the current system clipboard, 1 for the previous clipboard, and then onwards for as many clipboards as Keyboard Maestro has in its history (the default maximum is 200). text/html 2021-10-15T05:54:28+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/PasteByNameText?rev=1634277268&do=diff PasteByNameText Token The %PasteByNameText% token returns (v10.0+) the text entered in the last Paste by Name action. See Also Actions * Paste by Name action * See all Actions Tokens * See all Tokens text/html 2017-09-05T05:40:35+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/PromptButton?rev=1504590035&do=diff The %PromptButton% token (v8+) returns the name of the last selected Prompt for User Input button in this execution instance. This deprecates the Result Button special variable. See Also Actions * Alert action * Prompt for User Input action * Custom HTML Prompt action Tokens * %AlertButton% token * %HTMLResult% token text/html 2022-09-30T09:37:11+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/PromptWithListModifiers?rev=1664530631&do=diff PromptWithListModifiers Token The %PromptWithListModifiers% token returns (v10.2+) the modifiers used to complete the last Prompt With List action. See Also Actions * Prompt With List action * See all Actions Tokens * PromptWithListText token * See all Tokens text/html 2022-09-30T09:36:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/PromptWithListText?rev=1664530607&do=diff PromptWithListText Token The %PromptWithListText% token returns (v10.0+) the text entered in the last Prompt With List action. See Also Actions * Prompt With List action * See all Actions Tokens * PromptWithListModifiers token * See all Tokens text/html 2017-09-05T05:26:13+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/RandomUUID?rev=1504589173&do=diff The %RandomUUID% token (v8+) returns a new random universally unique ID. text/html 2023-09-19T08:25:54+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/Return?rev=1695111954&do=diff Return Token The %Return% token returns the carriage return (0x0D) character. See Also Tokens * %LineFeed% * %Space% * %Tab% * %OptionReturn% * See all Tokens Topics * Text Fields * FAQ Forum * Opening links in a different browser * Insert by typing: Inserting a \r into vim substitution * How to Insert RETURN between appended clipboard snippets text/html 2023-09-19T05:05:57+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/SafariBundleID?rev=1695099957&do=diff text/html 2023-09-19T05:06:35+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/SafariField?rev=1695099995&do=diff text/html 2023-09-19T05:13:59+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/SafariJavaScript?rev=1695100439&do=diff text/html 2023-09-19T05:05:32+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/SafariLongVersion?rev=1695099932&do=diff text/html 2023-09-19T05:06:03+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/SafariName?rev=1695099963&do=diff text/html 2023-09-19T05:05:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/SafariPath?rev=1695099950&do=diff text/html 2023-09-19T05:06:41+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/SafariReadyState?rev=1695100001&do=diff text/html 2023-09-19T05:07:00+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/SafariTitle?rev=1695100020&do=diff text/html 2023-09-19T05:06:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/SafariURL?rev=1695100007&do=diff text/html 2023-09-19T05:05:43+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/SafariVersion?rev=1695099943&do=diff text/html 2023-09-19T05:06:53+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/SafariWindowName?rev=1695100013&do=diff text/html 2025-01-28T02:40:17+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/Screen?rev=1738032017&do=diff The %Screen% and %ScreenVisible% tokens return the frame or visible frame of the specified screen. It takes a parameter indicating which screen to use. The parameter may be: Index Name Description Main or 0 the screen with the primary menu bar (as configured in the Displays preferences). text/html 2023-09-14T08:41:04+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ScreenResolution?rev=1694680864&do=diff ScreenResolution(s) Token The %ScreenResolution% token (v11.0+) returns the resolution of the specified screen. The %ScreenResolutions% token (v11.0+) returns the available resolutions of the specified screen. They both takes a parameter indicating which screen to use. text/html 2023-09-14T08:39:12+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ScreenResolutions?rev=1694680752&do=diff text/html 2015-07-07T06:01:04+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ScreenVisible?rev=1436248864&do=diff text/html 2024-05-21T06:15:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/SelectMenuByNameText?rev=1716272147&do=diff SelectMenuByNameText Token The %SelectMenuByNameText% token returns (v11.0.3+) the text entered in the last Select Menu by Name action. See Also Actions * Select Menu by Name action * See all Actions Tokens * See all Tokens text/html 2019-07-01T06:58:32+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ShortDate?rev=1561964312&do=diff ShortDate The %ShortDate% token returns the current date in a localized short format. Localization Prior to Mojave, and after Keyboard Maestro 9.0, dates should be in your chosen language. Unfortunately Apple changed Mojave and later to make the system return dates only in the Keyboard Maestro localized language (ie, English), regardless of your chosen locale. Keyboard Maestro 9.0 works around this by claiming to be in all locales, even though it is really only localized for English itself. text/html 2019-07-01T06:59:41+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/ShortTime?rev=1561964381&do=diff ShortTime The %ShortTime% token returns the current time without seconds in a localized format. Localization Prior to Mojave, and after Keyboard Maestro 9.0, dates should be in your chosen language. Unfortunately Apple changed Mojave and later to make the system return dates only in the Keyboard Maestro localized language (ie, English), regardless of your chosen locale. Keyboard Maestro 9.0 works around this by claiming to be in all locales, even though it is really only localized for Engli… text/html 2023-09-19T08:27:13+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/Space?rev=1695112033&do=diff Space Token The %Space% token returns the space character. See Also Tokens * %Return% * %LineFeed% * %Tab% * %OptionReturn% * See all Tokens Topics * Text Fields * FAQ text/html 2023-09-20T03:39:01+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/SystemClipboard?rev=1695181141&do=diff SystemClipboard Token The %SystemClipboard% token (prior to v8, called the %CurrentClipboard% token) returns the text of the current system clipboard. See Also * Clipboards Tokens * %PastClipboard% token * %NamedClipboard% token * %TriggerClipboard% token * %SystemClipboardFlavors% token * %PastClipboardFlavors% token * %NamedClipboardFlavors% token * %TriggerClipboardFlavors% token * All Tokens text/html 2025-11-11T02:40:12+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/SystemClipboardFlavors?rev=1762828812&do=diff SystemClipboardFlavors Token The %SystemClipboardFlavors% token (v11.0+) returns the flavors of the current system clipboard. See Also * Clipboards Tokens * %SystemClipboard% token * %PastClipboard% token * %NamedClipboard% token * %TriggerClipboard% token * %PastClipboardFlavors% token * %NamedClipboardFlavors% token * %TriggerClipboardFlavors% token * All Tokens text/html 2023-09-19T07:31:32+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/SystemLongVersion?rev=1695108692&do=diff text/html 2024-02-19T06:08:57+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/SystemVersion?rev=1708322937&do=diff SystemVersion Token The %SystemVersion% and %SystemLongVersion% tokens (v11.0+) return the macOS version that is running on this Mac. Note the %SystemLongVersion% token was incorrectly %LongSystemVersion% from v11.0-v11.0.2. See Also Actions * text/html 2015-07-15T09:57:58+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/SystemVolume?rev=1436954278&do=diff The %SystemVolume% token returns the current system volume. text/html 2023-09-19T08:27:06+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/Tab?rev=1695112026&do=diff Tab Token The %Tab% token returns the tab (0x08) character. See Also Tokens * %Return% * %LineFeed% * %Space% * %OptionReturn% * See all Tokens Topics * Text Fields * FAQ text/html 2020-02-16T12:47:23+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/Trigger?rev=1581857243&do=diff The %Trigger% token returns the trigger description of the trigger that fired this macro. See Also Tokens * %TriggerBase% token * %TriggerValue% token * %TriggerClipboard% token * All Tokens text/html 2025-12-11T07:51:39+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/TriggerBase?rev=1765439499&do=diff TriggerBase Token The %TriggerBase% token returns the trigger type. The token will return one of these, which corresponds exactly to the name of each trigger as shown when clicking the New Trigger button: Hot Key Trigger
 Global Macro Palette Trigger 
Status Menu Trigger 
Typed String Trigger Application Trigger Audio Output Changed Trigger Clipboard Changed Trigger Clipboard Filter Trigger Cron Trigger Dragged File Trigger Engine Launch Trigger Focused Window Trigger Folder Trigger Gesture… text/html 2023-09-20T03:43:31+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/TriggerClipboard?rev=1695181411&do=diff TriggerClipboard Token The %TriggerClipboard% token (v8+) returns the text of a Trigger Clipboard. The Trigger Clipboard is not a clipboard per se, but a reference to a clipboard, either the System Clipboard, a past clipboard in the Clipboard History, or a Named Clipboard. It is the clipboard referenced by a text/html 2023-09-20T03:46:31+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/TriggerClipboardFlavors?rev=1695181591&do=diff TriggerClipboardFlavorsToken The %TriggerClipboardFlavors% token (v11.0+) returns the flavors of a Trigger Clipboard. The Trigger Clipboard is not a clipboard per se, but a reference to a clipboard, either the System Clipboard, a past clipboard in the Clipboard History, or a Named Clipboard. It is the clipboard referenced by a text/html 2025-02-26T02:13:16+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/TriggerValue?rev=1740535996&do=diff The %TriggerValue% token returns the value associated with how the macro was triggered. Different ways of triggering the macro will set this field differently. * You can pass an explicit value in using the “with parameter” option when executing a script from AppleScript. text/html 2021-10-15T05:55:57+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/UserHome?rev=1634277357&do=diff UserHome Token The %UserHome% token returns (v10.0+) the user home directory. See Also Actions * Execute a Shell Script action * See all Actions Tokens * See all Tokens text/html 2015-07-15T09:15:51+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/UserLoginID?rev=1436951751&do=diff The %UserLoginID% token returns the current user login id. text/html 2015-07-15T09:15:43+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/UserName?rev=1436951743&do=diff The %UserName% token returns the current user name. text/html 2023-09-13T03:50:48+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/Variable?rev=1694577048&do=diff Variable Token The %Variable%<VariableName>% token allows you to include a variable in a token text field, where <VariableName> is the name of the variable. For Example, using the Insert Text Action: You can (v7.2+) access a variable as if it is a comma separated array of text using the notation text/html 2021-01-08T06:28:34+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/VBAR?rev=1610087314&do=diff The vertical bar text token (%|%) is a special token used with the Insert Text action which adds a sequence of left arrow keystrokes to the end of the action to (attempt to) position the insertion cursor at the desired spot. For example: Insert Text: Sally said "%|%" to Nikola. text/html 2023-09-19T04:59:56+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/WebBrowserTokens?rev=1695099596&do=diff Web Browser Tokens Keyboard Maestro can provide a wealth of information from compatible web browsers. It does this by communicating with the browsers via AppleScript, so only browsers that support a compatible AppleScript can be used, which is currently restricted to browsers that support the Safari or Chrome AppleScripts, which includes Safari, Chrome, Brave, Vivaldi, Edge and their developmental versions. text/html 2019-07-05T07:47:12+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/WindowFrame?rev=1562312832&do=diff text/html 2019-07-05T07:45:13+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/WindowName?rev=1562312713&do=diff text/html 2019-07-05T07:47:27+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/WindowPosition?rev=1562312847&do=diff text/html 2019-07-05T07:47:46+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/WindowSize?rev=1562312866&do=diff text/html 2020-09-01T00:03:19+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/Window_Tokens?rev=1598918599&do=diff Window Related Tokens This Wiki page receives the redirect for a number or windows related tokens: * %WindowName% and %FrontWindowName% * %WindowFrame% and %FrontWindowFrame% * %WindowPosition% and %FrontWindowPosition% * %WindowSize% and %FrontWindowSize% Each of these text tokens return information about the specified window. Token Parameters The non-Front variants take a parameter indicating the window. The parameter is the value text/html 2025-07-09T09:11:40+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/token/WirelessNetwork?rev=1752052300&do=diff WirelessNetwork The %WirelessNetwork% token returns the name of the currently connected wireless network(s). (!) Note that wireless information requires Location system security permissions in macOS Sonoma, so ensure the Keyboard Maestro Engine has Locations permissions if you are using Sonoma or later.