User Tools

Site Tools



Keyboard Maestro is a productivity enhancer with several main functions. It allows you to:

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 Macro is made of two parts: a set of Triggers you choose to determine when the macro is executed and a list of 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 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.


  • 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.
  • Use the included Assistance system to help if you get stuck.
  • Use the included Macro Debugger for detailed control of your macros in action.

Macro Groups

  • 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.
  • Macro Groups can be activated or deactivated with hot keys, or via the status menu or global macro palette.
  • Macro Groups can display a themed palette of contained macros.
  • Macro Groups can be enabled or disabled.
  • Customize the Macro Group icon by pasting an icon, or using the Icon Chooser and creator.
  • If you are syncing your macros, Macro Groups can be disabled on specific Macs.



  • You can create Macro Actions manually or by recording them.
  • You can save preconfigured actions as favorites for reuse.
  • You can download or write your own Plug In Actions.
  • There are many, many actions covering a broad range of facilities, including:
    • Plug In Third Party Actions.
    • Application Control actions to launch, activate, quit, show, hide, etcetera, applications.
    • 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, 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, 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, etcetera.
    • MIDI actions to send notes, control changes, or arbitrary packets.
    • 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, 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, etcetera.

Basically, if you can do it yourself, Keyboard Maestro can probably do it for you.


  • Dark Mode support.
  • Multiple editor windows.
  • 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.

Named Clipboard and Clipboard History Switcher

  • Never lose your clipboard again.
  • 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 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.
  • Switch to any application or window with a keystroke.
  • Switch to an application and hide all others.
  • Easily select the exact application or window you want.
  • Launch, hide, quit or force quit any application.
  • Close or minimize any window.
  • Quit (or force quit) and relaunch applications.
  • Get Info or reveal applications.
  • Choose the application ordering you want: alphabetically, by last use, or by launch order.
  • Sort windows alphabetically or by window depth order.
  • Optionally hide other applications.
  • Optionally always hide other applications.
manual/Features.txt · Last modified: 2023/09/21 04:13 by peternlewis