https://wiki.keyboardmaestro.com/ 2026-06-10T01:25:30+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 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-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 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-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-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 2026-05-26T02:23:25+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Macros?rev=1779762205&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 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 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 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 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: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 2026-06-08T04:12:44+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Filters?rev=1780891964&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.