From EventGhost

Contents 1 Main Window 1.1 Menu Bar 1.1.1 File Menu 1.1.2 Edit Menu 1.1.3 View Menu 1.1.4 Configuration Menu 1.1.5 Help Menu 1.2 Tool Bar 1.3 Log 1.4 Configuration Tree 1.4.1 Containers 1.4.1.1 Autostart 1.4.1.2 Folders 1.4.1.3 Macros 1.4.2 Items 1.4.2.1 Plugins 1.4.2.2 Events 1.4.2.3 Actions 2 Adding Plugins 3 Creating Macros 3.1 Creating a New Macro Container 3.2 Adding Trigger Events 3.3 Adding Actions 4 Organizing Macros 5 Advanced Topics 5.1 State Macros 5.2 Enable/Disable Method 5.3 Enable Exclusive Method

[edit] Main Window

The main window consists of a Menu bar, Toolbar, Log panel, and a Configuration Tree panel.

[edit] Menu Bar

[edit] File Menu

[edit] Edit Menu

[edit] View Menu

[edit] Configuration Menu

[edit] Help Menu

[edit] Tool Bar

[edit] Log

The Log captures:

• All visible Events
• Executed Macros if enabled via the View->Log Macros menu item
• Executed Actions if enabled via the View->Log Actions menu item
• Errors
• The time of each Log entry if enabled via the View->Log Times menu item

The Log can be cleared via the View->Clear Log menu item.

NOTE: Logged Events can be dragged-and-dropped into Macros within the Configuration Tree.

[edit] Configuration Tree

The Configuration Tree contains the complete EventGhost configuration and is made up of Containers and Items.

All Containers and Items except Autostart can be enabled/disabled manually and by Actions.

[edit] Containers

[edit] Autostart

Autostart is a special Container that can hold Plugins to load and Actions to execute every time the Configuration Tree is loaded (eg EventGhost is started).

NOTE: There is always a single Autostart item in the Configuration Tree and it cannot be removed or disabled.

[edit] Folders

Folders are named containers that can hold Macros and/or more Folders. They are used to structure your configuration as you see fit.

[edit] Macros

Macros are named containers that can hold Events to trigger the Macro and Actions to execute when the Macro is triggered.

For example:

• You press the button labeled TV on your remote control.
• The Plugin for your remote sees that you pressed the TV button and generates a TV Event.
• Any active Macros that contain the TV Event are triggered and begin executing their Actions.

[edit] Items

[edit] Plugins

Plugins extend the functionality of EventGhost by generating Events and/or adding additional Actions.

NOTE: Plugins are always placed in the Autostart container.

[edit] Events

Events are the triggers that cause Macros to execute their Actions. They are generated by EventGhost and Plugins. Events generated by Plugins are usually prefixed with the Plugin's name, so if you were using an X10 remote in the example above, the X10 Remote Plugin would have generated an X10.TV Event.

[edit] Actions

Actions are the commands that are executed when a Macro is triggered by an Event. They are provided by EventGhost and Plugins.

[edit] Adding Plugins

Adding new Plugins to your configuration is very simple:

• Select the Edit->Add Plugin... menu item
• Select the Plugin you want to add from the list
• Click the OK button

The Plugin you selected will be added to the Autostart container and a dialog may appear to configure additional settings if needed.

See the List of Plugins for more details on the available Plugins.

[edit] Creating Macros

There are 3 steps to creating a new Macro:

1. Create a new Macro container
2. Add Trigger Events
3. Add Actions

[edit] Creating a New Macro Container

[edit] Adding Trigger Events

There are three ways you can assign trigger Events to a Macro:

1. Drag-and-drop an Event from the Log to an existing Macro in the Configuration Tree.
2. Select an Event in the Log and copy it to the clipboard using Ctrl+C, Right-Click->Copy, or Edit->Copy, then select an existing Macro in the Configuration Tree and paste the Event using Ctrl+V, Right-Click->Paste, or Edit->Paste.
3. Select an existing Macro in the Configuration Tree and then add a new Event using Right-Click->Add Event, Configuration->Add Event, or clicking the Add Event tool bar button.

NOTE: You can rename any existing Event by selecting it and pressing F2, or selecting Right-Click->Rename Item or Configuration->Rename Item, and typing the new Event name.

[edit] Adding Actions

[edit] Organizing Macros

• Global Macros
• Context Macros
• Context Folders

[edit] Advanced Topics

[edit] State Macros

[edit] Enable/Disable Method

[edit] Enable Exclusive Method