EventScripts

EventScripts allows you to assign either AppleScripts or shell scripts to be executed when certain events occur. The full list of events can be seen here. EventScripts displays in the menu bar, and can be configured via the EventScripts Preferences menu item.

EventScripts Preferences

Scripts can be configured from the "EventScripts" pane of the preferences.

Drag and drop scripts to add or reorder them in the table

Use the popup menu to choose the event to trigger the script

Temporarily disable scripts by unchecking the "Active" checkbox

Double click a script to open it in the default editor

There are no special requirements for scripts executed by EventScripts, however when scripts are executed by EventScripts they are passed parameters about the event. If you want to take advantage of any of those parameters, please check out the following pages with examples, and a list of the parameters passed for each event.

General Preferences

In the general preference pane we can configure the following options.

Automatically launch EventScripts when you login

Permit EventScripts to monitor your location
(required for the location updated event)

Show the names of the scripts actively monitoring events in the EventScripts menu bar item

Suppress the EventScript's error dialog which is shown if your AppleScript or shell script fails to execute correctly

Remote Preferences

Here we can turn on and off Apple Remote monitoring. There are two modes here:

Shared mode where EventScripts responds to Apple Remote commands but doesn't prevent other applications (such as iTunes, EyeTV, etc) from responding to them.

Exclusive mode where EventScripts alone will respond to Apple Remote commands.

If the remote status stays red, and reports "Receiver busy" when you turn on Apple Remote monitoring, then there is most likely another application with an exclusive lock on the IR receiver. Plex does this, for example, if you set remote behaviour to be "Always running".

If the remote status is green, but EventScripts still does not respond to Apple Remote events, check that you haven't disabled IR remotes in the Security pref pane of the System preferences.

Bluetooth Preferences

EventScripts can trigger scripts based on the proximity of multiple Bluetooth devices. Scripts can be triggered when devices are 'found' and 'lost'. In the bluetooth preference you can select which devices to monitor. Devices must be 'discoverable' in order to be selected for monitoring but once selected they do not have to stay in discoverable mode in order to trigger lost and found bluetooth events.

In this pane you may also:

Enable and disable bluetooth monitoring

Untick the active checkbox to temporarily disable monitoring of a specific device

Modify the number of times a device must fail to respond before it is considered lost

Server Preferences

You can enable the EventScript server in the server preferences. With the server running you can use EventScripts Mobile to trigger scripts on your Mac from your iPhone, iPad or iPod touch by setting them to use the "EventScripts Mobile" event. The server broadcasts itself on your bonjour network.

Notification Preferences

Growl and Mist

By default EventScripts will use Growl (or if you don't have Growl installed Mist) to notify you of script execution results.

There are four kinds of notification provided by EventScripts. With Growl installed you can configure which notifications you receive, without Growl you just receive the default notifications

All Available Events
(a notification is displayed when any event monitored by EventScripts occurs)

Information (default)

Script Execution Success notifications (default)

Script Execution Failure notifications (default)

Prowl Support

In addition, you can configure EventScripts to send a notification to the iOS app Prowl directly when scripts are executed. To do this you need a Prowl API key to do this, but these are free to registered users. It's also possible to configure Growl to send on notifications to Prowl.