Differences

This shows you the differences between two versions of the page.

--- manual:Features [2017/08/22 03:01] – 8 peternlewis
+++ manual:Features [2023/09/21 08:13] (current) – [Triggers] peternlewis
@@ 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.
-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 you’ll wonder how you could have used your Mac without Keyboard Maestro.
 Here are some of the primary features of Keyboard Maestro.
@@ Line 16: / Line 16: @@
 ===== General =====
+* Use Dark Mode or Light Mode (10.14+).
 * 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.
@@ Line 24: / Line 25: @@
 * 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 windows.
@@ Line 36: / Line 38: @@
 * 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/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/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/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/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/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/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/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/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/Remote|Remote trigger]] – when you access a link on our trigger server.
   * [[/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|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/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/keyboardmaestro|keyboardmaestro]] – from the keyboardmaestro CLI tool.
   * [[/trigger/URL|URL trigger]] – from an AppleScript or other script.
 ===== Actions =====
 * 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]].
 * 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.
-  * 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.
   * 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.
   * 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.
-  * 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.
-  * 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.
   * 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.
-  * 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.
   * 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.
@@ Line 96: / Line 109: @@
 ===== Editor =====
-* Smart Groups
+* Dark Mode support.
-* Forward/Backward history of edited macros.
+* Multiple editor windows.
-* History of triggered macros.
+* Interactive Help system.
+* Large Text support.
+* Basic Touch Bar support.
+* Smart Groups.
+* Select from recently triggered or edited macros.
 * Autocompletion.
 * Integrated access to wiki help.
 * Rename, color, group, and add notes to actions.
-* Palette Theme Editor
+* Palette Theme Editor.
-===== Application Launcher =====
+===== Named Clipboard and Clipboard History Switcher =====
-* Display a Cover Flow view of available applications for quick selection.
+* Never lose your clipboard again.
-* Type ahead selection including abbreviations (eg "a p" for Adobe Photoshop).
+* Browse your past clipboards and paste any previous clipboard item.
+* An unlimited number of Named~~Clipboards.
+* Send clipboard entries to other Macs.
+* Clipboards display rich text and images.
+* Use Quick Look to view clipboard entries.
+* Apple Clipboard Filter triggered macros directly to selected clipboard entries.
+* Set clipboard entries as favorites so they are always available in your clipboard history.
+* Copy, Cut or Paste to/from Named~~Clipboards using a single keystroke.
+* Clipboard History is optionally saved across logins and restarts.
+* Named Clipboards are saved permanently.
-===== Application and Window Switcher =====
+===== Application and Window Launching and Switching =====
+* Display a Cover Flow view of available applications for quick launching.
 * Optionally replace the system Command-Tab application switcher.
 * Customize the switcher to match the look you want.
@@ Line 124: / Line 151: @@
 * Optionally hide other applications.
 * Optionally always hide other applications.
-===== Clipboard Switcher =====
-* An unlimited number of Named~~Clipboards.
-* Copy, Cut or Paste to/from Named~~Clipboards using a single keystroke.
-* Clipboards are saved permanently.
-===== Clipboard History Switcher =====
-* Never lose your clipboard again.
-* Browse your past clipboards and paste any previous clipboard item.
-* Send clipboard entries to other Macs.
-* Clipboards display rich text and images.
-* Use Quick Look to view clipboard entries.
-* Set clipboard entries as favorites so they are always available in your clipboard history.
-* Clipboard History is optionally saved across logins and restarts.