User Tools

Site Tools


manual:Scripting

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
manual:Scripting [2018/07/02 19:38]
JMichaelTX Add setup options table
manual:Scripting [2019/07/15 03:33] (current)
peternlewis [Controlling Keyboard Maestro via Scripting]
Line 213: Line 213:
 See the Keyboard Maestro AppleScript dictionary for more information. See the Keyboard Maestro AppleScript dictionary for more information.
  
-===== URL Schemes ​=====+===== Controlling Keyboard Maestro Engine via Scripting ​=====
  
-==== Editor ====+You can adjust Keyboard Maestro Engine windows with:
  
-Another way you can control ​Keyboard Maestro ​editor is using the "`keyboardmaestro`" ​URL schemewhich supports the following formats:+<code applescript>​ 
 +tell application "Keyboard Maestro ​Engine" 
 +    set bounds of window ​"Clipboard History Switcher"​ to {1000, 50, 20001200} 
 +end tell 
 +</​code>​
  
-^ 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.1530574732.txt.gz · Last modified: 2018/07/02 19:38 by JMichaelTX