https://wiki.keyboardmaestro.com/ 2026-05-17T10:12:12+00:00 https://wiki.keyboardmaestro.com/ https://wiki.keyboardmaestro.com/_media/wiki/logo.png text/html 2026-04-15T07:55:08+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Menus?rev=1776239708&do=diff Menus Below is a complete list of all menus. Note that in some cases you must hold down the Option Key (or or ) to see the menu item. For example, the “Expand All Actions” item in the Actions menu. Keyboard Maestro The Keyboard Maestro menu contains menu items relating to the Keyboard text/html 2017-06-13T02:23:44+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/Macro_Library?rev=1497320624&do=diff Macro Library Sample Macros Keyboard Maestro provides an extensive library of sample macros as part of the app installation. Open the Editor, and goto the menu Window > Macro Library to display the library. You can then select one or more macros to import into your library. 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-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 2023-10-10T06:24:52+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/Ideas?rev=1696919092&do=diff Ideas This is a collection of some of the most impressive and also easiest macros users wrote. As an inspiration and starter for fellow Keyboard Maestros. Text A macro with the following layout: Type the ⌘C Keystroke Filter Clipboard with XXX Type the ⌘V Keystroke 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 2023-10-06T07:46:44+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Windows?rev=1696578404&do=diff Windows Welcome Window This window welcomes new users and gives you some options for learning about Keyboard Maestro. [ Welcome Window ] If you are new to Keyboard Maestro, start the tutorial and Keyboard Maestro will walk you through creating a simple macro. Macros Window 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-03T08:15:49+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Application_Switcher?rev=1696320949&do=diff Application Switcher The Activate Application Switcher action macro is a highly specialized macro action that enables you to launch, switch, hide, and quit applications. By triggering the macro, the Application Switcher enables you to switch between all running applications. Once the switching window appears, you may select the application to activate, and Application Switcher will take you to it. 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-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 2025-09-09T19:14:18+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/wiki/syntax?rev=1757445258&do=diff Formatting Syntax DokuWiki supports some simple markup language, which tries to make the datafiles to be as readable as possible. This page contains all possible syntax you may use when editing the pages. Simply have a look at the source of this page by pressing 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 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 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-10-10T05:47:37+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/About_Keyboard_Maestro?rev=1696916857&do=diff About Keyboard Maestro Keyboard Maestro is a powerful macro program for macOS which has received glowing reviews. Keyboard Maestro 11 is now available, 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. 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 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 2023-09-15T08:46:30+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Activate_a_Specific_Application?rev=1694767590&do=diff Activate a Specific Application This action switches to, and launches if necessary, the specified application. It is the equivalent of using the macOS App Switcher, or launching the application by any means. [ Activate a Specific Application Action ] How To Use * Select the App from the 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 2023-09-28T06:11:42+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Macros?rev=1695881502&do=diff Macros Macros are used to automate your workflow, procedure, or process on your Mac. Macros are a way of improving your productivity by allowing you to perform repetitive or frequently required actions more quickly and accurately, tailoring your Mac to your usage patterns. text/html 2024-03-11T06:22:13+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Palettes?rev=1710138133&do=diff Palettes Keyboard Maestro can display a number of Palettes (or Toolbars). There are four types of palettes: * Global Macro Palette. * Applications Palette. * Conflict Palette. * Macro Group palettes. 1. Global Macro Palette Any macro with the text/html 2026-02-01T04:48:43+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Quick_Start?rev=1769921323&do=diff Quick Start Keyboard~~Maestro is easy to use once you understand the way the Editor and Engine, Macro~~Groups and Macros, Triggers and Actions work together. By using these six components together, you can dramatically enhance your Mac experience. 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-10-28T02:40:57+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/trigger/Typed_String?rev=1761619257&do=diff Typed String Trigger The Typed String trigger lets you execute a macro in response to a sequence of keys. Typed String triggers allow you to use more verbose (and hence descriptive) sequences of keys to trigger a macro. Because the keys first go through to the current application, the keys are usually deleted prior to executing the macro, although with this disabled you can use it in an application that largely ignores keys. Triggers can include non- 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 2023-09-13T02:34:52+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/User_Manual?rev=1694572492&do=diff User Manual * Single Page Version * PDF Version * * Overview * What’s New? * Features * Purchase * Screenshots * Tour * Links * Quick Start * Assistance * How do I ...? * Editor Window * Macro Groups * Smart Groups * Macros * Macro Triggers * Macro Actions * Macro Syncing * Macro Debugger * Variables * Tokens * Calculations * Conditions * Collections * Filters * Dictionaries * JSON * Search Strings * Palettes * Recording * Macro Library * Macro Examples * I… text/html 2014-10-18T01:59:56+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/Window_Movers?rev=1413597596&do=diff These macros can be used to control the size and position of the front window, moving and resetting its size to take up half, one third, two thirds, a quarter or all of its current monitor. Window Left and Right can be used to move the window from one monitor to another, avoiding the need to reach for the mouse._____________ text/html 2015-06-30T03:45:03+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Activate_Window_Switcher?rev=1435635903&do=diff The Activate Window Switcher is essentially a highly specialized macro action that enables you to show, hide, and minimize windows. By triggering the macro, Window Switcher enables you to switch between all open windows in the current application. Once the switching window appears, you may select the window to activate, and Window Switcher will bring it to the front. text/html 2023-09-15T09:04:08+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Pause_Until?rev=1694768648&do=diff Pause Until Action The Pause Until action pauses until criteria for conditions are met. By default (v11.0+) Keyboard Maestro will start to conserve CPU usage of this action if it runs for a long time (after 10 seconds it will conserve a little, after 60 seconds it will conserve a lot) by only checking the condition periodically. You can turn off this feature in the action (gear) ⚙ menu. text/html 2023-09-13T04:04:43+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Prompt_for_User_Input?rev=1694577883&do=diff Prompt For User Input Action Prompt For User Input allows you to design a form that will ask for user input, storing the results in Keyboard Maestro Variables. You can prompt for variables with text, checkbox, popup menu, or password fields. [ Prompt For User InputAction ] This action produces this Display: text/html 2026-03-27T04:29:38+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Set_Next_Engine_Window_Position?rev=1774585778&do=diff Set Next Engine Window Position Action The Set Next Engine Window Position action allows you to specify where the next Keyboard Maestro Engine window will be placed. This applies to pretty much any window, such as text displays. This allows you to specify the position of windows that would otherwise appear in a predefined spot. text/html 2021-10-14T04:33:11+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Until?rev=1634185991&do=diff Until Action Definition The Until action executes a list of actions until conditions are met. The Until action condition is not evaluated UNTIL the end of the Until Loop, so it will always execute all Actions in the Until block at least once. It is one of several Actions that text/html 2021-10-14T04:33:21+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/While?rev=1634186001&do=diff While Conditions Are Met Action This Action repeats a group of Actions while the Conditions in the While criteria are met. As soon as the While Criteria is not met, the Action will exit the loop. It is one of several Actions that loop through a set of other Actions until some criteria is met. 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 2023-09-27T08:56:43+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Editor_Window?rev=1695805003&do=diff Editor Window To edit your macros, launch the Keyboard Maestro application. It will display one or more Editor Windows. If you close the last editor window, the Keyboard Maestro application will quit, but the Keyboard Maestro Engine will continue running to perform your macros. Normally you only launch the Keyboard Maestro editor application when you want to change your macros, and leave only the Keyboard Maestro Engine running normally. text/html 2023-10-03T08:02:00+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Recording?rev=1696320120&do=diff Recording Keyboard~~Maestro has the ability to create macro action sequences by recording your actions. For example, to create a macro that simulates keystrokes, rather than create each macro action individually you can enable recording and then simply type the keystrokes. text/html 2023-09-05T04:42:05+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Single_Page_Version?rev=1693888925&do=diff Keyboard Maestro 11 User Manual * Multi-Page Version * PDF Version * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Overview text/html 2023-10-03T08:16:22+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Window_Switcher?rev=1696320982&do=diff Window Switcher The Activate Window Switcher macro is a highly specialized macro action that enables you to show, hide, and minimize windows. By triggering the macro, Window~~Switcher enables you to switch between all open windows in the current application. Once the switching window appears, you may select the window to activate, and Window 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 2024-10-12T09:23:08+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/Found_Image?rev=1728724988&do=diff Found Image Although it is generally better to use high level actions like Press Button or Resize Window action, it is sometimes necessary to resort to looking at the screen for a specific image and responding appropriately (behaving differently if it exists, clicking on it, moving things to it, etc). 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 2023-09-18T05:12:53+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Activate_Last_Application?rev=1695013973&do=diff Activate Last Application The Activate Last Application action switches back to the application you were in previously. You can configure whether it activates all windows or opens the initial new document in the action (gear) ⚙ menu (v11.0+). See Also 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 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 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 2025-06-19T07:18:37+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Show_a_Specific_Application?rev=1750317517&do=diff Show a Specific Application Action The Show a Specific Application action shows the specified application. This action will make a hidden application and its windows visible again, but it will not bring that application to the front or otherwise activate it. 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-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 2025-06-30T06:45:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/assistance/Accessibility_Permission_Problem?rev=1751265950&do=diff Accessibility Permission Problem Accessibility access to control your computer is required to use many features including selecting menu items, manipulating windows, pressing buttons, typed string triggers and the window switcher. You will need to enable Accessibility permissions for both Keyboard Maestro and Keyboard Maestro Engine. This is not something Keyboard Maestro can work around - it is a security feature of macOS. text/html 2017-03-16T06:45:49+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/assistance/Macro_Group_Inactive?rev=1489646749&do=diff Macro Group Inactive A macro group must be active for any of the macros it contains to be triggered. If it is inactive, the macros it contains will not run no matter what their trigger is. You control when a macro group is active by editing it, which you can do by double clicking on its entry in the Macro Group column (or just clicking on it if you are in Edit mode already). text/html 2021-10-13T01:55:10+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/assistance/Screen_Recording_Permission?rev=1634090110&do=diff Screen Recording Permission Screen Recording permission allows Keyboard Maestro to capture the image on your screen or in windows. This is used for actions like Find Image on Screen or Screen Capture. If you wish to use these actions in macOS Catalina or later you will need to enable the permission for Keyboard Maestro Engine in the System Preferences, Security & Privacy, Privacy, Screen Recording permissions. text/html 2017-09-06T04:54:12+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/Button?rev=1504673652&do=diff The Button condition looks for a standard Mac button in the front window. It can find a button with a name that is exactly a specified string, containing a specified string, or matching a specified regular expression. The condition can return true if: * a matching button exists. text/html 2019-07-08T05:17:47+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/condition/Found_Image?rev=1562563067&do=diff Found Image Condition The Found Image condition tests for a matching image on your screen(s) or windows. Example After an Action like this is executed, and an image was found, then the %FoundImage% token (v8+) will return the coordinates, size, and fuzz of the image. text/html 2023-09-20T08:33:27+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/WINDOWCOUNT?rev=1695198807&do=diff WINDOWCOUNT Function The WINDOWCOUNT() function returns the number of windows in the front application. See Also Actions * Manipulate a Window action * Move or Click Mouse action * See all Actions Functions * MENUBARHEIGHT() function * MOUSEBUTTON() function * MOUSEX() function * MOUSEY() function * SCREEN() function * SCREENCOUNT()] function] * [[function:SCREENVISIBLE|SCREENVISIBLE() function * SCREENINDEX() function text/html 2023-10-03T08:19:45+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Clipboard_History_Switcher?rev=1696321185&do=diff Clipboard History Switcher The Clipboard~~History~~Switcher is in essence a Clipboard Manager. Whenever you copy something from any app, the Keyboard Maestro Engine saves a copy of the System Clipboard at that time to the Clipboard History file. The text/html 2024-07-16T01:58:13+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Filters?rev=1721095093&do=diff Filters Keyboard Maestro includes a variety of filters that can be applied to either the system clipboard, Named~~Clipboards, or variables. For clipboards, the filters preserve style information to whatever degree is possible. Use the Filter action to apply filters. 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-03T08:09:48+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Icon_Chooser?rev=1696320588&do=diff Icon Chooser Keyboard Maestro includes an Icon Chooser and creator to allow you to select custom icons for your macro groups and macros. You can display the Icon Chooser by choosing the Window ➤ Icon Chooser menu. [ Icon Chooser Window ] Click on an image well for a macro or macro group (in Edit mode), and then click on an icon in the Icon Chooser to select it. text/html 2023-09-28T07:49:02+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Macro_Actions?rev=1695887342&do=diff Macro Actions A Macro executes a sequence of Macro~~Actions in order. There are many actions to choose from. Some simple actions, such as Restart Computer, require no other information and simply do their job, while other more complex actions, such as Select a Menu Item, require you to specify more information, such as a target application or menu name. You do this by editing the values for the action. text/html 2021-10-15T08:50:19+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Macro_Debugger?rev=1634287819&do=diff Macro Debugger Keyboard Maestro includes a built-in macro debugger which you can turn on by choosing the Status Menu ➤ Start Debugging menu or by using one of the Debugger actions. This will display the Macro Debugger window. [Macro Debugger] Once debugging, you can control whether new macros start paused or start running. The macro debugger shows all running macros, and what action they are currently executing (including showing nested actions). text/html 2019-06-18T05:53:48+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Macro_Examples?rev=1560837228&do=diff Macro Examples A typical simple Macro consists of a single Hot Key trigger, such as Control-A, together with a single action, such as the Insert Text by Typing Action that will “type my address” . For some real examples, see the forum topics: * List of Example Macros * Best Macro List * Best Examples of Keyboard Maestro Macros You can also use the Macro Library by choosing the text/html 2019-08-29T03:09:18+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Named_Clipboard_Switcher?rev=1567048158&do=diff Named Clipboard Switcher The Named~~Clipboard~~Switcher enables you to define any number of named clipboards which can be use to Cut or Copy into and Paste from in any application. To use the Named~~Clipboard~~Switcher you simply trigger the Named~~ text/html 2021-10-01T06:21:32+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Overview?rev=1633069292&do=diff Overview Keyboard~~Maestro will take your Macintosh experience to a new level. Keyboard Maestro enables you to create or record custom macro shortcuts that you can activate at any time. For example, your macros could help you navigate running applications or work with an unlimited number of clipboards. Best of all, every macro you create is available using simple keystrokes you choose or a variety of other triggers. The only limit to Keyboard Maestro is your imagination! text/html 2023-10-04T08:27:35+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Scripting?rev=1696408055&do=diff Scripting Executing Scripts The following Execute Script Actions are provided to execute a variety of script languages: * Execute an AppleScript * Execute an Automator Workflow * Execute a JavaScript For Automation * Execute JavaScript in Custom HTML Prompt * Execute a JavaScript in Browser * Execute a Shell Script * Execute Shortcut * Execute a Swift Script * Apply a BBEdit Text Factory to the Clipboard You can specify the script to be executed either by reference to a file or as t… text/html 2025-01-22T03:51:46+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Search_Strings?rev=1737517906&do=diff Search Strings Search Strings are filters which, in addition to the text you type, can include qualifiers that may be applied to searches for Macros and Actions in: * The Keyboard Maestro Editor search field. * A Smart Group. * A Trigger Macro by Name action. Keyboard Maestro will search for the text you type, and all of the below qualifiers that you specify, for matches in your list of macros. Each word is searched for separately (and in any order) unless you quote a phrase. 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 2024-09-28T07:01:01+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/trigger/Status_Menu?rev=1727506861&do=diff Status Menu Trigger The Status Menu trigger lets you add your macro to the Keyboard Maestro status menu so you can trigger it by selecting the macro name from the status menu. Keyboard Maestro displays a status menu in the right hand side of the menu bar, and it includes any active macros with the Status Menu trigger. Keyboard_Maestro will only display the Status Menu triggered macros that are active, so if your Macro is restricted to particular applications, then it will only appear in in th…