User Tools

Site Tools


manual:Windows

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
Next revision Both sides next revision
manual:Windows [2018/05/04 00:17]
peternlewis [Palette Theme Editor]
manual:Windows [2019/06/20 22:39]
peternlewis
Line 5: Line 5:
 This window welcomes new users and gives you some options for learning about Keyboard Maestro. This window welcomes new users and gives you some options for learning about Keyboard Maestro.
  
-{{ welcome.png?​1062 |Welcome Window }}+{{ welcome.png?​nolink&​1062x714 ​| Welcome Window }}
  
 If you are new to Keyboard Maestro, start the tutorial and Keyboard Maestro will walk you through creating a simple macro. If you are new to Keyboard Maestro, start the tutorial and Keyboard Maestro will walk you through creating a simple macro.
Line 15: Line 15:
 You get this window pane by launching Keyboard~~Maestro. You get this window pane by launching Keyboard~~Maestro.
  
-{{ macros.png?​nolink&​937 |Macros Window }}+{{ macros.png?​nolink&​937x532 ​| Macros Window }}
  
 The window contains a list of Macro~~Groups and their associated Macros. The window contains a list of Macro~~Groups and their associated Macros.
Line 41: Line 41:
 ===== Tutorial ===== ===== Tutorial =====
  
-If you are new to Keyboard Maestro, start the tutorial by clicking the BUTTON{{{Start Tutorial}}} button in the [[Windows#​Welcome_Window|Welcome window]] or by choosing [[Menus#Help_Tutorial|Tutorial]] from the [[Menus#​Help|Help menu]] and Keyboard Maestro will walk you through creating a simple macro.+If you are new to Keyboard Maestro, start the tutorial by clicking the BUTTON{{{Start Tutorial}}} button in the [[Windows#​Welcome_Window|Welcome window]] or by choosing ​the [[Menus#​Tutorial|Help ​➤ Tutorial ​menu]] and Keyboard Maestro will walk you through creating a simple macro.
  
-{{ tutorial.png?​nolink&​937 |Tutorial }}+{{ tutorial.png?​nolink&​937x532 ​| Tutorial }}
  
 Follow the instructions. ​ Keyboard Maestro will hilight the location of the various buttons to help you quickly create a macro. ​ You can even use the tutorial as a wizard to create a hot key triggered macro to perform any of Keyboard Maestro’s many actions. Follow the instructions. ​ Keyboard Maestro will hilight the location of the various buttons to help you quickly create a macro. ​ You can even use the tutorial as a wizard to create a hot key triggered macro to perform any of Keyboard Maestro’s many actions.
Line 51: Line 51:
 To edit a Macro~~Group,​ select it and click the Edit button. ​ Its details will be shown in the right hand column. ​ You can edit its name, control which applications it is available in, and how it will be activated. To edit a Macro~~Group,​ select it and click the Edit button. ​ Its details will be shown in the right hand column. ​ You can edit its name, control which applications it is available in, and how it will be activated.
  
-{{ macrogroupeditor.png?​937 |Macro Group Editor }}+{{ macrogroupeditor.png?​nolink&​937x553 ​| Macro Group Editor }}
  
 Typically a group’s macros would be available everywhere (available in all applications),​ or it might be specific to a particular application (available in the following applications) in which case you might name the Macro~~Group after the application. Typically a group’s macros would be available everywhere (available in all applications),​ or it might be specific to a particular application (available in the following applications) in which case you might name the Macro~~Group after the application.
Line 63: Line 63:
 To edit a Macro, select it and click the Edit button. ​ Its details will be shown in the right hand column. ​ You can edit its name, add or remove triggers, and configure its action list. To edit a Macro, select it and click the Edit button. ​ Its details will be shown in the right hand column. ​ You can edit its name, add or remove triggers, and configure its action list.
  
-{{ macroeditor.png?​937 |Macro Editor Window }}+{{ macroeditor.png?​nolink&​937x553 ​| Macro Editor Window }}
  
 To add a trigger, click the green BUTTON{{{⊕}}} button and select the type of trigger. ​ To remove a trigger, click the red BUTTON{{{⊖}}} button. To add a trigger, click the green BUTTON{{{⊕}}} button and select the type of trigger. ​ To remove a trigger, click the red BUTTON{{{⊖}}} button.
Line 78: Line 78:
  
 To learn more about creating or editing Macros, see the [[Macros]] section. To learn more about creating or editing Macros, see the [[Macros]] section.
- 
-===== Macro Inspector Window ===== 
- 
-This window shows you information about the selected macro or macro group. 
- 
-You get this window by choosing [[Menus#​Window_Macro_Inspector|Macro Inspector]] from the [[Menus#​Window|Window menu]]. 
- 
-{{ macroinspector.png?​430x409 |Macro Inspector Window }} 
- 
-===== Mouse Display Window ===== 
- 
-This window shows you the mouse location relative to any corner of the main screen or front window. 
- 
-You get this window by choosing [[Menus#​Window_Mouse_Display|Mouse Display]] from the [[Menus#​Window|Window menu]]. 
- 
-{{ mousedisplay.png?​378x143 |Mouse Display Window }} 
- 
-You can click the BUTTON{{{🔒}}} button and then five seconds later Keyboard Maestro will lock the coordinates. ​ You can click the BUTTON{{{📋}}} button to copy the values, and you can change the relative corner even while the display is locked. 
  
 ===== Macro Library Window ===== ===== Macro Library Window =====
Line 101: Line 83:
 This window contains example and template macros you can add to your macro collection. ​ You can use the macros as is, or edit them to customize them for your particular needs. This window contains example and template macros you can add to your macro collection. ​ You can use the macros as is, or edit them to customize them for your particular needs.
  
-You get this window by choosing [[Menus#Window_Macro_Library|Macro Library]] from the [[Menus#​Window|Window ​menu]].+You get this window by choosing ​the [[Menus#Macro_Library|Window ➤ Macro Library menu]].
  
 {{ macrolibrary.png?​465x664 |Macro Library Window }} {{ macrolibrary.png?​465x664 |Macro Library Window }}
Line 107: Line 89:
 Each entry represents one or more macros, usually in a single macro group, but occasionally in more than one macro group. ​ You can learn about them by selecting them, and then you can insert them into your macros by clicking the BUTTON{{{Insert}}} button or by dragging them to a particular macro group (dragging is not available if the library entry represents more than one macro group as you can't drag to two macro groups). Each entry represents one or more macros, usually in a single macro group, but occasionally in more than one macro group. ​ You can learn about them by selecting them, and then you can insert them into your macros by clicking the BUTTON{{{Insert}}} button or by dragging them to a particular macro group (dragging is not available if the library entry represents more than one macro group as you can't drag to two macro groups).
  
-You can add macros to your library by choosing [[Menus#File_Export_as_Macro_Library|Export as Macro Library]] from the [[Menus#​File|File ​menu]] and selecting the Add to My Macro Library checkbox. ​ You can get Macro Library entries from us or from other Keyboard Maestro users and add them to you library by double clicking them or by choosing [[Menus#File_Import_to_Macro_Library|Import to Macro Library]] from the [[Menus#​File|File ​menu]].+You can add macros to your library by choosing ​the [[Menus#Export_as_Macro_Library|File ➤ Export as Macro Library menu]] and selecting the Add to My Macro Library checkbox. ​ You can get Macro Library entries from us or from other Keyboard Maestro users and add them to you library by double clicking them or by choosing ​the [[Menus#Import_to_Macro_Library|File ➤ Import to Macro Library menu]].
  
 Remember to use caution when installing a macro or macro library from anyone – macros can potentially do a lot of damage and compromise the security of your Mac, so only install macros from trusted sources. ​ When importing macros from a file they will be imported disabled (either the parent macro group will be disabled, or if it exists already, the macros themselves will be disabled) unless you hold the Option key down. Remember to use caution when installing a macro or macro library from anyone – macros can potentially do a lot of damage and compromise the security of your Mac, so only install macros from trusted sources. ​ When importing macros from a file they will be imported disabled (either the parent macro group will be disabled, or if it exists already, the macros themselves will be disabled) unless you hold the Option key down.
- 
-===== Palette Theme Editor ===== 
- 
-This window allows you to configure the appearance of the various macro palette. 
- 
-You can choose a style, the opacity of the palette, the size of the entries, the number of columns, whether the entries include the icon, the text and/or the trigger, and whether the palette shrinks when the mouse is not over it. 
- 
-{{ palettethemeeditor.png?​393x419 |Palette Theme Editor }} 
  
 ===== Icon Chooser Window ===== ===== Icon Chooser Window =====
Line 123: Line 97:
 This window contains icons you can use to customize your macro and macro groups. ​ You can click on an icon well in the macro or macro group editor and then show this window and select or create an icon for it. This window contains icons you can use to customize your macro and macro groups. ​ You can click on an icon well in the macro or macro group editor and then show this window and select or create an icon for it.
  
-You get this window by choosing [[Menus#Window_Icon_Chooser|Icon Chooser]] from the [[Menus#​Window|Window ​menu]].+You get this window by choosing ​the [[Menus#Icon_Chooser|Window ➤ Icon Chooser menu]].
  
 There are three types of icons available. ​ Internal Keyboard Maestro icons: There are three types of icons available. ​ Internal Keyboard Maestro icons:
Line 142: Line 116:
  
 Alternatively,​ you can copy an image from anywhere and paste it in to the icon well (although Keyboard Maestro stores a small reference to the Icon Chooser icons, so that is much more efficient that storing the image in your macros as copy & paste will). Alternatively,​ you can copy an image from anywhere and paste it in to the icon well (although Keyboard Maestro stores a small reference to the Icon Chooser icons, so that is much more efficient that storing the image in your macros as copy & paste will).
 +
 +===== Macro Inspector Window =====
 +
 +This window shows you information about the selected macro or macro group.
 +
 +You get this window by choosing the [[Menus#​Macro_Inspector|Window ➤ Macro Inspector menu]].
 +
 +{{ macroinspector.png?​430x409 |Macro Inspector Window }}
 +
 +===== Mouse Display Window =====
 +
 +This window shows you the mouse location relative to any corner of the main screen or front window.
 +
 +You get this window by choosing the [[Menus#​Mouse_Display|Window ➤ Mouse Display menu]].
 +
 +{{ mousedisplay.png?​378x143 |Mouse Display Window }}
 +
 +You can click the BUTTON{{{🔒}}} button and then five seconds later Keyboard Maestro will lock the coordinates. ​ You can click the BUTTON{{{📋}}} button to copy the values, and you can change the relative corner even while the display is locked.
 +
 +===== Value Inspector Window =====
 +
 +This window shows you the value of the specified variables, clipboards, calculations or tokens.
 +
 +You get this window by choosing the [[Menus#​Value_Inspector |Window ➤ Value Inspector menu]].
 +
 +{{ valueinspector.png?​nolink&​546x424 | Value Inspector }}
 +
 +The contextual menu (control or right click in the window) will allow you to toggle whether the window is displayed only while the Keyboard Maestro editor is at the front, or whether the window floats above all applications.
 +
 +===== Palette Theme Editor =====
 +
 +This window allows you to configure the appearance of the various macro palette.
 +
 +You can choose a style, the opacity of the palette, the size of the entries, the number of columns, whether the entries include the icon, the text and/or the trigger, and whether the palette shrinks when the mouse is not over it.
 +
 +{{ palettethemeeditor.png?​nolink&​479x481 | Palette Theme Editor }}
  
 ===== Recording Window ===== ===== Recording Window =====
Line 151: Line 161:
 {{ recording.png?​86x125 |Recording Window }} {{ recording.png?​86x125 |Recording Window }}
  
-Clicking on this window will stop all recording, or you can pause recording, or add a second Pause action to the current recording.+Clicking on this window will stop all recording, or you can pause recording, or add a 0.25 second Pause action to the current ​recording. Option-clicking the BUTTON{{{Clock}}} button (v9.0+) will turn on “real time” recording and Keyboard Maestro will record a pause between each action to simulate playback at approximately the same speed as the recording.
  
 To learn more about recording, see the [[Recording]] section. To learn more about recording, see the [[Recording]] section.
Line 157: Line 167:
 ===== Macro Debugger ===== ===== Macro Debugger =====
  
-You get this window by choosing ​[[Menus#​Status_Menu_Start_Debugging|Start Debugging]] from the [[Menus#Status_Menu|Status Menu menu]] by triggering a Debugger Start action.+You get this window by choosing the [[Menus#Start_Debugging|Status Menu ➤ Start Debugging ​menu]] by triggering a Debugger Start action.
  
 {{ macrodebugger.png?​528x193 |Macro Debugger }} {{ macrodebugger.png?​528x193 |Macro Debugger }}
Line 215: Line 225:
 To learn more about the Window Switcher, see the [[Window Switcher]] section. To learn more about the Window Switcher, see the [[Window Switcher]] section.
  
-===== Clipboard Switcher Window =====+===== Named Clipboard Switcher Window =====
  
 This window lets you select between named clipboards to Cut, Copy or Paste to/from. This window lets you select between named clipboards to Cut, Copy or Paste to/from.
Line 221: Line 231:
 You get this window by triggering one of the Activate~~Clipboard~~Switcher macros. You get this window by triggering one of the Activate~~Clipboard~~Switcher macros.
  
-{{ namedclipboardswitcher.png?​672 |Named Clipboard Switcher Window }}+{{ namedclipboardswitcher.png?​nolink&​673x647 ​| Named Clipboard Switcher Window }}
  
 Select something and select a named clipboard and click the BUTTON{{{Cut}}} button or BUTTON{{{Copy}}} button to cut/copy to a named clipboard. ​ Select a named clipboard and click the BUTTON{{{Paste}}} button button to paste a named clipboard. ​ Click the BUTTON{{{+}}} button to create a new named clipboard. ​ Select a named clipboard and click the BUTTON{{{Quick Look}}} button to view it.  Select a named clipboard and click the BUTTON{{{-}}} button to delete it. Select something and select a named clipboard and click the BUTTON{{{Cut}}} button or BUTTON{{{Copy}}} button to cut/copy to a named clipboard. ​ Select a named clipboard and click the BUTTON{{{Paste}}} button button to paste a named clipboard. ​ Click the BUTTON{{{+}}} button to create a new named clipboard. ​ Select a named clipboard and click the BUTTON{{{Quick Look}}} button to view it.  Select a named clipboard and click the BUTTON{{{-}}} button to delete it.
Line 237: Line 247:
 You get this window by triggering the Clipboard~~History~~Switcher macro. You get this window by triggering the Clipboard~~History~~Switcher macro.
  
-{{ clipboardhistoryswitcher.png?​672 |Clipboard History Switcher Window }}+{{ clipboardhistoryswitcher.png?​nolink&​673x706 ​| Clipboard History Switcher Window }}
  
 Cut or copy something and it will appear in this list.  Select an item and click the BUTTON{{{Paste}}} button button to paste a named clipboard. ​ Select an item and click the BUTTON{{{★}}} button (or press Command-L) to mark it as a favorite, or click the BUTTON{{{✉}}} button (or press Command-S) to send it to another Mac.  Select an item and click the BUTTON{{{-}}} button to delete it (this is useful if you want to delete a password or other sensitive information). Cut or copy something and it will appear in this list.  Select an item and click the BUTTON{{{Paste}}} button button to paste a named clipboard. ​ Select an item and click the BUTTON{{{★}}} button (or press Command-L) to mark it as a favorite, or click the BUTTON{{{✉}}} button (or press Command-S) to send it to another Mac.  Select an item and click the BUTTON{{{-}}} button to delete it (this is useful if you want to delete a password or other sensitive information).
Line 261: Line 271:
 This window lets you configure Keyboard~~Maestro. This window lets you configure Keyboard~~Maestro.
  
-You get this window by launching Keyboard~~Maestro and choosing [[Menus#Keyboard_Maestro_Preferences|Preferences]] from the [[Menus#​Keyboard_Maestro|Keyboard Maestro menu]].+You get this window by launching Keyboard~~Maestro and choosing ​the [[Menus#​Preferences|Keyboard Maestro ​➤ Preferences ​menu]].
  
 To learn more about the Preferences,​ see the [[Preferences]] section. To learn more about the Preferences,​ see the [[Preferences]] section.
Line 269: Line 279:
 This window pane lets you configure general preferences. This window pane lets you configure general preferences.
  
-{{ preferencesgeneral.png?​472 |Preferences General Pane }}+{{ preferencesgeneral.png?​nolink&​472x613 ​| Preferences General Pane }}
  
 ===== Preferences Palettes Pane ===== ===== Preferences Palettes Pane =====
Line 277: Line 287:
 You can also configure whether the conflict palette appears under the mouse. You can also configure whether the conflict palette appears under the mouse.
  
-{{ preferencespalettes.png?​472 |Preferences Palettes Pane }}+{{ preferencespalettes.png?​nolink&​472x525 ​| Preferences Palettes Pane }}
  
 ===== Preferences Web Server Pane ===== ===== Preferences Web Server Pane =====
Line 283: Line 293:
 This window pane lets you configure the built-in web server which enables remote execution of macros. This window pane lets you configure the built-in web server which enables remote execution of macros.
  
-{{ preferenceswebserver.png?​633x461 ​|Preferences Web Server Pane }}+{{ preferenceswebserver.png?​nolink&​633x462 ​| Preferences Web Server Pane }}
  
 ===== Preferences Clipboards Pane ===== ===== Preferences Clipboards Pane =====
Line 289: Line 299:
 This window pane lets you add, remove and rename Named~~Clipboards and see and change their values. This window pane lets you add, remove and rename Named~~Clipboards and see and change their values.
  
-{{ preferencesclipboards.png?​727x615 ​|Preferences Clipboards Pane }}+{{ preferencesclipboards.png?​nolink&​727x616 ​| Preferences Clipboards Pane }}
  
 ===== Preferences Variables Pane ===== ===== Preferences Variables Pane =====
Line 295: Line 305:
 This window pane lets you add and remove variables, and see and change their values. This window pane lets you add and remove variables, and see and change their values.
  
-{{ preferencesvariables.png?​727x615 ​|Preferences Variables Pane }} +{{ preferencesvariables.png?​nolink&​727x616 ​| Preferences Variables Pane }}
- +
-==== Example ====+
  
-{{:​manual:​variable-preferences-add-change-km8.png?​nolink|}} 
 ===== Preferences Exclude Pane ===== ===== Preferences Exclude Pane =====
  
 This window pane lets you add and remove applications from the global Excluded~~Applications list. This window pane lets you add and remove applications from the global Excluded~~Applications list.
  
-{{ preferencesexcluded.png?​522 |Preferences Exclude Pane }}+{{ preferencesexcluded.png?​nolink&​522x558 ​| Preferences Exclude Pane }}
  
 ===== About Window Pane ===== ===== About Window Pane =====
Line 310: Line 317:
 This window shows you the version of this copy of Keyboard~~Maestro,​ to whom it is registered, and allows you to visit the web site. This window shows you the version of this copy of Keyboard~~Maestro,​ to whom it is registered, and allows you to visit the web site.
  
-You get this window by launching Keyboard~~Maestro and choosing [[Menus#Keyboard_Maestro_About_Keyboard_Maestro|About Keyboard Maestro]] from the [[Menus#​Keyboard_Maestro|Keyboard Maestro menu]].+You get this window by launching Keyboard~~Maestro and choosing ​the [[Menus#About_Keyboard_Maestro|Keyboard Maestro ​➤ About Keyboard Maestro menu]].
  
-{{ about.png?428 |About Window ​Pane }}+{{ about.png?nolink&​428x497 ​| About Window }}
  
manual/Windows.txt · Last modified: 2023/10/06 03:46 by peternlewis