User Tools

Site Tools


Table of Contents

URL Schemes


Another way you can control Keyboard Maestro editor is using the “keyboardmaestroURL scheme, which supports the following formats:

Example Editor URL Command Description
keyboardmaestro:// Enter your username/serial number.
Edit a specific macro or macro group.
You may used either the Macro Name, or UUID.
keyboardmaestro://q=Activate Filter macros with this keyword.
keyboardmaestro://g=All%20Macros/q=Activate Select a macro group and filter macros with this keyword.
keyboardmaestro://a=Execute Filter actions with this keyword.
keyboardmaestro://c=All%20Actions/a=Execute Select action category and filter actions with this keyword.


You can trigger a macro (that is Active and Enabled) using the “kmtriggerURL scheme. The URL uses this format:

kmtrigger://macro=<Macro Name or UUID>[&<Trigger Value>]


  • <Macro Name or UUID> is either the Macro Name, OR, its UUID
  • <Trigger Value> is the optional Trigger Value
  • [ ] are not included. Used only to show optional parameters
  • & must precede the Trigger Value, if it is provided.

Note both Macro Name and Trigger Value must be URL encoded.

You can easily get the Trigger URL by clicking on the “Or by Script” Trigger option, and selecting “Or by URL”.

Example Trigger URL Command Description
kmtrigger://macro=Your%20Macro%20Name Using the Macro Name
kmtrigger://macro=224AA8CB-07EB-4C92-8201-68FED82B6E9F Using the Macro UUID
kmtrigger://macro=Your%20Macro%20Name&value=Your%20Trigger%20Value Using Macro Name with Trigger Value
kmtrigger://macro=224AA8CB-07EB-4C92-8201-68FED82B6E9F&value=Your%20Trigger%20Value Using Macro UUID with Trigger Value

The kmtrigger URL will only work on the local Mac, but you can use the Remote trigger to trigger macros with a URL even from remote locations via the Keyboard Maestro trigger server.

manual/URL_Schemes.txt · Last modified: 2023/09/12 22:34 by peternlewis