This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Last revision Both sides next revision | ||
manual:Editor_Window [2021/10/11 22:25] peternlewis [Main Elements] |
manual:Editor_Window [2023/09/27 04:56] peternlewis |
||
---|---|---|---|
Line 7: | Line 7: | ||
===== Window Elements ===== | ===== Window Elements ===== | ||
- | {{ editor-window-marked.png?nolink&937x553 | Editor Window }} | + | {{ editor-window-marked.png?nolink&937x589 | Editor Window }} |
==== Main Elements ==== | ==== Main Elements ==== | ||
+ | |||
- **//Groups Column//** 1️⃣ (on the left) | - **//Groups Column//** 1️⃣ (on the left) | ||
- | * List of all of the [[Macro_Groups|Macro Groups]] and [[Smart_Groups|Smart Groups]] (shown at top) in your account. | + | * List of all of the [[Smart_Groups|Smart Groups]] (top) and [[Macro_Groups|Macro Groups]] in your account. |
* Smart Groups are saved searches of macros. | * Smart Groups are saved searches of macros. | ||
- **//Macros Column//** 2️⃣ (in the middle) | - **//Macros Column//** 2️⃣ (in the middle) | ||
- | * List All of the [[Macros]] in the Selected [[Macro_Groups|Macro Group]]. | + | * List All of the [[Macros]] in the selected groups. |
* Macros are the primary way you describe what you want Keyboard Maestro to do. | * Macros are the primary way you describe what you want Keyboard Maestro to do. | ||
- | * You can filter the list to find specific macros by using the Search Field (upper right corner). | + | * You can filter the list to find specific macros by using the Search Field 7️⃣ (upper right corner). |
- **_Details Column_** 3️⃣ (on the right) | - **_Details Column_** 3️⃣ (on the right) | ||
- | - Display or Edit the details of the selected Macro, Macro Group, or Smart Group. | + | * Display or Edit the details of the selected Macro, Macro Group, or Smart Group. |
* This is where you enter the actual details of the selected Macro. | * This is where you enter the actual details of the selected Macro. | ||
- | * Layout changes depending on which type is selected. | + | * The layout changes depending on which type is selected. For [[Macros|macros]], it includes the name, the enabled state, the [[Macro_Triggers|triggers]] and the [[Macro_Actions|actions]]. For [[Macro_Groups| macro groups]], it includes the name and enable state, as well as details about when and how it is activated or displayed. For [[Smart_Groups|smart groups]], it includes the name and what macros to show. |
- | - **If a _Macro_ is selected**, shows the following elements: | + | |
- | - _Macro Name_ | + | |
- | - _Enabled Checkbox_ ✅ (shown just before the text "Triggered by any of the following"). | + | |
- | * Must be checked to enable your Macro to be triggered. | + | |
- | - _[[Macro_Triggers|Trigger]] List_ (if any) that have been assigned to your Macro. | + | |
- | - _[[:Actions|Action]] List_ -- the meat of your Macro that provides the processing steps to be performed. | + | |
- | - **If a _Macro Group_ is selected**, shows the following elements: | + | |
- | - _Macro Group Name_. | + | |
- | - _Enabled Checkbox_ ✅ (shown just before the text "Enable Macro Group"). | + | |
- | * Must be checked to enable your Macro Group. | + | |
- | * If unchecked, none of the Macros in that Macro Group can be triggered. | + | |
- You can resize the columns with the dividers 4️⃣, and double click on them to auto-resize the columns. | - You can resize the columns with the dividers 4️⃣, and double click on them to auto-resize the columns. | ||
+ | - **//The Toolbar at Top//** 5️⃣ shows the tools that apply to all macros. See below for details. | ||
+ | - **//The Toolbar at Bottom//** 6️⃣ includes tools below each of the columns that apply to each column (so Groups, Macros or the specific Macro). See below for details. | ||
+ | ===== Toolbar at Top ===== | ||
- | ==== Toolbars ==== | + | {{ editor-top-toolbar.png?nolink&937x85 | Editor Top Toolbar }} |
- | - **Toolbar at Bottom** | + | |
- | * Below each of the above columns are tools (buttons) to be used only for that column. | + | |
- | * See below for details | + | |
- | - **Toolbar at Top** | + | |
- | * At the top of the window are tools generally apply to all Macros. | + | |
- | * See below for details. | + | |
- | ===== Toolbar at Top ===== | ||
- | {{:manual:km-editor-top-toolbar-km9.png?|}}\\ | ||
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: | ||
- **//Share//** 1️⃣ Share your Macros or Actions, including directly to the [[https://forum.keyboardmaestro.com/|Keyboard Maestro Forum]]. | - **//Share//** 1️⃣ Share your Macros or Actions, including directly to the [[https://forum.keyboardmaestro.com/|Keyboard Maestro Forum]]. | ||
Line 55: | Line 40: | ||
* Press <kbd>⌘⌥F</kbd> (or <kbd>⌘F</kbd> a second time) to search all Macros. | * Press <kbd>⌘⌥F</kbd> (or <kbd>⌘F</kbd> a second time) to search all Macros. | ||
* If you enter simple text, it will search for any text in any Action, or Macro Name, that contains that text. | * If you enter simple text, it will search for any text in any Action, or Macro Name, that contains that text. | ||
- | * To better restrict the Search, use [[:manual/Search_Strings|Search Qualifiers]]. | + | * To better restrict the Search, use [[:manual/Search_Strings|Search Strings]]. |
+ | * Tap a modifiers key to enter the corresponding modifier symbol. | ||
* The _Macros Column_ will be filtered to only matching macros. | * The _Macros Column_ will be filtered to only matching macros. | ||
* Any parts of the macro that match will be highlighted in striped blue in the _Details Column_. | * Any parts of the macro that match will be highlighted in striped blue in the _Details Column_. | ||
+ | * If any macros are filtered out, an entry will show at the bottom of the macro column list representing all the hidden macros. | ||
===== Toolbar at Bottom ===== | ===== Toolbar at Bottom ===== | ||
- | {{:manual:km-editor-bottom-toolbar-km9.png|}}\\ | + | |
- | Buttons: | + | {{ editor-bottom-toolbar.png?nolink&937x38 | Editor Bottom Toolbar }} |
- | - **Common Buttons** 2️⃣ at the bottom of each column \\ (Applies to Item in that column) | + | |
- | - Create (BUTTON{{{+}}}) | + | Each column has three common buttons (underlined in the image). These are: |
- | - Delete (BUTTON{{{-}}}) | + | |
- | - Enable/disable (BUTTON{{{✓}}}) | + | * Create (BUTTON{{{+}}}) |
- | - **Groups Column Buttons** | + | * Delete (BUTTON{{{-}}}) |
- | - Create Smart Group BUTTON{{{⊕}}} 1️⃣ | + | * Enable/disable (BUTTON{{{✓}}}) |
- | - **Details Column Buttons** | + | |
- | - Set Timeout for selected Action 3️⃣ | + | Use them to create or delete or enable/disable Macro Groups, Macros, or Actions respectively. |
- | - Toggle Edit Mode BUTTON{{{Edit}}} 4️⃣ | + | |
- | - Try the selected actions BUTTON{{{Try}}} 5️⃣ | + | The remainder of the toolbar includes: |
- | - This is for testing _Actions_, NOT the entire Macro. | + | - **Groups Column Buttons** 1️⃣ including the Create Smart Group button and the common buttons for creating or deleting or enable/disabling macro groups. |
- | - To test the entire Macro, click the Run Button ▶️ in the Top Toolbar | + | - **Macro Column Buttons** 2️⃣ including the New Macro Wizard button and the common buttons for creating or deleting or enable/disabling macros. |
- | - Start Macro Recording BUTTON{{{Record}}} 6️⃣ | + | - **Details Column Buttons** including the common buttons for creating or deleting or enable/disabling actions and: |
+ | - Set Action Timeout 3️⃣ for selected action. | ||
+ | - Toggle BUTTON{{{Edit}}} Mode 4️⃣ | ||
+ | - BUTTON{{{Try}}} the selected actions 5️⃣. \\ This is for testing _Actions_, **not** running the entire Macro. \\ To test the entire Macro, click the Run BUTTON{{{▶︎}}} Button in the Top Toolbar. | ||
+ | - BUTTON{{{Record}}} button to start [[Recording| Macro Recording]] 6️⃣ | ||
===== Editing ===== | ===== Editing ===== | ||
+ | |||
Edit mode may be toggled on/off by clicking the BUTTON{{{Edit}}} button on the Bottom Toolbar, or by selecting the menu _View > Stop/Start Editing Macros_. Note that macros are saved immediately after every change (there is a small “dirty” marker in the bottom right corner of the editor window that shows when the save occurs). There is no need to ever turn off Edit mode, or do anything else to have your macro changes be recognised by the Keyboard Maestro Engine. | Edit mode may be toggled on/off by clicking the BUTTON{{{Edit}}} button on the Bottom Toolbar, or by selecting the menu _View > Stop/Start Editing Macros_. Note that macros are saved immediately after every change (there is a small “dirty” marker in the bottom right corner of the editor window that shows when the save occurs). There is no need to ever turn off Edit mode, or do anything else to have your macro changes be recognised by the Keyboard Maestro Engine. | ||
Line 92: | Line 84: | ||
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. | ||
- | {{ macro-editor-marked.png?nolink&937x694 | Macro Editor }} | + | {{ macro-editor-marked.png?nolink&937x737 | Macro Editor }} |
- **//Icon and Name//** 1️⃣ You can adjust the icon by double clicking the icon and selecting an image in the [[Icon Chooser]] and you can change the name of the Macro. | - **//Icon and Name//** 1️⃣ You can adjust the icon by double clicking the icon and selecting an image in the [[Icon Chooser]] and you can change the name of the Macro. | ||
- | - **//Enabled//** 2️⃣ You can enable or disable the macro with this checkbox (a macro must be enabled for it to be available to be triggered (executed) - its parent macro group must also be enabled and active). | + | - **//Enabled//** 2️⃣ You can enable or disable the macro with this checkbox. \\ A macro must be enabled for it to be available to be triggered (executed) - its parent macro group must also be enabled and active. |
- **//Triggers//** 3️⃣ You can add [[Macro Triggers]] to the macro which control when the macro will run. | - **//Triggers//** 3️⃣ You can add [[Macro Triggers]] to the macro which control when the macro will run. | ||
- | - **//Triggers//** 4️⃣ You can add more than one trigger to define different ways that you can start the macro. | + | - **//More Triggers//** 4️⃣ You can add more than one trigger to define different ways that you can start the macro. |
- | - **//Actions//** 5️⃣ You then add one more [[Macro Actions]] which definite when the macro does when it runs. | + | - **//Actions//** 5️⃣ You then add one or more [[Macro Actions]] which definite when the macro does when it runs. |
- **//New Action//** 6️⃣ Click the New Action button to add additional actions. | - **//New Action//** 6️⃣ Click the New Action button to add additional actions. | ||
Line 114: | Line 107: | ||
==== Macro Groups ==== | ==== Macro Groups ==== | ||
- | When you are in Edit Mode, and you select a Macro Group, you can edit its configuration. | + | You can select a Macro Group to edit it (turn on Edit Mode if necessary by clicking the BUTTON{{{EDIT}}} button). |
- | {{ macro-group-marked.png?nolink&937 | Macro Group Editor }} | + | {{ macro-group-marked.png?nolink&937x731 | Macro Group Editor }} |
- | You can adjust the icon by double clicking the icon 1️⃣ and selecting an image in the Icon Chooser and you can change the name of the Macro. | + | You can adjust the icon by double clicking the icon 1️⃣ and selecting an image in the Icon Chooser and you can change the name of the Macro Group. |
- | For a Macro to be available to trigger, it must be enabled and its parent Macro Group must be enabled 2️⃣, 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 2️⃣, and active. The configuration for the Macro Group controls 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️⃣ and whether and how the macro group displays in the menu bar 6️⃣. | 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️⃣ and whether and how the macro group displays in the menu bar 6️⃣. | ||
Line 126: | Line 119: | ||
==== Smart Groups ==== | ==== Smart Groups ==== | ||
- | When you are in Edit Mode, and you select a Smart Group, you can edit its search settings. | + | You can select a Smart Group to edit its search settings (turn on Edit Mode if necessary by clicking the BUTTON{{{EDIT}}} button). |
- | {{ smart-group-marked.png?nolink&937x465 | Smart Group Editor }} | + | {{ smart-group-marked.png?nolink&937x396 | 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️⃣. |