User Tools

Site Tools


manual:Macros

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
Next revision Both sides next revision
manual:Macros [2017/09/03 22:58]
peternlewis [How to Import Macros]
manual:Macros [2019/06/14 00:33]
peternlewis [How to Run a Macro]
Line 1: Line 1:
 ====== Macros ====== ====== Macros ======
  
-_**Macros**_ are used to automate your [[https://​en.wikipedia.org/​wiki/​Workflow | workflow]], procedure, or process on your Mac. Macros, also known as Shortcuts, 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.+_**Macros**_ are used to automate your workflow, procedure, or process on your Mac. Macros, also known as Shortcuts, 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.
  
 A _**Macro**_ consists of: A _**Macro**_ consists of:
Line 37: Line 37:
 You can share a macro to the Keyboard Maestro Forum, or to a friend via Mail or Messages using the sharing button at the top of the [[Windows#​Macros_Window|Macros window]]. You can share a macro to the Keyboard Maestro Forum, or to a friend via Mail or Messages using the sharing button at the top of the [[Windows#​Macros_Window|Macros window]].
  
-You can disable or enable a macro by selecting it and clicking the BUTTON{{{✓}}} button at the bottom of the Macros list.  You can also disable or enable a Macro using the Set Macro Enable action, or from AppleScript with:+You can disable or enable a macro by selecting it and clicking the BUTTON{{{✓}}} button at the bottom of the Macros list.  You can also disable or enable a Macro using the [[action:​Set_Macro_or_Group_Enable|Set Macro Enable]] action, or from AppleScript with:
  
 <code applescript>​ <code applescript>​
Line 54: Line 54:
  
 The Keyboard Maestro editor has full AppleScript support so you can manipulate macros in many ways via AppleScript. The Keyboard Maestro editor has full AppleScript support so you can manipulate macros in many ways via AppleScript.
- 
 ===== How to Edit a Macro ===== ===== How to Edit a Macro =====
  
Line 63: Line 62:
 ===== How to Run a Macro ===== ===== How to Run a Macro =====
  
-In order to run (execute or trigger) a macro must be active:+In order to run (execute or trigger) a macro it must be active, that is:
   * It is enabled   * It is enabled
   * It’s containing Macro Group is enabled   * It’s containing Macro Group is enabled
Line 72: Line 71:
 You can try out a macro from the Keyboard Maestro by clicking the BUTTON{{{▶︎}}} Run button at the top of the editor window. ​ Of course, macros are often sensitive to the context, so it may not be appropriate to run them directly from the editor. You can try out a macro from the Keyboard Maestro by clicking the BUTTON{{{▶︎}}} Run button at the top of the editor window. ​ Of course, macros are often sensitive to the context, so it may not be appropriate to run them directly from the editor.
  
-Generally, you run a macro by invoking one of its triggers.+Generally, you run a macro by invoking ​any one of its triggers.
  
-You execute a macro’s action sequence by invoking one of its Macro~~Triggers that you have defined (such as pressing a hot key if you have configured a hot key trigger). ​ For some triggers, no action is required on your part.  For example, the macro could be triggered at a specific time, or what a specific USB device is attached.+You execute a macro’s action sequence by invoking one of its Macro~~Triggers that you have defined (such as pressing a hot key if you have configured a hot key trigger). ​ For some triggers, no action is required on your part.  For example, the macro could be triggered at a specific time, or when a specific USB device is attached.
  
-You can also trigger macros by name using the [[/​action/​Trigger_Macro_by_Name|Trigger Macro by Name action]], which in turn can be in a macro and triggered any way you desire.+You can also trigger macros by name using the [[/​action/​Trigger_Macro_by_Name|Trigger Macro by Name]] ​action, which in turn can be in a macro and triggered any way you desire.
  
 You can trigger a macro using the kmtrigger: scheme with a URL like `kmtrigger://​macro=MacroName&​value=Value` (the value is accessible via the CODE{{{%TriggerValue%}}} Text~~Token). You can trigger a macro using the kmtrigger: scheme with a URL like `kmtrigger://​macro=MacroName&​value=Value` (the value is accessible via the CODE{{{%TriggerValue%}}} Text~~Token).
  
-If the web server is enabled for remote access, you can trigger a macro remotely after logging in using a web browser or the Keyboard Maestro Control iPhone application.+If the web server is enabled for remote access, you can trigger a macro remotely after logging in using a web browser or the Keyboard Maestro Control iPhone application.  Alternatively,​ you can use the [[trigger:​Remote|Remote]] trigger and trigger your macro using a URL from remotely via our trigger server.
  
 You can also trigger a macro using AppleScript or another scripting language (select the “Or by script” entry to display script code in various languages such as AppleScript or Perl). You can also trigger a macro using AppleScript or another scripting language (select the “Or by script” entry to display script code in various languages such as AppleScript or Perl).
manual/Macros.txt · Last modified: 2023/09/28 02:11 by peternlewis