Keyboard Maestro includes an Icon Chooser and creator to allow you to select custom icons for your macro groups and macros.

You can display the Icon Chooser by choosing Icon Chooser from the Window menu.

Click on an image well for a macro or macro group (in Edit mode), and then click on an icon in the Icon Chooser to select it.

The Icon Chooser includes three panes with different icons:

• Internal – all the icons Keyboard Maestro normally uses.
• Applications – all the icons Keyboard Maestro can find on your Mac.
• Character – icons you create based on a character.

The Character Icon Choose pane allows you to create your own custom icons by setting a few simple parameters.

You can set the background and foreground color, shape, and an optional character:

When you have a Macro or Macro Group icon well selected, and you make any change in the Icon Chooser, or if you click the icon in the Icon Chooser, then the icon for the Macro/Macro Group will be set.

To load the Icon Chooser from an existing Macro or Macro Group, select the icon well of the Macro/Macro Group and then open the Icon Chooser (close it first if necessary).

If not icon well is selected when you open the Icon Chooser then it will retain the settings that were last used.

Note that icons configured from the Icon Chooser will be very small in storage size in your macros. ⚠️ Icons set any other way (including copy & paste from another icon) will be much larger.

To transfer an Icon Chooser created icon from one macro to another, use this process:

• Close the Icon Chooser if it is open.
• Select the source icon well.
• Open the Icon Chooser - it will take on the characteristics of the source icon.
• Select the target icon well.
• Click on the icon in the Icon Chooser.