User Tools

Site Tools


manual:Features

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
manual:Features [2017/08/21 23:06]
peternlewis 8
manual:Features [2023/09/21 04:13] (current)
peternlewis [Triggers]
Line 10: Line 10:
 [[Macro Groups]] allow you to organize your macros. Think of them as folders of macros. Each Macro Group controls when the macros it contains are active. A [[Macros|Macro]] is made of two parts: a set of [[Macro Triggers|Triggers]] you choose to determine when the macro is executed and a list of [[Macro Actions|Actions]] that define what the macro does when it is executed. [[Macro Groups]] allow you to organize your macros. Think of them as folders of macros. Each Macro Group controls when the macros it contains are active. A [[Macros|Macro]] is made of two parts: a set of [[Macro Triggers|Triggers]] you choose to determine when the macro is executed and a list of [[Macro Actions|Actions]] that define what the macro does when it is executed.
  
-By creating macros, you can customize your Mac to suit your use, streamline tedious tasks, and remove opportunities for mistakes by automating repetitive jobs.  Make a stuburnly ​difficult applications ​behvave ​the way you want them to; press a key and have the computer do the next minute worth of tedious tasks for you; type a few characters and have a page full of boilerplate text appear; and so much more.  Soon you'll wonder how you could have used your Mac without Keyboard Maestro.+By creating macros, you can customize your Mac to suit your use, streamline tedious tasks, and remove opportunities for mistakes by automating repetitive jobs.  Make stubbornly ​difficult applications ​behave ​the way you want them to; press a key and have the computer do the next minute worth of tedious tasks for you; type a few characters and have a page full of boilerplate text appear; and so much more.  Soon youll wonder how you could have used your Mac without Keyboard Maestro.
  
 Here are some of the primary features of Keyboard Maestro. Here are some of the primary features of Keyboard Maestro.
Line 16: Line 16:
 ===== General ===== ===== General =====
  
 +* Use Dark Mode or Light Mode (10.14+).
 * Sync your macros across multiple Macs using DropBox or other file sharing systems. * Sync your macros across multiple Macs using DropBox or other file sharing systems.
 * Trigger macros by key, typed string, menu, by name, remotely, via MIDI, and more. * Trigger macros by key, typed string, menu, by name, remotely, via MIDI, and more.
Line 24: Line 25:
  
 * Create Macro Groups, which contain Macros and control when they are active. * Create Macro Groups, which contain Macros and control when they are active.
 +* Macro Groups can be displayed in the menu bar with additional information and macros.
 * Macro Groups can be restricted to or excluded from specific applications. * Macro Groups can be restricted to or excluded from specific applications.
 * Macro Groups can be restricted to or excluded from specific windows. * Macro Groups can be restricted to or excluded from specific windows.
Line 36: Line 38:
 * Macros can be triggered by one or more [[Macro Triggers]] using any number of the following: * Macros can be triggered by one or more [[Macro Triggers]] using any number of the following:
   * [[/​trigger/​Hot_Key|Hot Key trigger]] – when you press, hold, release or multi-tap a key.   * [[/​trigger/​Hot_Key|Hot Key trigger]] – when you press, hold, release or multi-tap a key.
-  * [[/trigger/Macro_Palette|Macro Palette trigger]] – with a click on a context sensitive Macro~~Palette.+  * [[/trigger/Global_Macro_Palette|Global ​Macro Palette trigger]] – with a click on a context sensitive Macro~~Palette.
   * [[/​trigger/​Status_Menu|Status Menu trigger]] – by selecting from a global system status menu.   * [[/​trigger/​Status_Menu|Status Menu trigger]] – by selecting from a global system status menu.
   * [[/​trigger/​Typed_String|Typed String trigger]] – type a string of keys.   * [[/​trigger/​Typed_String|Typed String trigger]] – type a string of keys.
 +  * [[trigger:​Appearance_Changed|Appearance Changed trigger]] - when the Mac changes system appearance.
   * [[/​trigger/​Application|Application trigger]] – on launch, quit, activate, deactivate, or periodically while an application is running or active.   * [[/​trigger/​Application|Application trigger]] – on launch, quit, activate, deactivate, or periodically while an application is running or active.
-  * [[/trigger/Audio_Output| Audio Output Changed trigger]] – whenever your audio output device changes. +  * [[/trigger/Audio_Output_Changed|Audio Output Changed trigger]] – whenever your audio output device changes. 
-  * [[/trigger/Clipboard|Clipboard trigger]] – when the system clipboard changes.+  * [[/trigger/Clipboard_Changed|Clipboard ​Changed ​trigger]] – when the system clipboard changes.
   * [[/​trigger/​Clipboard_Filter|Clipboard Filter trigger]] – select macros from the clipboard switchers.   * [[/​trigger/​Clipboard_Filter|Clipboard Filter trigger]] – select macros from the clipboard switchers.
   * [[/​trigger/​Cron| Cron trigger]] – periodically based on time or day or date.   * [[/​trigger/​Cron| Cron trigger]] – periodically based on time or day or date.
 +  * [[/​trigger/​Display_Layout_Changed| Display Layout Changed trigger]] – trigger when the display layout changes.
 +  * [[/​trigger/​Dragged_File| Dragged File trigger]] – trigger when a file is dragged onto the macro in a palette icon.
   * [[/​trigger/​Engine_Launch|Engine Launch trigger]] – when the Keyboard Maestro engine launches.   * [[/​trigger/​Engine_Launch|Engine Launch trigger]] – when the Keyboard Maestro engine launches.
   * [[/​trigger/​Focused_Window|Focused Window trigger]] – when the front/​focused window changes.   * [[/​trigger/​Focused_Window|Focused Window trigger]] – when the front/​focused window changes.
   * [[/​trigger/​Folder| Folder trigger]] – when a file is added to or removed from a folder.   * [[/​trigger/​Folder| Folder trigger]] – when a file is added to or removed from a folder.
   * [[/​trigger/​Gesture| Gesture trigger]] – when you draw a pre-set shape with the mouse or trackpad.   * [[/​trigger/​Gesture| Gesture trigger]] – when you draw a pre-set shape with the mouse or trackpad.
 +  * [[trigger:​Group_Status_Menu|Group Status Menu trigger]] - include your macro in the parent macro group menu bar item.
   * [[/​trigger/​Idle| Idle trigger]] – when your Mac has been idle for a period of time (but not yet asleep).   * [[/​trigger/​Idle| Idle trigger]] – when your Mac has been idle for a period of time (but not yet asleep).
   * [[/​trigger/​Login|Login trigger]] – when you log in to your Mac.   * [[/​trigger/​Login|Login trigger]] – when you log in to your Mac.
Line 53: Line 59:
   * [[/​trigger/​Mounted_Volume|Mounted Volume trigger]] – when a volume is mounted or unmounted.   * [[/​trigger/​Mounted_Volume|Mounted Volume trigger]] – when a volume is mounted or unmounted.
   * [[/​trigger/​Periodic|Periodic trigger]] – periodically while logged in.   * [[/​trigger/​Periodic|Periodic trigger]] – periodically while logged in.
 +  * [[trigger:​Power_Status_Changed|Power Status Changed trigger]] - when your Mac’s is connected or disconnected from power.
   * [[/​trigger/​Public_Web|Public Web trigger]] – over the Internet, explicitly to the public, or via authenticated log in.   * [[/​trigger/​Public_Web|Public Web trigger]] – over the Internet, explicitly to the public, or via authenticated log in.
   * [[/​trigger/​Remote|Remote trigger]] – when you access a link on our trigger server.   * [[/​trigger/​Remote|Remote trigger]] – when you access a link on our trigger server.
   * [[/​trigger/​Sleep|Sleep trigger]] – when the system goes to sleep.   * [[/​trigger/​Sleep|Sleep trigger]] – when the system goes to sleep.
-  * [[/trigger/Time|Time trigger]] – at a particular time of day.+  ​* [[trigger:​Space_Changed|Space Changed trigger]] - when you change Spaces. 
 +  * [[trigger:​Subroutine|Subroutine trigger]] - when called from an [[action:​Execute_a_Subroutine|Execute Subroutine]] action. 
 +  ​* [[/trigger/Time_of_Day|Time of Day trigger]] – at a particular time of day.
   * [[/​trigger/​USB_Device_Key|USB Device Key trigger]] – when you press, hold, release or multi-tap any HID (Human Interface Device) device key.   * [[/​trigger/​USB_Device_Key|USB Device Key trigger]] – when you press, hold, release or multi-tap any HID (Human Interface Device) device key.
   * [[/​trigger/​USB_Device|USB Device trigger]] – when a USB device is attached or detached.   * [[/​trigger/​USB_Device|USB Device trigger]] – when a USB device is attached or detached.
 +  * [[trigger:​Unlock|Unlock trigger]] - when the Mac is unlocked.
   * [[/​trigger/​Wake|Wake trigger]] – when the system wakes from sleep.   * [[/​trigger/​Wake|Wake trigger]] – when the system wakes from sleep.
   * [[/​trigger/​Wireless_Network|Wireless Network trigger]] – when your Mac connects or disconnects to/from a wireless network.   * [[/​trigger/​Wireless_Network|Wireless Network trigger]] – when your Mac connects or disconnects to/from a wireless network.
-  * [[/​trigger/​iPhone|iPhone trigger]] – from your iPhone, iPod touch or iPad. 
   * [[/​trigger/​Script|Script trigger]] – from an AppleScript or other script.   * [[/​trigger/​Script|Script trigger]] – from an AppleScript or other script.
 +  * [[/​trigger/​keyboardmaestro|keyboardmaestro]] – from the keyboardmaestro CLI tool.
   * [[/​trigger/​URL|URL trigger]] – from an AppleScript or other script.   * [[/​trigger/​URL|URL trigger]] – from an AppleScript or other script.
 +
  
 ===== Actions ===== ===== Actions =====
  
 * You can create [[Macro Actions]] manually or by recording them. * You can create [[Macro Actions]] manually or by recording them.
 +* You can save preconfigured actions as favorites for reuse.
 * You can [[https://​www.stairways.com/​action/​linkthru?​thirdpartyactions|download]] or write your own [[Plug In Actions]]. * You can [[https://​www.stairways.com/​action/​linkthru?​thirdpartyactions|download]] or write your own [[Plug In Actions]].
 * There are [[:​Actions|many,​ many actions]] covering a broad range of facilities, including: * There are [[:​Actions|many,​ many actions]] covering a broad range of facilities, including:
-  * Plug In Third Party Actions +  * Plug In Third Party Actions. 
-  * Application Control actions to launch, activate, quit, show, hide, etc, applications. +  * Application Control actions to launch, activate, quit, show, hide, etcetera, applications. 
-  * Clipboard actions to set, read, delete, style, filter, search, replace, ​etc clipboards.+  * Clipboard actions to set, read, delete, style, filter, search, replace, ​etcetera ​clipboards.
   * Control Flow actions to pause, loop, test conditions, process sets of items, and more.   * Control Flow actions to pause, loop, test conditions, process sets of items, and more.
-  * Debugger actions to breakpoint, pause, step over, step into, etc, while debugging macros.+  * Debugger actions to breakpoint, pause, step over, step into, etcetera, while debugging macros.
   * Execute AppleScripts,​ shell scripts, JavaScript (for Automation or in Safari/​Chrome) and more.   * Execute AppleScripts,​ shell scripts, JavaScript (for Automation or in Safari/​Chrome) and more.
   * Read, write, trash, duplicate, append files, or get or set information about them.   * Read, write, trash, duplicate, append files, or get or set information about them.
   * Safari/​Chrome actions to work with the front web page, filling forms.   * Safari/​Chrome actions to work with the front web page, filling forms.
   * Image actions to find, capture, read, write, crop, annotate, or display images.   * Image actions to find, capture, read, write, crop, annotate, or display images.
-  * Interface actions to move or resize windows, click the mouse, type keystrokes, press buttons, ​etc.+  * Interface actions to move or resize windows, click the mouse, type keystrokes, press buttons, ​etcetera.
   * iTunes actions to play tracks, fast forward, rewind, change the volume and more.   * iTunes actions to play tracks, fast forward, rewind, change the volume and more.
-  * Actions to control Keyboard Maestro itself, enabling or disabling macros, showing and hiding palettes, ​etc.+  * Actions to control Keyboard Maestro itself, enabling or disabling macros, showing and hiding palettes, ​etcetera.
   * MIDI actions to send notes, control changes, or arbitrary packets.   * MIDI actions to send notes, control changes, or arbitrary packets.
-  * Send notifications via email, SMS, iMessage, notification center, sounds, alerts, ​etc.+  * Send notifications via email, SMS, iMessage, notification center, sounds, alerts, ​etcetera.
   * Open files, folders, URLs, system preferences,​ even 1Password bookmarks.   * Open files, folders, URLs, system preferences,​ even 1Password bookmarks.
   * QuickTime player actions to play movies, step forward or backward and more.   * QuickTime player actions to play movies, step forward or backward and more.
 +  * Actions to control a Stream Deck device.
   * Actions to launch applications,​ select windows, or switch clipboards.   * Actions to launch applications,​ select windows, or switch clipboards.
-  * Sleep, restart or shut down your Mac, Fast User Switch, log out, change brightness or volume, ​etc.+  * Sleep, restart or shut down your Mac, Fast User Switch, log out, change brightness or volume, ​etcetera.
   * Type or paste strings, speak text, work with variables or dictionaries.   * Type or paste strings, speak text, work with variables or dictionaries.
   * Perform calculations,​ prompt for information,​ read or write passwords from the Keychain and more.   * Perform calculations,​ prompt for information,​ read or write passwords from the Keychain and more.
-  * Web actions to search the web, download files, remotely trigger actions, ​etc.+  * Web actions to search the web, download files, remotely trigger actions, ​etcetera.
  
 Basically, if you can do it yourself, Keyboard Maestro can probably do it for you. Basically, if you can do it yourself, Keyboard Maestro can probably do it for you.
Line 96: Line 109:
 ===== Editor ===== ===== Editor =====
  
-Assistance ​system.+Dark Mode support. 
 +* Multiple editor windows. 
 +* Interactive Help system.
 * Large Text support. * Large Text support.
 * Basic Touch Bar support. * Basic Touch Bar support.
-* Smart Groups+* Smart Groups.
 * Select from recently triggered or edited macros. * Select from recently triggered or edited macros.
 * Autocompletion. * Autocompletion.
 * Integrated access to wiki help. * Integrated access to wiki help.
 * Rename, color, group, and add notes to actions. * Rename, color, group, and add notes to actions.
-* Palette Theme Editor+* Palette Theme Editor.
  
-===== Named and History ​Clipboard Switcher =====+===== Named Clipboard ​and Clipboard ​History ​Switcher =====
  
 * Never lose your clipboard again. * Never lose your clipboard again.
Line 136: Line 151:
 * Optionally hide other applications. * Optionally hide other applications.
 * Optionally always hide other applications. * Optionally always hide other applications.
- 
- 
manual/Features.1503371168.txt.gz · Last modified: 2017/08/21 23:06 by peternlewis