Browse the docs

Choose a macro to run

Shows a list of macros, then runs the one you pick.

Choose a macro to run from macros

Keyboard Maestro: Trigger Macro by Name, Show Palette of Macros

Details #

Shows a list window of macro names, waits for you to pick one, then runs it as if by Run macro. The step's output is then the result of that run.

Which macros are listed:

  • With macros, only those. Give ids or names. Entries that match no macro are left out.

  • Without it, every macro that can be listed.

With run set to false, nothing runs: the step only returns the chosen name. If you also set into, the macro's name goes into that variable.

Parameters #

ParameterTypeRequiredValuesWhat it does
intotextThe variable that receives the chosen macro's name.
macroslist of textIds or names of the macros to offer.
runyes / noRun the chosen macro. Default true.
titletextThe list window's title. Default "Macros".

Every step also accepts label, onFailure, timeout and dryRunSafe.

Examples #

Pick a macro and show its name without running it
Do
  1. Choose a macro to run
  2. Show “You picked {{ chosen }}” for 2 s
Open in Switchboard to try it

Gotchas #

  • With no macros to list, the step fails with "there are no macros to choose from".

  • Closing the list fails the step with "cancelled by you".

  • In a dry run nothing is asked. The first macro in the list is chosen and nothing runs.

  • The chosen macro runs under the usual rules of Run macro, so a macro that is disabled or missing fails there.

See also #

Run macro, Ask for input, Choose a file or folder