Keyboard Maestro Wiki

syntax - issue with code in list

peternlewis (peternlewis@undisclosed.example.com) — 2026-08-10T04:17:50+00:00

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

Whats_New - [Changed in 11.1]

peternlewis (peternlewis@undisclosed.example.com) — 2026-07-30T04:19:39+00:00

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

Window_Tokens - remove redundant links

peternlewis (peternlewis@undisclosed.example.com) — 2026-07-27T04:49:27+00:00

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%

Search_Strings

peternlewis (peternlewis@undisclosed.example.com) — 2026-07-20T03:05:11+00:00

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.

Assert - [Assert Action] Clarify meaning of "fire".

August (August@undisclosed.example.com) — 2026-06-13T08:25:27+00:00

Assert Action The Assert action (v8+) asserts that the criteria for the conditions are met and aborts the macro if not. If there are no conditions, then the assertion will always fire and will terminate the macro (v10.0+). Conditions See the Conditions section for further details.

Filters

peternlewis (peternlewis@undisclosed.example.com) — 2026-06-08T04:12:44+00:00

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.

Macros - [How To Create a Macro]

peternlewis (peternlewis@undisclosed.example.com) — 2026-05-26T02:23:25+00:00

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.

Stream_Deck - [Stream Deck]

peternlewis (peternlewis@undisclosed.example.com) — 2026-05-21T02:49:18+00:00

Stream Deck The Elgato Stream Deck is an external keypad/keyboard with a number of programmable buttons. Keyboard Maestro (v9.0+) supports the Stream Deck via an Stream Deck Plug In and the USB Device Key trigger, as well as a number of Stream Deck specific actions. Note that these instructions apply to the first-party Keyboard Maestro plugin, but there is also third-party

JSON - [JSON]

peternlewis (peternlewis@undisclosed.example.com) — 2026-05-13T02:47:43+00:00

JSON Keyboard Maestro includes comprehensive support for JSON (JavaScript Object Notation), which is a formalized lightweight data-interchange format. JSON objects consist of one of: * An array, surrounded by square brackets and with comma-separated values, eg

playground

August (August@undisclosed.example.com) — 2026-05-07T02:56:52+00:00

Playground

MIDI

August (August@undisclosed.example.com) — 2026-05-07T02:44:37+00:00

MIDI Trigger The MIDI trigger lets you execute a macro when a MIDI packet is received. You can trigger on specific notes, specific controller changes (v8+), or on any raw MIDI packet (v8+). If the Allow Recording (MIDI Learn) checkbox is on, and the note field has the text focus, and you press a MIDI note, then Keyboard Maestro will set the fields to the correct value for you; similarly for the controller field or the raw packet fields.

Gesture - [Gesture Trigger]

August (August@undisclosed.example.com) — 2026-05-07T02:37:45+00:00

Gesture Trigger The Gesture trigger (v8+) lets you execute a macro when you draw a shape using the mouse. The gesture consists of any sequence of one or more directional movements (horizontally, vertically, or diagonally). The gesture can require a set of modifiers to be pressed, or a specific mouse button to be pressed, and you can optionally make the gesture reversible (so, for example,

modern-syntax.png - created

peternlewis (peternlewis@undisclosed.example.com) — 2025-08-18T02:11:35+00:00

trigger-macro-by-name.png

peternlewis (peternlewis@undisclosed.example.com) — 2024-04-16T04:12:11+00:00

20240416-121010.png - created

peternlewis (peternlewis@undisclosed.example.com) — 2024-04-16T04:10:19+00:00

promptforsnippet.png - created

peternlewis (peternlewis@undisclosed.example.com) — 2023-09-13T08:52:56+00:00

searchreplace.png

peternlewis (peternlewis@undisclosed.example.com) — 2023-09-12T09:30:13+00:00

20230912-172820.png - removed

peternlewis (peternlewis@undisclosed.example.com) — 2023-09-12T09:29:08+00:00

savetoclippings.png

peternlewis (peternlewis@undisclosed.example.com) — 2023-06-28T01:48:00+00:00

km-periodic-trigger.png

peternlewis (peternlewis@undisclosed.example.com) — 2023-04-03T06:31:55+00:00