Available Events and Parameters
EventScripts can pass information to both AppleScripts and shell scripts that provide more detail about the event that triggered the script. For AppleScripts these are passed as a record of properties, for shell scripts arguments are passed.
The tables below show the property names and arguments for all the events supported by EventScripts. Ensure your copy of EventScripts is up to date to get the complete list of events.
Example scripts demonstrating how the parameters are passed from EventScripts to both AppleScripts and shell scripts are available here.
| Mobile Events | AppleScript Record Properties | Shell Script Arguments |
|---|---|---|
| EventScripts Mobile | trigger scriptPath | $1$2 |
| EventScripts Mobile client found | trigger scriptPath | $1$2 |
| EventScripts Mobile client lost | trigger scriptPath | $1$2 |
| Location Events | AppleScript Record Properties | Shell Script Arguments |
|---|---|---|
| Location updated | trigger previousLatitude previousLongitude latitude longitude scriptPath | $1 $2 $3 $4 $5 $6 |
| Network Events | AppleScript Record Properties | Shell Script Arguments |
|---|---|---|
| Internet became available | trigger scriptPath | $1 $2 |
| Internet became unavailable | trigger scriptPath | $1 $2 |
| External IP changed | trigger previousAddress ipAddress scriptPath | $1 $2 $3 $4 |
| Wireless network changed | trigger SSID previousSSID BSSID scriptPath | $1 $2 $3 $4 $5 |
| Volume Events | AppleScript Record Properties | Shell Script Arguments |
|---|---|---|
| Volume mounted | trigger volumeName volumePath scriptPath | $1 $2 $3 $4 |
| Volume will unmount | trigger volumeName volumePath scriptPath | $1 $2 $3 $4 |
| Volume unmounted | trigger volumeName volumePath scriptPath | $1 $2 $3 $4 |
| Computer Events | AppleScript Record Properties | Shell Script Arguments |
|---|---|---|
| Computer will shutdown | triggerscriptPath | $1$2 |
| Computer will sleep | triggerscriptPath | $1$2 |
| Computer wakes | triggerscriptPath | $1$2 |
| General Events | AppleScript Record Properties | Shell Script Arguments |
|---|---|---|
| Screenshot taken | trigger screenshotName screenshotPath screenshotTypescriptPath | $1 $2 $3 $4 $5 |
| Desktop picture changed | trigger imagePathscriptPath | $1 $2 $3 |
| Spaces Events | AppleScript Record Properties | Shell Script Arguments |
|---|---|---|
| Spaces changed | triggerscriptPath | $1$2 |
| Entered fullscreen | trigger bundleCode applicationName applicationPath scriptPath | $1 $2 $3 $4 $5 |
| Download Events | AppleScript Record Properties | Shell Script Arguments |
|---|---|---|
| File Downloaded | trigger downloadedFilescriptPath | $1 $2 $3 |
| Apple Remote Events | AppleScript Record Properties | Shell Script Arguments |
|---|---|---|
| Apple Remote Up | trigger buttonHeldscriptPath | $1 $2 $3 |
| Apple Remote Down | trigger buttonHeldscriptPath | $1 $2 $3 |
| Apple Remote Left | trigger buttonHeldscriptPath | $1 $2 $3 |
| Apple Remote Right | trigger buttonHeldscriptPath | $1 $2 $3 |
| Apple Remote Center | trigger buttonHeldscriptPath | $1 $2 $3 |
| Apple Remote Play/Pause | trigger buttonHeldscriptPath | $1 $2 $3 |
| Apple Remote Menu | trigger buttonHeldscriptPath | $1 $2 $3 |
| Bluetooth Events | AppleScript Record Properties | Shell Script Arguments |
|---|---|---|
| Bluetooth became available | trigger scriptPath | $1 $2 |
| Bluetooth became unavailable | trigger scriptPath | $1 $2 |
| Bluetooth device found | trigger deviceName deviceAddress scriptPath | $1 $2 $3 $4 |
| Bluetooth device lost | trigger deviceName deviceAddress scriptPath | $1 $2 $3 $4 |
| Time Machine Events | AppleScript Record Properties | Shell Script Arguments |
|---|---|---|
| Time Machine backup completed | trigger backupPath scriptPath | $1 $2 $3 |
| Time Machine volume mounted | trigger backupVolume scriptPath | $1 $2 $3 |
| Screen Events | AppleScript Record Properties | Shell Script Arguments |
|---|---|---|
| Screensaver started | triggerscriptPath | $1$2 |
| Screensaver will stop | triggerscriptPath | $1$2 |
| Screensaver stopped | triggerscriptPath | $1$2 |
| Screen did sleep | triggerscriptPath | $1$2 |
| Screen did wake | triggerscriptPath | $1$2 |
| Screen password locked | triggerscriptPath | $1$2 |
| Screen password unlocked | triggerscriptPath | $1$2 |
| Application Events | AppleScript Record Properties | Shell Script Arguments |
|---|---|---|
| Application will launch | trigger bundleCode applicationName applicationPath scriptPath | $1 $2 $3 $4 $5 |
| Application launched | trigger bundleCode applicationName applicationPath scriptPath | $1 $2 $3 $4 $5 |
| Application quit | trigger bundleCode applicationName applicationPath scriptPath | $1 $2 $3 $4 $5 |
| Browser Events | AppleScript Record Properties | Shell Script Arguments |
|---|---|---|
| Safari will launch | trigger bundleCode applicationName applicationPath scriptPath | $1 $2 $3 $4 $5 |
| Safari launched | trigger bundleCode applicationName applicationPath scriptPath | $1 $2 $3 $4 $5 |
| Safari quit | trigger bundleCode applicationName applicationPath scriptPath | $1 $2 $3 $4 $5 |
| Firefox will launch | trigger bundleCode applicationName applicationPath scriptPath | $1 $2 $3 $4 $5 |
| Firefox launched | trigger bundleCode applicationName applicationPath scriptPath | $1 $2 $3 $4 $5 |
| Firefox quit | trigger bundleCode applicationName applicationPath scriptPath | $1 $2 $3 $4 $5 |
| Google Chrome will launch | trigger bundleCode applicationName applicationPath scriptPath | $1 $2 $3 $4 $5 |
| Google Chrome launched | trigger bundleCode applicationName applicationPath scriptPath | $1 $2 $3 $4 $5 |
| Google Chrome quit | trigger bundleCode applicationName applicationPath scriptPath | $1 $2 $3 $4 $5 |
| iTunes Events | AppleScript Record Properties | Shell Script Arguments |
|---|---|---|
| iTunes track changed | trigger album track artist scriptPath | $1 $2 $3 $4 $5 |
| iTunes will launch | trigger bundleCode applicationName applicationPath scriptPath | $1 $2 $3 $4 $5 |
| iTunes launched | trigger bundleCode applicationName applicationPath scriptPath | $1 $2 $3 $4 $5 |
| iTunes quit | trigger bundleCode applicationName applicationPath scriptPath | $1 $2 $3 $4 $5 |
Download Example Scripts