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/12/31 16:33] JMichaelTX |
manual:Editor_Window [2019/12/31 18:21] JMichaelTX Reorder Editing sections |
||
|---|---|---|---|
| Line 5: | Line 5: | ||
| 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]]. | ||
| + | ===== Window Elements ===== | ||
| {{ editor-window-marked.png?nolink&937x553 | Editor Window }} | {{ editor-window-marked.png?nolink&937x553 | Editor Window }} | ||
| - | + | ==== Main Elements ==== | |
| - | ===== Window Elements ===== | + | - **//Groups Column//** 1️⃣ (on the left) |
| - | ==== Overview ==== | + | |
| - | - **//Macro Group 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 [[Macro_Groups|Macro Groups]] and [[Smart_Groups|Smart Groups]] (shown at top) in your account. | ||
| * Smart Groups are saved searches of macros. | * Smart Groups are saved searches of macros. | ||
| - | - **//Macro 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 [[Macro_Groups|Macro Group]]. | ||
| * 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 (upper right corner). | ||
| - **_Details Column_** 3️⃣ (on the right) | - **_Details Column_** 3️⃣ (on the right) | ||
| - | - Shows the details of either the selected Macro, or Macro 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. | * Layout changes depending on which type is selected. | ||
| Line 31: | Line 30: | ||
| * Must be checked to enable your Macro Group. | * Must be checked to enable your Macro Group. | ||
| * If unchecked, none of the Macros in that Macro Group can be triggered. | * If unchecked, none of the Macros in that Macro Group can be triggered. | ||
| + | |||
| + | ==== Toolbars ==== | ||
| - **Toolbar at Bottom** | - **Toolbar at Bottom** | ||
| * Below each of the above columns are tools (buttons) to be used only for that column. | * Below each of the above columns are tools (buttons) to be used only for that column. | ||
| Line 38: | Line 39: | ||
| * See below for details. | * See below for details. | ||
| - | ==== Toolbar at Bottom ==== | + | ===== Toolbar at Bottom ===== |
| - | - **Common Buttons** 4️⃣ at the bottom of each column \\ (Applies to Item in that column) | + | {{:manual:km-editor-bottom-toolbar-km9.png|}}\\ |
| + | Buttons: | ||
| + | - **Common Buttons** 2️⃣ at the bottom of each column \\ (Applies to Item in that column) | ||
| - Create (BUTTON{{{+}}}) | - Create (BUTTON{{{+}}}) | ||
| - Delete (BUTTON{{{-}}}) | - Delete (BUTTON{{{-}}}) | ||
| - Enable/disable (BUTTON{{{✓}}}) | - Enable/disable (BUTTON{{{✓}}}) | ||
| - | - **Groups Column Buttons** | + | - **Groups Column Buttons** |
| - | - Create Smart Group BUTTON{{{⊕}}} | + | - Create Smart Group BUTTON{{{⊕}}} 1️⃣ |
| - **Details Column Buttons** | - **Details Column Buttons** | ||
| - | - set a timeout for a specific action | + | - Set Timeout for selected Action 3️⃣ |
| - | - Toggle Edit Mode BUTTON{{{Edit}}} 5️⃣ | + | - Toggle Edit Mode BUTTON{{{Edit}}} 4️⃣ |
| - | - Try the selected actions BUTTON{{{Try}}} | + | - Try the selected actions BUTTON{{{Try}}} 5️⃣ |
| - This is for testing _Actions_, NOT the entire Macro. | - This is for testing _Actions_, NOT the entire Macro. | ||
| - To test the entire Macro, click the Run Button ▶️ in the Top Toolbar | - To test the entire Macro, click the Run Button ▶️ in the Top Toolbar | ||
| - | - Start Macro Recording BUTTON{{{Record}}} | + | - Start Macro Recording BUTTON{{{Record}}} 6️⃣ |
| - | + | ||
| - | ==== Toolbar at Top ==== | + | |
| + | ===== 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: | ||
| - BUTTON{{{Share}}} ⏏️ -- Share your Macros or Actions, including directly to the [[https://forum.keyboardmaestro.com/|Keyboard Maestro Forum]]. | - BUTTON{{{Share}}} ⏏️ -- Share your Macros or Actions, including directly to the [[https://forum.keyboardmaestro.com/|Keyboard Maestro Forum]]. | ||
| - | - BUTTON{{{Used}}} Select the most recently used (triggered) macros. | + | - BUTTON{{{Used}}} ⌘ Select the most recently used (triggered) macros. |
| - BUTTON{{{History}}} ⬅️➡️ Select from the recently edited macro history. | - BUTTON{{{History}}} ⬅️➡️ Select from the recently edited macro history. | ||
| - BUTTON{{{Modified}}} ⏲️ Select the most recently edited macro. | - BUTTON{{{Modified}}} ⏲️ Select the most recently edited macro. | ||
| - BUTTON{{{Run}}} ▶️ Run the selected macro. | - BUTTON{{{Run}}} ▶️ 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️⃣. | + | - BUTTON{{{Search}}} 🔍 Search for Macros and Actions. |
| + | * Press <kbd>⌘F</kbd> to search Macros only in the selected Macro Group. | ||
| + | * Press <kbd>⌘⌥F</kbd> 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 | ||
| + | * To better restrict the Search, use [[:manual/Search_Strings|Search Qualifiers]] | ||
| + | * 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_. | ||
| - | ==== Editing Smart Groups ==== | + | ===== 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_. | ||
| - | When you are in Edit Mode, and you select a Smart Group, you can edit its search settings. | + | ==== Actions ==== |
| - | {{ smart-group-marked.png?nolink&937x465 | Smart Group Editor }} | + | **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 _Details Column_ 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]] | ||
| - | You can adjust the name of the Smart Group 1️⃣, and adjust its [[Search_Strings|Search Strings]] 2️⃣. | + | ==== Macros ==== |
| - | + | ||
| - | You can add another Search String by clicking the green BUTTON{{{+}}} button. | + | |
| - | + | ||
| - | ==== Editing Macro Groups ==== | + | |
| - | + | ||
| - | When you are in Edit Mode, and you select a Macro Group, you can edit its configuration. | + | |
| - | + | ||
| - | {{ macro-group-marked.png?nolink&937x584 | Macro Group Editor }} | + | |
| - | + | ||
| - | You can adjust the name of the Macro Group (1). | + | |
| - | + | ||
| - | 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). | + | |
| - | + | ||
| - | ==== Editing Macros ==== | + | |
| 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 105: | Line 104: | ||
| When a macro is triggered, it will execute the actions you have entered in the Details Column 3️⃣. | When a macro is triggered, it will execute the actions you have entered in the Details Column 3️⃣. | ||
| - | ==== Editing Actions ==== | + | ==== Macro Groups ==== |
| - | **You can add a new action by any of the following:** | + | When you are in Edit Mode, and you select a Macro Group, you can edit its configuration. |
| - | - 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 | + | {{ macro-group-marked.png?nolink&937x584 | Macro Group Editor }} |
| - | - 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 | + | You can adjust the name of the Macro Group (1). |
| - | - Choose from the [[Menus#Insert_Action|Edit ➤ Insert Action menu]] | + | |
| + | 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). | ||
| + | |||
| + | ==== Smart Groups ==== | ||
| + | |||
| + | When you are in Edit Mode, and you select a Smart Group, you can edit its search settings. | ||
| + | |||
| + | {{ 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 add another Search String by clicking the green BUTTON{{{+}}} button. | ||
| - | 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
