User Tools
manual:Macros
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
|
manual:Macros [2017/08/23 05:00] peternlewis [How To Create a Macro] |
manual:Macros [2019/06/14 00:29] peternlewis [How To Create 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 ===== | ||
| + | |||
| + | You edit a macro by selecting it and ensure you are in Edit mode. Double clicking on the macro will turn on Edit mode. | ||
| + | |||
| + | You can select a macro by name by choosing [[Menus#Select_Macro_by_Name|Select Macro By Name]] from the [[Menus#View|View menu]] | ||
| ===== How to Run a Macro ===== | ===== How to Run a Macro ===== | ||
| Line 64: | Line 69: | ||
| Activation/Deactivation or a Macro Group is a dynamic process, automatically set by the Keyboard Maestro Engine as your Mac's environment changes in real time. For details, see [[:Macro Activation]] | Activation/Deactivation or a Macro Group is a dynamic process, automatically set by the Keyboard Maestro Engine as your Mac's environment changes in real time. For details, see [[:Macro Activation]] | ||
| - | You run a macro by invoking one of its triggers. | + | 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. | ||
| 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 what a specific USB device is attached. | ||
| Line 80: | Line 87: | ||
| ===== How to Import Macros ===== | ===== How to Import Macros ===== | ||
| - | You may want to import Macro(s) you have downloaded from other sources, like the [Keyboard Maestro Forum](https://forum.keyboardmaestro.com/). | + | You may want to import Macro(s) you have downloaded from other sources, like the [Keyboard Maestro Forum](https://forum.keyboardmaestro.com/). |
| You may use any of the following to import the macro file (`.kmmacros`): | You may use any of the following to import the macro file (`.kmmacros`): | ||
| - | * Double-click on the macro file in the Mac Finder | + | * Double-click on the macro file in the Mac Finder. |
| - | * In the Keyboard Maestro app, goto _File > Import Macros..._ and select the macro file | + | * In the Keyboard Maestro app, goto _File > Import Macros..._ and select the macro file. |
| - | * In some browsers, click on the downloaded file icon at the bottom of the browser window | + | * In some browsers, click on the downloaded file icon at the bottom of the browser window. |
| :!: Note that the macro file (`.kmmacros`) may contain one or more macros, and will also create the Macro Group if it does _not_ exist in your configuration. Otherwise, it will put the Macro in your existing Macro Group. | :!: Note that the macro file (`.kmmacros`) may contain one or more macros, and will also create the Macro Group if it does _not_ exist in your configuration. Otherwise, it will put the Macro in your existing Macro Group. | ||
| - | ==== Import Macros in Safe Mode ==== | + | ==== Import Macros Safely ==== |
| - | (!) You should be aware that the macros will be imported in the same state (enabled/disabled), triggers, and macro group that they were saved in. **This could result in the imported Macro being triggered (executed) as soon as it is imported.** If you are at all uncertain about the source of the macros, hold all the modifiers (Command, Control, Option, Shift) down when importing the macros and the macro will be imported disabled. | + | (!) You should be aware that the macros will be imported in the same state, triggers, and macro group that they were saved in. By default, macros are imported disabled unless you hold the Option key down. **This could result in the imported Macro being triggered (executed) as soon as it is imported.** If you are at all uncertain about the source of the macros, ensure you import the macros disabled or hold choose choose [[Menus#File_Import_Macros_Disabled|Import Macros Disabled]] from the [[Menus#File|File menu]]. |
| See also the [[Macro Groups]], [[Macro Actions]], [[Macro Triggers]], [[:Macro_Activation]], [[Macro Examples]], [[Macro Library]] and [[Recording]] sections. | See also the [[Macro Groups]], [[Macro Actions]], [[Macro Triggers]], [[:Macro_Activation]], [[Macro Examples]], [[Macro Library]] and [[Recording]] sections. | ||
manual/Macros.txt · Last modified: 2023/09/28 02:11 by peternlewis
Page Tools
