https://wiki.keyboardmaestro.com/ 2026-05-23T21:15:35+00:00 https://wiki.keyboardmaestro.com/ https://wiki.keyboardmaestro.com/_media/wiki/logo.png 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-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 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-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 2025-07-25T08:06:29+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/Fundamental_Concepts?rev=1753430789&do=diff Fundamental Concepts First, if you have not done so already, please read the Quick Start. That tells you all the things you need to know to get started using Keyboard Maestro, as well as getting a grounding the terminology used in Keyboard Maestro. This page is designed to document some of the fundamental concepts that are important for a deeper understanding of how things work in Keyboard Maestro, but which are so fundamental that there is not necessarily a specific place to document them els… text/html 2023-11-28T08:07:21+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Execute_a_JavaScript_in_Custom_Prompt?rev=1701158841&do=diff Execute JavaScript in Custom HTML Prompt The Execute JavaScript in Custom HTML Prompt action let you execute JavaScript in a Custom HTML Prompt window. [ Execute JavaScript in Custom HTML Prompt Action ] This action allows you to execute a specified JavaScript, either from a file or text entered in the Action itself, and return the results. text/html 2022-10-31T01:42:37+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Semaphore_Lock?rev=1667180557&do=diff Semaphore Actions The Semaphore actions (Lock, Unlock and Reset) allow you to prevent (a) multiple triggers of the same macro from executing simultaneously, and/or (b) multiple macros from executing simultaneously. Background When you trigger a macro, the Keyboard Maestro Engine takes a copy of it and starts executing it. If you trigger another macro before the first one finishes, that will start executing as well - both will be executing more or less simultaneously. 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 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-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-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 2021-11-24T06:50:13+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/trigger/Folder?rev=1637736613&do=diff Folder Trigger The Folder trigger (v7.0+) executes the macro when a specified folder on your Mac: * adds an item. * removes an item. * adds or removes an item. The item must be directly in the folder - changes in a subfolder will not be noticed. text/html 2024-09-29T02:42:40+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/Clipboards?rev=1727577760&do=diff Clipboards Keyboard Maestro supports several different types of clipboards * — the standard Mac OS X Clipboard used by all Mac apps * The alternate name “Current Clipboard” is used in some Macro Actions * — Copy of System Clipboard, or other Named Clipboard, created by user for future use text/html 2025-10-03T09:53:10+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/Frequently_Asked_Questions?rev=1759485190&do=diff How do I get started? * 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 2023-10-10T07:11:49+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/Search?rev=1696921909&do=diff Searching in Keyboard Maestro There are several different types of searches in Keyboard Maestro * Searching for Macros in the Keyboard Maestro Editor * Macro Actions that Search the Clipboard and Variables * Searching this Wiki (see below) Searching the Wiki Search is done through the Search box in top row (Shortcut Key text/html 2021-10-13T03:09:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Copy?rev=1634094587&do=diff Cut, Copy and Paste Actions The Cut, Copy and Paste actions carry out the usual cut, copy and paste actions involving the system clipboard. They operate primarily by simulating the appropriate command key (Command-X, Command-C, Command-V) with small pauses to allow the application to process the clipboard. The Cut and Copy actions wait until the clipboard changes before proceeding. text/html 2021-12-11T15:14:15+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Custom_HTML_Prompt?rev=1639235655&do=diff Custom HTML Prompt Action The Custom HTML Prompt action allows you to display an entirely customized window to gather or display information in any way desired (v7.0+). This is quite an advanced action, and requires designing the window in HTML (including text/html 2022-09-27T05:15:41+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Execute_a_Macro?rev=1664255741&do=diff Execute a Macro Action The Execute Macro action allows you to execute another macro like a subroutine, though without any ability to pass parameters or receive a result other than through variables (if you want to pass parameters in to a sub-macro or receive a result from it, consider making it a subroutine by adding the text/html 2023-09-15T06:21:26+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Find_Image_on_Screen?rev=1694758886&do=diff Find Image on Screen Action The Find Image on Screen action finds a specified image on the screen in a specified area and stores the image location and fuzziness (left,top,width,height,fuzz) in a Keyboard Maestro Variable. [ Find Image on Screen ] You can specify the image to search based on: 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 2023-08-04T08:37:31+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Play_Sound?rev=1691138251&do=diff The Play Sound action plays a selected sound through a specified output device at a selected volume. The Play sound pop-up lists all the installed system sounds, but the other choice allows you to choose any other saved sound. The out device pop-up lets you choose from any connected output device. text/html 2023-09-15T08:10:58+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Press_a_Button?rev=1694765458&do=diff Press a Button Action The Press a Button action presses a named button in the front window. As well as pressing buttons, you can perform other actions (v11.0+) such as showing the menu for the button, or incrementing or decrementing a slider, or canceling the button.... text/html 2023-11-20T03:03:00+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Set_Action_Delay?rev=1700449380&do=diff The Set/Reset Action Delay action lets you set the various arbitrary delays used in Keyboard Maestro, either for this macro, or (not recommended!) (semi)permanently for all macros. You can set the following delays: * Between Actions Delay (0.0 seconds) text/html 2017-08-30T08:23:54+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Wait_For_Front_Browser_to_Finish_Loading?rev=1504081434&do=diff text/html 2017-08-30T08:23:01+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Wait_For_Google_Chrome_to_Finish_Loading?rev=1504081381&do=diff text/html 2017-08-30T08:23:30+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Wait_For_Safari_to_Finish_Loading?rev=1504081410&do=diff text/html 2023-10-24T05:28:42+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Command_Line_Tool?rev=1698125322&do=diff Command Line Tool Keyboard Maestro includes a command line tool to let you execute macros from the shell command line. The tool is named keyboardmaestro and is located within the Keyboard Maestro.app application. Assuming the application is installed in the Applications folder, the command line tool will reside at: text/html 2023-09-26T07:58:00+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/How_do_I?rev=1695715080&do=diff How do I ...? How do I install Keyboard Maestro? To install Keyboard~~Maestro, download it and then use the Finder to move it to your Mac’s FILE{{{Applications}}} folder (or anywhere you like). Note: You must use the Finder to do this since the Finder will turn off text/html 2023-09-29T08:16:00+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Macro_Syncing?rev=1695975360&do=diff Macro Syncing Keyboard Maestro is licensed on a per user basis on up to five Macs, so if you use it on two or more Macs you may want to transfer some of your macros from one to the other. You can do this by selecting the desired macros and choosing the text/html 2025-11-18T04:13:02+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/trigger/Hot_Key?rev=1763439182&do=diff Hot Key Trigger The Hot Key trigger is perhaps the most common and most basic of all triggers. When you press the configured keyboard key, the system swallows the keystroke, and Keyboard Maestro executes the macro. The Key The key can be a letter, number, symbol or function key, often in combination with one or more modifiers (Shift, Control, Option and/or Command). Almost any key can be a trigger, and keep in mind the number pad counts as different keys to the numeric keys on the main keyb… text/html 2023-10-24T05:28:36+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/trigger/keyboardmaestro?rev=1698125316&do=diff keyboardmaestro CLI Tool You can use the keyboardmaestro CLI Tool to trigger or edit macros. The keyboardmaestro command line tool is included within the Keyboard Maestro.app package, in the Contents/MacOS folder, so if the Keyboard Maestro.app package is installed in the normal location in the /Applications folder, the path to the command will be: text/html 2025-06-19T05:49:15+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/trigger/USB_Device_Key?rev=1750312155&do=diff USB Device Key Trigger This is an advanced trigger — generally you should use a Hot Key Trigger if possible. The USB Device Key trigger executes a macro when any device key is pressed — this includes modifier keys, mouse buttons, many programmable keyboards, and even the brightness buttons on USB connected monitors.