EventScripts Icon


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
  • Use the contextual menu to apply a 'tag' to scripts.
    These can be used to organise the scripts in EventScripts Mobile.
  • 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
  • Control how much EventScripts logs to the Console. Verbose logging is useful for debugging.
  • 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
  • Configure the range at which the lost or found action is triggered
  • 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.

    Tags Preferences

    Tags are useful as they allow you to organise scripts in EventScripts Mobile. You may create, name and select a colour for tags in this preference pane. Once created tags can be applied to scripts in the main EventScripts preference pane using the contextual menu.

    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.