User Tools

Site Tools


Macro_Groups

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
Macro_Groups [2018/06/30 22:02]
JMichaelTX Basic rewrite, Add screenshots, more to come ...
Macro_Groups [2018/07/02 01:30]
JMichaelTX [Active When Applications Are Active] Correct App Triggers
Line 1: Line 1:
 +{{:​macro-group-icon.png?​nolink|}}
 ====== Macro Groups ====== ====== Macro Groups ======
  
-Keyboard Maestro organizes your macros ​into //Macro Groups// which are like folders of macros. Each Macro Group contains a number of macros.+Keyboard Maestro organizes your [[manual:​Macros|Macros]] ​into //Macro Groups// which are like folders of macros. Each Macro Group can contain zero or more [[manual:​Macros|Macros]]. ​ Subfolders are not allowed.
  
 The **most important function** of Macro Groups is to **control when the contained macros are active.** The **most important function** of Macro Groups is to **control when the contained macros are active.**
 +
 +In order to run (execute) a macro:
 +  * One of its [[Triggers|Triggers]] must be invoked
 +  * It can only be triggered if it is active
 +  * It can only be active if it meets all of the activation criteria, including being enabled
 +
 +Macro activation can be a challenging subject to master. ​ For a full discussion, please see [[Macro_Activation|Macro Activation]].
 +
 +===== Macro Group UI =====
 +
 +You create, edit, and manage //Macro Groups// in the Keyboard Maestro Editor.
 +
 +Controls are available at the bottom of the //Macro Groups// Panel, in the //File// menu, and via keyboard shortcuts.
 +
 +{{:​macro-group-ui-km8.png?​nolink|}}
 +
 +---
  
 ===== Setup Criteria (Basic) ===== ===== Setup Criteria (Basic) =====
  
-==== Active ​When Applications Are Active ====+When you create a new //Macro Group//, the setup for it will appear in the far right panel that normally contains the Macro Action List.  It looks like the below screenshot, with the popup options shown to the right. ​ There are many setup options, some representing combinations of options, so if you are not familiar with these, you may want to experiment with each setting to see the details for that option.
  
-A Macro Group can target or exclude specific applications,​ which means the macros it contains will only be active in those desired applications ((For example, you can have macros which are active only in Mail.app)).+{{:​macro-group-setup-km8-2.png?​nolink|}}
  
-By default, Macro Groups and their Macros are active in all applications,​ that is they are always ready to be triggered.+==== Active When Applications Are Active ====
  
-To have macros only active in specific applications,​ place the macros in a Macro Group, set it to be active in only specific applications and specify the desired applications.+* A Macro Group can target or exclude specific applications,​ which means the macros it contains will only be active in those desired applications ((For example, you can have macros which are active only in Mail.app)). 
 +* By default, Macro Groups and their Macros are active in all applications,​ that is they are always ready to be triggered. 
 +To have macros only active in specific applications,​ place the macros in a Macro Group, set it to be active in only specific applications and specify the desired applications.
  
 **By choosing the applications for which a macro is active**, you can control more applications with fewer conflicts. **By choosing the applications for which a macro is active**, you can control more applications with fewer conflicts.
Line 20: Line 40:
 * For application-specific macros, use **Available in these applications**. * For application-specific macros, use **Available in these applications**.
 * To exclude certain applications,​ use **Available except in these applications**. * To exclude certain applications,​ use **Available except in these applications**.
-* For Application ​Triggered macros (eg Launch/​Activate/​Quit),​ use **Available in all applications**.+* For Macros triggered by one of the [[trigger:Application|Application Triggers]]:​ 
 +  * Use **Available in all applications** ​to be available to an app Launches trigger. 
 +  * Use **Available in these applications** to be available to Activates or Quits triggers. 
 +  * The [[trigger:​Application|App Activates Trigger]] will fire for //both// //Available in **all** applications//​ and //Available in **these** applications//​
 * For Login or Public Web triggered macros, use **Available in all applications**. * For Login or Public Web triggered macros, use **Available in all applications**.
  
Line 31: Line 54:
 * If you want to use several macros in succession, configure the Macro Group to be **Activated/​deactivated** or to **Show/hide a palette**. * If you want to use several macros in succession, configure the Macro Group to be **Activated/​deactivated** or to **Show/hide a palette**.
 * If you want to have a global palette of related macros, configure the Macro Group to **Show a palette**. * If you want to have a global palette of related macros, configure the Macro Group to **Show a palette**.
 +
 +For more details see the [[#​Setup_Criteria_Advanced|Advanced Setup]] at the bottom of this page.
  
 --- ---
Macro_Groups.txt · Last modified: 2024/02/26 01:46 by peternlewis