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
Macro_Groups [2018/07/02 01:11]
JMichaelTX [Setup Criteria (Basic)] Add comments about screenshot.
Macro_Groups [2020/02/05 19:28] (current)
JMichaelTX [3. Other Examples] Add Mail.app example and link
Line 3: Line 3:
  
 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. 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.
 +
 +===== Purpose =====
 +
 +* Provide a folder-like container for related Macros.
 +* Control when those Macros are active, and available to be triggered.
 +* Provide for displaying a [[manual:​Palettes|Palette]] of Macros that can like a custom toolbar for your apps, or even across all or multiple apps.
 +
 +===== Controlling When Macros are Active =====
  
 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.**
Line 12: Line 20:
  
 Macro activation can be a challenging subject to master. ​ For a full discussion, please see [[Macro_Activation|Macro Activation]]. Macro activation can be a challenging subject to master. ​ For a full discussion, please see [[Macro_Activation|Macro Activation]].
 +
 +===== Displaying a Palette =====
 +
 +* Each Macro Group can be displayed as a palette. The macro group can be global to all applications,​ or specific to any subset of applications. It can be toggled on and off with a hot key (or a status menu selection or from the Global Macro Palette) or it can be displayed for a single action. Actions can hide or show the macro group palettes.
 +* For details on setup of Palettes, see **[[manual:​Palettes|Palettes]]**.
  
 ===== Macro Group UI ===== ===== Macro Group UI =====
Line 19: Line 32:
 Controls are available at the bottom of the //Macro Groups// Panel, in the //File// menu, and via keyboard shortcuts. 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|}}+{{:​macro-group-ui-km9.png?​nolink|}}
  
 --- ---
Line 31: Line 44:
 ==== Active When Applications Are Active ==== ==== Active When Applications Are Active ====
  
-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)). +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. 
-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.
- +
-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 42: Line 53:
 * 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 53: Line 67:
 * 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**.
 +* If you want the macros to be always active, but to show a palette only some of the time, choose one of the **Always activated and shows…** variants.
  
 For more details see the [[#​Setup_Criteria_Advanced|Advanced Setup]] at the bottom of this page. For more details see the [[#​Setup_Criteria_Advanced|Advanced Setup]] at the bottom of this page.
Line 92: Line 107:
  
 * Mail.app that inserts common text messages. * Mail.app that inserts common text messages.
 +* [Macro Group Active Only for Mail.app Compose Window](https://​forum.keyboardmaestro.com/​t/​app-and-window-specific-macro-groups/​16869/​2)
 * BBEdit and Xcode that inserts code chunks or duplicate lines or add #include headers. * BBEdit and Xcode that inserts code chunks or duplicate lines or add #include headers.
 * Safari that configure windows or enter information. * Safari that configure windows or enter information.
Macro_Groups.1530508313.txt.gz · Last modified: 2018/07/02 01:11 by JMichaelTX