https://wiki.keyboardmaestro.com/ 2026-04-21T14:47:10+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 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-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-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 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 2015-07-04T01:57:26+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Open_or_Close_the_CD_Tray?rev=1435975046&do=diff The Open/Close CD Tray action opens the CD tray if it is closed, or closes it if it’s open. This is especially useful for keyboards that do not have an eject key. 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 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 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 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 2023-09-20T07:08:46+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/Style_Guide?rev=1695193726&do=diff Style Guide This Style Guide will document stylistic conventions to be followed on this wiki. Unlike the forum or other places, the wiki represents an relatively official view of Stairways Software and Keyboard Maestro (subject to the fact that is not actually moderated only by Stairways Software). As such, it needs to be somewhat more formal. 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-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 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 2022-12-03T16:19:42+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/trigger/Focused_Window?rev=1670084382&do=diff Focused Window Trigger The Focused Window trigger (v7.0+) executes the macro when the selected option occurs. The Options are: * The focused window changes. * The focused window title changes. * Occurs when either: * The front window 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-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 2014-10-18T02:17:09+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/Keyboard_Maestro_Markdown_Library?rev=1413598629&do=diff With these macros you can write Markdown with any text editor using the help of Keyboard Maestro. They use Keyboard Maestro's variables and user prompt actions. Whenever necessary you get a dialog where you can insert information, such as URLs, text for links, etc. Then when you click OK the text gets inserted into your document and you can continue writing.******** text/html 2023-09-05T04:18:46+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/Transition_From_QuicKeys?rev=1693887526&do=diff Transition from QuicKeys A lot of users are moving from QuicKeys to Keyboard Maestro as the last several major Mac OS X upgrades have left many QuicKeys users stranded without a macro solution. Keyboard Maestro strives to ensure it always uses legitimate Mac 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 2015-07-07T01:12:10+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Create_New_Image?rev=1436231530&do=diff The Create New Image action allows you to create an image of specified dimensions and color and save it to the system clipboard or a named clipboard. Select the color by clicking on the color square and choosing a new color from the Colors palette. Close the palette when you’ve finished. text/html 2021-10-15T08:48:16+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Debugger_Start?rev=1634287696&do=diff Macro Debugger Keyboard Maestro includes a built-in macro debugger which you can turn on by choosing Start Debugging from the Status Menu, or by using one of the various Debugger actions. [Macro Debugger] Debugger Actions * Debugger Start. * Debugger Finish. * text/html 2015-07-07T01:29:12+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/action/Draw_Shape_onto_Image?rev=1436232552&do=diff The Draw Shape onto Image action allows you to draw a line, rectangle or oval onto an image on the system clipboard or a named clipboard. Select the shape from the Draw a pop-up. Contextual options appear allowing you to choose parameters such as line color, fill color, thickness, corners, width and height as relevant. text/html 2023-09-20T08:37:52+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/function/TRUNC?rev=1695199072&do=diff TRUNC Function The TRUNC() function takes a number and returns the first integer that is equal to or closer to zero than the argument: TRUNC(5.5) === TRUNC(5.1) === TRUNC(5) === 5 TRUNC(-5.5) === TRUNC(-5.1) === TRUNC(-5) === -5 The TRUNC() function (v11.0+) takes a second optional parameter to indicate the number of digits to truncate to. text/html 2023-09-18T04:22:52+00:00 Anonymous (anonymous@undisclosed.example.com) https://wiki.keyboardmaestro.com/manual/Applications_Palette?rev=1695010972&do=diff Applications Palette The Applications Palette displays the currently running applications in a palette. [Applications Palette ] You can turn off the palette by clicking the close box, or you can turn it on or off in the Keyboard Maestro General preferences, or in the Keyboard Maestro status menu. 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 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-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: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-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 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-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 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 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 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