https://wiki.keyboardmaestro.com/ 2026-04-26T19:17:41+00:00 https://wiki.keyboardmaestro.com/ https://wiki.keyboardmaestro.com/_media/wiki/logo.png 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 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 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 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 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 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 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 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 2025-02-04T03:49:32+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/Videos?rev=1738640972&do=diff Video Tutorials This page will link to a variety of tutorial videos. David “MacSparky” Sparks Keyboard Maestro Field Guide David Sparks has released his much anticipated Keyboard Maestro Field Guide with over four hours of video separated into 76 videos in 8 sections covering a broad range of Keyboard Maestro facilities, full of “heaps of dangerous knowledge, tricks, and hacks to make your Mac dance”. 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-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-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 2023-09-28T04:30:32+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Macro_Groups?rev=1695875432&do=diff Macro Groups Keyboard~~Maestro organizes your macros into Macro~~Groups which are like folders of macros. Each Macro~~Group contains a number of macros and controls when those macros are active. A Macro~~Group can target or exclude specific applications, which means the macros it contains will only be active in those desired applications or when those applications are running. For example, you can have macros which are active only in Mail.app. It can also be active only in specific windows.… text/html 2022-11-09T10:30:31+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Trigger_Macro_by_Name?rev=1667989831&do=diff Trigger Macro by Name Action The Trigger Macro by Name action displays a Spotlight-like window, where you trigger execution of a Macro by searching for it, and then selecting it. Like the Mac Spotlight, it will search all of your active, enabled Macros whose name or contents contain what you type. It is a character search, so it will also find Macro names and words that contain what you type. 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 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 2023-10-06T06:28:24+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Plug_In_Actions?rev=1696573704&do=diff Plug In Actions You can develop custom Macro Actions using a facility known as Plug In Actions. After you install a Plug In Action in your local Keyboard Maestro Support folder, you can use them like the built-in Actions. Third Party Plug In Actions You can download Plug In Actions developed by others from these sources: text/html 2018-07-21T00:48:15+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/trigger/Web_Server?rev=1532134095&do=diff Web Server Overview If the Keyboard Maestro web server is enabled, then you can connect to it using your web browser. :!: Note: A HTTP Port of 4490 or 4491 is used in all examples on this page. But it can be set to any port you prefer. To Display the Web Server User Interface 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 2025-10-06T07:17:35+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/Forum?rev=1759735055&do=diff Using the Keyboard Maestro Forum The Keyboard Maestro forum is a very helpful place to ask about creating Keyboard Maestro macros. While Stairways can answer support questions related to using Keyboard Maestro and creating macros in general, questions about creating specific macros or controlling specific applications are better asked on the forum. text/html 2025-08-04T02:59:49+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/Getting_Started?rev=1754276389&do=diff Getting Started The first things to do are: * Read the Quick Start (Help ➤ Quick Start) which will get you familiar with Keyboard Maestro terminology. * Do the Tutorial (Help ➤ Tutorial). Now you know the basics of creating a macro. * When Keyboard Maestro asks, sign up for the Getting Started email series. 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 2020-08-18T01:27:19+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/Tokens?rev=1597714039&do=diff Tokens Definition Tokens in Keyboard Maestro represent placeholders, that you enter during design time, for information that will be replaced in the text at run time. For example, you could enter the %SafariTitle% token in a Set Variable to Text Action, and when you trigger the macro it will be replaced with the title of the current Safari tab. So the value of the Token will be determined at execution time. All tokens return a text value, even if the source data was some other data type. 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 2019-08-27T11:43:14+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Conceal_Macro_Palettes?rev=1566906194&do=diff The Conceal Macro Palettes action allows you to: * Reveal Macro Palettes. * Conceal Macro Palettes. * Conceal Macro Palettes until Application Switch. Select the required option from the pop-up. The Conceal options include a Reveal if already concealed 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 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 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: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 2025-12-24T02:04:08+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Glossary?rev=1766541848&do=diff Glossary Active/Deactivated A Macro Group is active only if the conditions of the macro group are satisfied (eg a specific application is frontmost). A macro is available to be triggered only if it is enabled, and it’s parent macro group is enabled and active. Active is a transient state and can change over time as the state of the system changes (eg as different applications are frontmost) text/html 2023-10-02T04:10:22+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Tokens?rev=1696219822&do=diff Tokens Keyboard Maestro provides two means to get information about objects (like web pages and windows) in the user's environment: * Tokens (returns text, used in text token fields) * Functions (returns numbers, used in numeric fields) You can enter a Token in any text field in an Action, and when the Macro is triggered and the Action is executed, the token will be replaced by the value that is returned at that time. This allows you to easily combine static text with dynamic data that is s… text/html 2023-09-26T07:09:04+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Tour?rev=1695712144&do=diff Tour This demonstration will begin to show you the power and versatility of Keyboard~~Maestro. Getting Started To start, launch Keyboard~~Maestro. It will initially display the Welcome window. [ Welcome Window ] If you are new to Keyboard Maestro, start the tutorial and Keyboard Maestro will show you how easy it is to create a macro. 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 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…