User Tools
manual:Scripting
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision | Next revision Both sides next revision | ||
|
manual:Scripting [2018/07/02 19:38] JMichaelTX Add setup options table |
manual:Scripting [2019/06/20 22:26] peternlewis |
||
|---|---|---|---|
| Line 213: | Line 213: | ||
| See the Keyboard Maestro AppleScript dictionary for more information. | See the Keyboard Maestro AppleScript dictionary for more information. | ||
| - | ===== URL Schemes ===== | ||
| - | |||
| - | ==== Editor ==== | ||
| - | |||
| - | Another way you can control Keyboard Maestro editor is using the "`keyboardmaestro`" URL scheme, which supports the following formats: | ||
| - | |||
| - | ^ Example Editor URL Command ^ Description ^ | ||
| - | | `keyboardmaestro://u=support%40stairways.com/s=ABCDEFGH0123456789` | enter your username/serial number. | | ||
| - | | `keyboardmaestro://m=Activate%20Application%20Switcher`\\ `keyboardmaestro://m=D2F427A1-51E3-4719-820B-4C25B6FF7329` | 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. | | ||
| - | |||
| - | --- | ||
| - | |||
| - | ==== Triggers ==== | ||
| - | |||
| - | You can trigger a macro (that is Active and Enabled) using the "`kmtrigger`" URL scheme. The URL uses this format: | ||
| - | |||
| - | `kmtrigger://macro=<Macro Name or UUID>[&<Trigger Value>]` | ||
| - | |||
| - | where | ||
| - | * `<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". | ||
| - | |||
| - | {{:manual:km-7.3-macro-trigger-url-setup.png?nolink|}} | ||
| - | |||
| - | {{:manual:km-7.3-macro-trigger-url-results.png?nolink|}} | ||
| - | |||
| - | ^ 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 | | ||
manual/Scripting.txt ยท Last modified: 2023/10/04 04:27 by peternlewis
Page Tools
