From EventGhost
Jump to: navigation, search

A macro is a collection of one or more actions that are activated in order. A macro is usually activated when triggered by an event, but it can also be triggered by another action.

Creating a Macro

Once you see the usefulness of macros, you will create many of them. You will find it easier to keep them all straight if you group related actions in different folders. Click the folder in which you want to create your macro. (If no folder is selected when you create your macro, it will be created at the root of your configuration tree.)

You can create a macro easily by clicking the Macro (Macro.png) button in the toolbar, or click the Configuration menu and select "Add Macro..." This will immediately create a macro named Macro.png<unnamed macro>, and then pop up a window for you to add a new action to the macro. If you add an action, the macro will be renamed after the action. You can also cancel the action creation if you wish, and the macro will remain.

Once you have created a macro, you can add any number of additional actions to it. The actions will be run in the order specified, one at a time.

Renaming a Macro

You may find it helpful to give your macro a more useful name. Changing a macro's name will not affect how it runs.

You can do this by clicking once on the macro in the configuration tree, waiting a moment, and then clicking on it again. (Alternately, you can right-click it, select "Rename Item".)

Disabling a Macro

You can right-click on a macro and select "Disable Item" to cause it to become disabled. Disabled items will have a red "X" over their icon. Disabled macros will never run, even if their associated events trigger -- and even if you select the macro and click the Execute Item (Autostart.png) button on the toolbar.

In addition, a macro is considered to be disabled if any of its parent folders is disabled, even if the macro itself is not disabled. Macros in disabled folders can still be run by clicking the Execute Item (Autostart.png) button on the toolbar, but they will not run when their event is triggered, nor when called by an action.

You can enable and disable macros and folders using any of these actions: Action.pngDisable Item, Action.pngEnable Item, Action.pngEnable Item Exclusively. This can be useful for changing EventGhost's behaviour based on specific events; for example, enabling application-specific hot-keys only when that application is running.

See Also