User Tools
manual:Editor_Window
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:Editor_Window [2019/06/21 01:39] peternlewis |
manual:Editor_Window [2019/12/31 14:46] JMichaelTX CHG numeric symbol locators |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== Editor Window ====== | ====== Editor Window ====== | ||
| - | To edit your macros, launch the Keyboard Maestro application. It will display one or more Editor Windows. | + | To edit your macros, launch the Keyboard Maestro application. It will display one or more Editor Windows. If you close the last editor window, the Keyboard Maestro application will quit, but the Keyboard Maestro Engine will continue running to perform your macros. Normally you only launch the Keyboard Maestro editor application when you want to change your macros, and leave only the Keyboard Maestro Engine running normally. |
| You can create a new editor window by choosing the [[Menus#New_Editor_Window|File ➤ New Editor Window menu]]. | You can create a new editor window by choosing the [[Menus#New_Editor_Window|File ➤ New Editor Window menu]]. | ||
| Line 7: | Line 7: | ||
| {{ editor-window-marked.png?nolink&937x553 | Editor Window }} | {{ editor-window-marked.png?nolink&937x553 | Editor Window }} | ||
| - | One the Group column (1) on the left, you have the a list of all your [[Smart_Groups|Smart Groups]] and [[Macro_Groups|Macro Groups]]. Smart Groups are saved searches of macros. | + | One the Group column 1️⃣ on the left, you have the a list of all your [[Smart_Groups|Smart Groups]] and [[Macro_Groups|Macro Groups]]. Smart Groups are saved searches of macros. |
| - | In the Macro column (2) in the middle are the [[Macros]]. Macros are the primary way you describe what you want Keyboard Maestro to do. This column will list all the macros matched by any selected //Smart Groups//, and all the macros contained by any selected //Macro Groups//. You can filter the list to find specific macros by using the Search Field (3). | + | In the Macro column 2️⃣ in the middle are the [[Macros]]. Macros are the primary way you describe what you want Keyboard Maestro to do. This column will list all the macros matched by any selected //Smart Groups//, and all the macros contained by any selected //Macro Groups//. You can filter the list to find specific macros by using the Search Field 3️⃣. |
| - | In the right column (3) you have a description of the selected macro. When in Edit mode (which you can toggle with the BUTTON{{{Edit}}} button (5)), this is where you will edit your Smart Group searches, your Macro Group configurations, and your Macros. | + | In the right column 3️⃣ you have a description of the selected macro. When in Edit mode (which you can toggle with the BUTTON{{{Edit}}} button 5️⃣, this is where you will edit your Smart Group searches, your Macro Group configurations, and your Macros. |
| - | At the bottom of each column (4) it a set of buttons to create (BUTTON{{{+}}}), delete (BUTTON{{{-}}}) or enable/disable (BUTTON{{{✓}}}) their respective groups, macros or actions. There is an extra BUTTON{{{⊕}}} button at the far left to create a Smart Group. | + | At the bottom of each column 4️⃣ it a set of buttons to create (BUTTON{{{+}}}), delete (BUTTON{{{-}}}) or enable/disable (BUTTON{{{✓}}}) their respective groups, macros or actions. There is an extra BUTTON{{{⊕}}} button at the far left to create a Smart Group. |
| - | Next to the BUTTON{{{Edit}}} button (5) are buttons to set a timeout for a specific action, to try the selected actions, and the enter recording mode to add new actions by recording what you are doing (moving and clicking the mouse, selecting menus, moving and resizing windows, typing characters, etc). | + | Next to the BUTTON{{{Edit}}} button 5️⃣ are buttons to set a timeout for a specific action, to try the selected actions, and the enter recording mode to add new actions by recording what you are doing (moving and clicking the mouse, selecting menus, moving and resizing windows, typing characters, etc). |
| Along the top of the window is the toolbar. From left to right the buttons let you: | Along the top of the window is the toolbar. From left to right the buttons let you: | ||
| Line 24: | Line 24: | ||
| * Select the most recently edited macro. | * Select the most recently edited macro. | ||
| * Run the selected macro. | * Run the selected macro. | ||
| - | * Search for macros. The Macros column (2) will be filtered to only matching macros, and any parts of the macro that match will be highlighted in striped blue in the detail column (3). | + | * Search for macros. The Macros column 2️⃣ will be filtered to only matching macros, and any parts of the macro that match will be highlighted in striped blue in the detail column 3️⃣. |
| When you are in Edit Mode, and you select a Smart Group, you can edit its search settings. | When you are in Edit Mode, and you select a Smart Group, you can edit its search settings. | ||
| Line 30: | Line 30: | ||
| {{ smart-group-marked.png?nolink&937x465 | Smart Group Editor }} | {{ smart-group-marked.png?nolink&937x465 | Smart Group Editor }} | ||
| - | You can adjust the name of the Smart Group (1), and adjust its [[Search_Strings|Search Strings]] (2). | + | You can adjust the name of the Smart Group 1️⃣, and adjust its [[Search_Strings|Search Strings]] 2️⃣. |
| You can add another Search String by clicking the green BUTTON{{{+}}} button. | You can add another Search String by clicking the green BUTTON{{{+}}} button. | ||
| Line 42: | Line 42: | ||
| For a Macro to be available to trigger, it must be enabled and its parent Macro Group must be enabled, and active. The configurations for the Macro Group control when it will be active, and thus when the macros it contains will be active (available to be triggered and executed). | For a Macro to be available to trigger, it must be enabled and its parent Macro Group must be enabled, and active. The configurations for the Macro Group control when it will be active, and thus when the macros it contains will be active (available to be triggered and executed). | ||
| - | You can adjust whether the macro group is enabled (2), whether it is only active in some specific applications (3) (ie, when they are at the front, and their menu bar is showing), whether it is only active in specific windows (4), whether it is only active when you explicitly toggle it on or off, and whether and how it shows a palette containing its macros (5). | + | You can adjust whether the macro group is enabled 2️⃣, whether it is only active in some specific applications 3️⃣ (ie, when they are at the front, and their menu bar is showing), whether it is only active in specific windows (4), whether it is only active when you explicitly toggle it on or off, and whether and how it shows a palette containing its macros (5). |
| When you are in Edit Mode and you select a Macro, you can edit its behaviour. | When you are in Edit Mode and you select a Macro, you can edit its behaviour. | ||
| Line 48: | Line 48: | ||
| {{ macro-editor-marked.png?nolink&937x694 | Macro Editor }} | {{ macro-editor-marked.png?nolink&937x694 | Macro Editor }} | ||
| - | You can adjust the name of the Macro (1), and whether it is enabled (2) (a macro must be enabled for it to be available to be triggered (executed) - its parent macro group must also be enabled and active). | + | You can adjust the name of the Macro 3️⃣, and whether it is enabled 3️⃣ (a macro must be enabled for it to be available to be triggered (executed) - its parent macro group must also be enabled and active). |
| - | A macro consists of a set of triggers (3). When it is active, if any of these [[Macro_Triggers|triggers]] happen, then the macro executes the [[Macro_Actions|actions]] (4). | + | A macro consists of a set of triggers 3️⃣. When it is active, if any of these [[Macro_Triggers|triggers]] happen, then the macro executes the [[Macro_Actions|actions]]. |
| You can add a trigger by clicking and holding on the green BUTTON{{{+}}} button and selecting the kind of trigger you would like to use. | You can add a trigger by clicking and holding on the green BUTTON{{{+}}} button and selecting the kind of trigger you would like to use. | ||
| Line 58: | Line 58: | ||
| Other triggers, like the [[trigger:Typed_String|Typed String]] trigger, require you to configure more details about when the trigger should happen, such as the specific string you have to type to trigger the macro. For the macro shown, the macro will be triggered when you type the string “=-=”. | Other triggers, like the [[trigger:Typed_String|Typed String]] trigger, require you to configure more details about when the trigger should happen, such as the specific string you have to type to trigger the macro. For the macro shown, the macro will be triggered when you type the string “=-=”. | ||
| - | When a macro is triggered, it will execute the actions you have specified (4). You can add an action by clicking on the green BUTTON{{{+}}} button | + | When a macro is triggered, it will execute the actions you have entered in the Macro Detail Panel 3️⃣. |
| + | |||
| + | **You can add a new action by any of the following:** | ||
| + | - Click the BUTTON{{{New Action}}} button | ||
| + | - Click the BUTTON{{{+}}} button at the bottom of the Macro Detail Panel 3️⃣ to display the list of actions | ||
| + | - Choose the [[Menus#Insert_Action_by_Name|Edit ➤ Insert Action By Name menu]] | ||
| + | - Press <kbd>⌘⌃A</kbd> to show a Insert Action By Name Popup | ||
| + | - Choose from the [[Menus#Insert_Action|Edit ➤ Insert Action menu]] | ||
| + | |||
| + | In the displayed macro, the action uses the [[token:SystemClipboard|%SystemClipboard%]] token to read the system clipboard, and will then insert it by typing (rather than the normal pasting for the System Clipboard). This can be useful for cases where you are disallowed from pasting for some reason. | ||
| + | |||
manual/Editor_Window.txt · Last modified: 2023/09/27 04:56 by peternlewis
Page Tools
