https://wiki.keyboardmaestro.com/ 2026-04-26T17:34:56+00:00 https://wiki.keyboardmaestro.com/ https://wiki.keyboardmaestro.com/_media/wiki/logo.png text/html 2025-10-03T09:53:40+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/Troubleshooting?rev=1759485220&do=diff Troubleshooting This Wiki article is intended to address situations where you find that Keyboard Maestro does not work as you expect, or works in an unexpected way, and you have been unable to identify the cause and fix it. This article aims to help you resolve this issue and make Keyboard Maestro work as you intend. This article does text/html 2024-07-16T12:10:53+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Preferences?rev=1721131853&do=diff Preferences To configure Keyboard~~Maestro, first launch Keyboard~~Maestro and choose Preferences from the Keyboard Maestro menu. [ Preferences General Pane ] The preferences are divided into sections. General Preferences In the General preference pane you can: * enable or disable launching the Keyboard~~Maestro~~Engine at Login. text/html 2021-01-25T07:50:32+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/actions/Browser_Actions?rev=1611561032&do=diff Keyboard Maestro provides a large set of web browser actions that work with Safari and Google Chrome, but require each browser to be set to accept their input as described below. * Browser Window Actions (like New Tab, Set URL, etc). * Browser Form Actions (like Set Field, Set Checkbox). text/html 2019-01-12T17:43:46+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/JavaScript_for_Automation?rev=1547315026&do=diff JavaScript for Automation (JXA) Discussion Scope and Summary This Wiki article is a broad topic, which covers these major areas: * Introduction to JXA * Using JXA with Keyboard Maestro * JXA Background * Comparison with AppleScript Introduction text/html 2024-01-25T03:06:57+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/actions/Execute_a_JavaScript_in_Browser?rev=1706152017&do=diff Execute JavaScript in Browser Actions There are several Execute a JavaScript in Browser actions that let you execute a JavaScript in a web browser page: * Execute a JavaScript in Front Browser * The “Front Browser” is whichever of the following is currently frontmost, or was the last web browser that was frontmost: text/html 2024-09-16T07:05:35+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/assistance/Web_Browser_Automation?rev=1726470335&do=diff Web Browser Automation Keyboard Maestro can control Safari (or Safari-like browsers like Safari Technology Preview) or Google Chrome (or Chrome-like browsers like Chrome Canary) using Browser Window Actions or Browser Form Actions. In order to control the browser, Keyboard Maestro needs Automation permission for the browser, and the browser needs to be configured to Allow JavaScript From Apple Events. 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-01T06:50:08+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/actions/Wait_For_Browser_to_Finish_Loading?rev=1561963808&do=diff Wait For Browser to Finish Loading The Wait For Browser to Finish Loading action waits for a web page to finish loading before executing further actions. Like other browser actions, this action works with Safari or Google Chrome (or whichever of the two was last at the front). text/html 2025-06-09T06:05:55+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Whats_New?rev=1749449155&do=diff What’s New? Keyboard~~Maestro~~11 expands on the powerful base of previous versions, improving the editor, adding many new actions and triggers, New Macro Wizard, a new Security preference pane, a keyboardmaestro command line tool, support for Apple Text Recognition, and more. Keyboard text/html 2021-03-24T21:52:30+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/actions/Browser_Form_Actions?rev=1616622750&do=diff Browser Form Actions Introduction The Browser Form Actions let you interact with form fields in a active web browser page, including submitting forms, reading, writing and focusing fields, and more. These are companion actions to the browser window actions for creating and moving between tabs and windows. text/html 2023-09-21T08:13:55+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Features?rev=1695284035&do=diff Features Keyboard~~Maestro is a productivity enhancer with several main functions. It allows you to: * record and design your own macro shortcuts and activate them at any time. * work with clipboard history using Clipboard History Switcher. * work with an unlimited number of saved clipboards using text/html 2025-03-02T03:08:23+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Variables?rev=1740884903&do=diff Variables Like most programming languages, Keyboard Maestro allows you to create Variables to store data for use later on in the same Macro, or in other Macros. Variables can be set from many actions. You can set variables to specific tokenised text, to the result of a text/html 2025-02-05T02:36:18+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/Actions?rev=1738722978&do=diff Macro Actions Definition An Action in Keyboard Maestro is a specific process step (usually of limited scope) to be taken in a Keyboard Maestro Macro. If a process consists of a series of steps, then an Action would be one step. A Macro may contain one or more text/html 2024-09-09T05:40:49+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/Macro_Groups?rev=1725860449&do=diff Macro Groups Keyboard Maestro organizes your Macros into Macro Groups which are like folders of macros. Each Macro Group can contain zero or more Macros. Subfolders are not allowed. Purpose * Provide a folder-like container for related Macros. * Control when those Macros are active, and available to be triggered. text/html 2019-07-01T05:11:58+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/Scripting?rev=1561957918&do=diff Scripting on OS X Using Keyboard Maestro While the number of, and power of, native Keyboard Maestro Actions is vast, sometimes you may need to do something that Keyboard Maestro is not well suited to do. But Keyboard Maestro has anticipated, and provided for this, by providing a number of Execute Script Actions, all of these available from the Execute category in the Action List: text/html 2017-03-06T02:01:56+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Bring_Application_Windows_to_Front?rev=1488765716&do=diff The Bring Application Windows to Front action simply brings all the windows of the current application to the front. It has no further options. See Also ---------- Actions * Login Window * Manipulate a Window * Move or Click Mouse * New_Google_Chrome_Window * New Safari Window * See all Actions Conditions * Any_Window * Front_Window * See all Conditions Functions * MENUBARHEIGHT() * MOUSEBUTTON() * MOUSEX() text/html 2017-03-06T02:00:39+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Login_Window?rev=1488765639&do=diff The Login Window action calls up the Login Window. See Also ---------- Actions * Bring Application Windows to Front * Manipulate a Window * Move or Click Mouse * New_Google_Chrome_Window * New_Safari_Window * See all Actions Conditions * Any Window * Front Window * See all Conditions Functions * MENUBARHEIGHT() * MOUSEBUTTON() * MOUSEX() * MOUSEY() * SCREEN() * SCREENCOUNT() * SCREENVISIBLE() * WINDOW() * WINDOWCOUNT() * See all Functions Tokens * %FrontWindowFrame%… text/html 2021-10-12T05:10:03+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Manipulate_a_Window?rev=1634015403&do=diff Manipulate a Window Action The Manipulate a Window action allows you to operate on a window, in a specified application, with a wide variety of actions like scale, move, resize, bring to front, etc. (see complete list below). :!: Note: All units are in text/html 2023-09-15T06:20:06+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Move_or_Click_Mouse?rev=1694758806&do=diff Move or Click Mouse Action The Move or Click Mouse action allows you to move, click or move and click the mouse using any mouse button, and optionally dragging. You can specify modifiers such as the shift key, as well as the position, relative to any corner of the front window, the main screen, or the current mouse location, or a found image on the screen. text/html 2017-08-30T10:04:22+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/actions/Browser_Window_Actions?rev=1504087462&do=diff The Browser Window Actions let you interact with browser tabs and windows, including creating new windows or tabs, selecting specific tabs, or setting the URL or title. These actions sit alongside the browser form actions for interacting with the active browser tab. Like other text/html 2017-09-05T08:18:20+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/actions/Click_Browser_Link?rev=1504599500&do=diff The Click Browser Link actions let you click a link in a active web browser page. These actions sit alongside the browser window actions for creating and moving between tabs and windows and the browser form actions for interacting with the active browser page. Like other browser actions, these actions work with Safari or Google Chrome (or whichever of the two was last at the front). text/html 2024-08-13T03:07:48+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/assistance/Secure_Input_Problem?rev=1723518468&do=diff Secure Input Problem macOS will not let applications watch the keyboard when you are in a password field (to prevent hackers getting hold of your passwords). However, the system can sometimes get into a state where it thinks it is permanently in a password fields. There are many possible culprits for this but almost anything that asks for a password could cause the problem (eg, web password fields, web password managers, VPN connections, Mail, Parallels, etc). Quitting the appropriate affected … 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 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 2025-04-28T03:41:19+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Administrative_Details?rev=1745811679&do=diff Administrative Details Requirements Keyboard~~Maestro~~11 requires macOS 10.13 or later. Distribution You may distribute this application in any way you wish as long as you only distribute the unmodified Keyboard~~Maestro package, as downloaded from 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…