User Tools

Site Tools


manual: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
manual:Macro_Groups [2017/08/23 02:47]
peternlewis
manual:Macro_Groups [2023/09/28 00:30] (current)
peternlewis
Line 8: Line 8:
  
 Macro~~Groups can be displayed as palettes, allowing you to create your own custom toolbars which can be configured with a variety of themes and to appear under the mouse. Macro~~Groups can be displayed as palettes, allowing you to create your own custom toolbars which can be configured with a variety of themes and to appear under the mouse.
 +
 +Macro~~Groups can also be displayed in the menu bar, including information that is displayed and dynamically updated, as well as offering another way to trigger macros.
  
 If you are syncing your macros with another Mac, Macro~~Groups can be disabled specifically on this Mac. If you are syncing your macros with another Mac, Macro~~Groups can be disabled specifically on this Mac.
Line 15: Line 17:
 {{ macros.png?​nolink&​937 |Macros Window }} {{ macros.png?​nolink&​937 |Macros Window }}
  
-Now click the BUTTON{{{+}}} button ​below the Macro~~Groups list.+Now click the BUTTON{{{+}}} button ​at the bottom of the Macro~~Groups list.
  
-{{ macrogroupeditor.png?​937x512 ​|Macro Group Editor }}+{{ macrogroupeditor.png?​nolink&​937x624 ​| Macro Group Editor }}
  
 Enter the name of your new Macro~~Group. Enter the name of your new Macro~~Group.
Line 62: Line 64:
 To have Macros that are active and displayed in a macro palette after you trigger the Macro Group, set the Macro Group to “Shows/​hides a palette when”. The Macros in the Macro Group will be displayed in a floating Macro Palette and enabled when you trigger the Macro Group and will remain displayed until you trigger the Macro Group again. You could use this to create a set of related actions that do not even need a Hot Key. For example, you could have a group of macros to align objects in a CAD application,​ so when you press Command-Control-A,​ a palette of these macros is displayed and you can click various alignment options (distribute left-right, align top edges) and then close the palette by pressing Command-Control-A a second time. To have Macros that are active and displayed in a macro palette after you trigger the Macro Group, set the Macro Group to “Shows/​hides a palette when”. The Macros in the Macro Group will be displayed in a floating Macro Palette and enabled when you trigger the Macro Group and will remain displayed until you trigger the Macro Group again. You could use this to create a set of related actions that do not even need a Hot Key. For example, you could have a group of macros to align objects in a CAD application,​ so when you press Command-Control-A,​ a palette of these macros is displayed and you can click various alignment options (distribute left-right, align top edges) and then close the palette by pressing Command-Control-A a second time.
  
-To have Macros that are always ​active and displayed in a palette, set the Macro Group to “Shows a palette until”. The Macros in the Macro Group will be displayed in a floating Macro Palette and enabled. The palette will close when (if) you trigger the Macro Group and will remain closed (and the macros disabled) until you trigger the Macro Group again. You could use this to create a set of related actions that do not even need a Hot Key and that are available in a Macro Palette. You could make the Macro Group available only in a specific application so that it appears only in that application. For example, you could have a group of macros to align objects in a CAD application,​ and have the Macro Group available (and hence the palette displayed) only in the CAD application.+To have Macros that are initially ​active and displayed in a palette, set the Macro Group to “Shows a palette until”. The Macros in the Macro Group will be displayed in a floating Macro Palette and enabled. The palette will close when (if) you trigger the Macro Group and will remain closed (and the macros disabled) until you trigger the Macro Group again. You could use this to create a set of related actions that do not even need a Hot Key and that are available in a Macro Palette. You could make the Macro Group available only in a specific application so that it appears only in that application. For example, you could have a group of macros to align objects in a CAD application,​ and have the Macro Group available (and hence the palette displayed) only in the CAD application.
  
-Even if the macros are displayed in a Palette, the macros can still have Hot~~Key (or any other kind of) triggers which will be available whenever the macro group is active ​(in this case, whenever the palette is displayed).+Whether ​the macros are displayed in a Palette ​or not, the macros can still have Hot~~Key (or any other kind of) triggers which will be available whenever the macro group is active.
  
-You can disable or enable a macro group by selecting it and clicking ​the BUTTON{{{✓}}} button at the bottom of the Groups list.  If a Macro~~Group ​is disabled or inactive for any reason, all its contained Macros will be inactive.  ​You can disable or enable a Macro Group using the Set Macro Enable actionyou can show in a palette or activate a Macro Group using the Show Macro Group or Activate Macro Group actions.+With the previous three settings, ​the macros are active if and only if the palette ​is displayed.  ​The final three options are the same except that the macros are always activeso they are always available to be triggered by another means, and sometimes by the palette.
  
-You can change ​the targeting of an existing group by selecting it in the Groups list and clicking ​the BUTTON{{{Edit}}} buttonor by double clicking ​the macro group.+You can also display ​the Macro Group in the menu bar. You can select which icon to display ​and what title text to show in the macro barboth of which can be dynamically updated allowing you to show information like stock prices, word counts, reminders, time, etc. For example, you could have an icon and time that showed how long you had been working without a break. The menu can include all the macros in the group, or just those macros with the [[trigger:​Group_Status_Menu|Group Status Menu]] trigger.
  
-You can disable a Macro Group from AppleScript with:+You can change the targeting of an existing group by selecting it in the Groups list and ensuring you are in Edit mode by clicking the BUTTON{{{Edit}}} button, or by double clicking the macro group.
  
-<code applescript>​ +You can disable or enable a macro group by selecting it and clicking the BUTTON{{{✓}}} button at the bottom of the Groups list.  If a Macro~~Group is disabled or inactive for any reason, all its contained Macros will be inactive. ​ You can disable ​or enable ​a Macro Group using the Set Macro Enable action, you can show in a palette or activate a Macro Group using the Show Macro Group or Activate Macro Group actions.
-tell application "​Keyboard Maestro"​ +
-  setMacroEnable "Macro Group Name or UID" with/​without ​enable +
-end tell +
-</​code>​+
  
-You can start editing a Macro or Macro Group from AppleScript with:+Disabled ​Macro Groups can optionally be hidden using the choosing the [[Menus#​Hide_Disabled_Macro_Groups|View ➤ Hide Disabled ​Macro Groups menu]].
  
-<code applescript>​ +You can control ​or right click on a macro group to:
-tell application "​Keyboard Maestro"​ +
-  editMacro "Macro Group Name or UID" +
-end tell +
-</​code>​+
  
-You can get the list of currently selected macros ​or macro groups with:+* Cut, Copy, Duplicate or Delete ​the Macro Group. 
 +* Copy the Macro Group as XML, or its UUID. 
 +* Copy the Macro Group as a [[action:Set_Macro_or_Group_Enable|Set Macro or Group Enable]] or [[action:​Activate_Macro_Group|Toggle Macro Group]] action. 
 +* Disable or Rename the Macro Group. 
 +* Export the entire Macro Group.
  
-<code applescript>​ +The Keyboard Maestro ​editor has full AppleScript support so you can manipulate macro groups in many ways via AppleScript. ​ See [[:​Scripting_the_Keyboard_Maestro_editor#​Macro_Groups|Scripting the Keyboard Maestro editor]].
-tell application "Keyboard Maestro+
-  selectedMacros +
-end tell +
-</​code>​+
  
-To delete a Macro~~Group,​ select the macro group and then press Command-Delete or click the BUTTON{{{-}}} button at the bottom of the Groups list.+To delete a Macro~~Group,​ select the macro group and then press Command-Delete or click the BUTTON{{{-}}} button at the bottom of the Groups list. Like all actions, you can Undo this if you make a mistake.
  
 You cannot delete or rename or disable the Global~~Macro~~Group. ​ If you want to control when some of the macros within the Global Macro Group are active, make a new macro group and drag those macros to it. You cannot delete or rename or disable the Global~~Macro~~Group. ​ If you want to control when some of the macros within the Global Macro Group are active, make a new macro group and drag those macros to it.
- 
manual/Macro_Groups.1503470829.txt.gz · Last modified: 2017/08/23 02:47 by peternlewis