EventScripts Events

Mobile & Location Events

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. Example scripts demonstrating how the parameters are passed from EventScripts to both AppleScripts and shell scripts are available here.

Search:

Event	Category	AppleScript Record Properties	Shell Script Arguments
EventScripts Mobile	Mobile Events	trigger scriptPath tagName	$1 $2 $3
EventScripts Mobile client found	Mobile Events	trigger scriptPath tagName	$1 $2 $3
EventScripts Mobile client lost	Mobile Events	trigger scriptPath tagName	$1 $2 $3
Location updated	Location Events	trigger previousLatitude previousLongitude latitude longitude scriptPath tagName	$1 $2 $3 $4 $5 $6 $7

Showing entries (filtered from total entries)

Application & Browser Events

These events are triggered by application launches and quits
'Background application launched' is an event triggered by background applications that don't appear in the Dock, such as 'screenshot' in Big Sur and above

Search:

Event	Category	AppleScript Record Properties	Shell Script Arguments
Application activated	Application Events	trigger bundleCode applicationName applicationPath processIdentifier scriptPath tagName	$1 $2 $3 $4 $5 $6 $7
Application deactivated	Application Events	trigger bundleCode applicationName applicationPath processIdentifier scriptPath tagName	$1 $2 $3 $4 $5 $6 $7
Application will launch	Application Events	trigger bundleCode applicationName applicationPath processIdentifier scriptPath tagName	$1 $2 $3 $4 $5 $6 $7
Application launched	Application Events	trigger bundleCode applicationName applicationPath processIdentifier scriptPath tagName	$1 $2 $3 $4 $5 $6 $7
Application quit	Application Events	trigger bundleCode applicationName applicationPath processIdentifier scriptPath tagName	$1 $2 $3 $4 $5 $6 $7
EventScripts launched	Application Events	trigger bundleCode applicationName applicationPath processIdentifier scriptPath tagName	$1 $2 $3 $4 $5 $6 $7
EventScripts quit	Application Events	trigger bundleCode applicationName applicationPath processIdentifier scriptPath tagName	$1 $2 $3 $4 $5 $6 $7
Safari will launch	Browser Events	trigger bundleCode applicationName applicationPath processIdentifier scriptPath tagName	$1 $2 $3 $4 $5 $6 $7
Safari launched	Browser Events	trigger bundleCode applicationName applicationPath processIdentifier scriptPath tagName	$1 $2 $3 $4 $5 $6 $7
Safari quit	Browser Events	trigger bundleCode applicationName applicationPath processIdentifier scriptPath tagName	$1 $2 $3 $4 $5 $6 $7
Firefox will launch	Browser Events	trigger bundleCode applicationName applicationPath processIdentifier scriptPath tagName	$1 $2 $3 $4 $5 $6 $7
Firefox launched	Browser Events	trigger bundleCode applicationName applicationPath processIdentifier scriptPath tagName	$1 $2 $3 $4 $5 $6 $7
Firefox quit	Browser Events	trigger bundleCode applicationName applicationPath processIdentifier scriptPath tagName	$1 $2 $3 $4 $5 $6 $7
Google Chrome will launch	Browser Events	trigger bundleCode applicationName applicationPath processIdentifier scriptPath tagName	$1 $2 $3 $4 $5 $6 $7
Google Chrome launched	Browser Events	trigger bundleCode applicationName applicationPath processIdentifier scriptPath tagName	$1 $2 $3 $4 $5 $6 $7
Google Chrome quit	Browser Events	trigger bundleCode applicationName applicationPath processIdentifier scriptPath tagName	$1 $2 $3 $4 $5 $6 $7
Background application launched	Application Events	trigger bundleCode applicationName applicationPath processIdentifier scriptPath tagName	$1 $2 $3 $4 $5 $6 $7

Showing entries (filtered from total entries)

Network Events

Events triggered by changes to your network connection or connectivity

Search:

Event	Category	AppleScript Record Properties	Shell Script Arguments
Internet became available	Network Events	trigger scriptPath tagName	$1 $2 $3
Internet became unavailable	Network Events	trigger scriptPath tagName	$1 $2 $3
External IP address changed	Network Events	trigger previousAddress ipAddress scriptPath tagName	$1 $2 $3 $4 $5
Wireless network changed	Network Events	trigger SSID previousSSID BSSID scriptPath tagName	$1 $2 $3 $4 $5 $6

Showing entries (filtered from total entries)

Volume, USB & Time Machine Events

The volume events are triggered before and after OS X mounts an external volume or server. The volume name and path is supplied to any scripts EventScripts executes. The USB events are triggered as devices are added and removed. The passed parameters include the USB device name.

Search:

Event	Category	AppleScript Record Properties	Shell Script Arguments
Volume mounted	Volume Events	trigger volumeName volumePath scriptPath tagName	$1 $2 $3 $4 $5
Volume will unmount	Volume Events	trigger volumeName volumePath scriptPath tagName	$1 $2 $3 $4 $5
Volume unmounted	Volume Events	trigger volumeName volumePath scriptPath tagName	$1 $2 $3 $4 $5
USB device attached	USB Events	trigger deviceName scriptPath tagName	$1 $2 $3 $4
USB device removed	USB Events	trigger deviceName scriptPath tagName	$1 $2 $3 $4
Time Machine backup completed	Time Machine Events	trigger backupPath scriptPath tagName	$1 $2 $3 $4
Time Machine volume mounted	Time Machine Events	trigger backupVolume scriptPath tagName	$1 $2 $3 $4

Showing entries (filtered from total entries)

Apple Music Events

Triggered by changes in the Music application

Search:

Event	Category	AppleScript Record Properties	Shell Script Arguments
Music track changed	Music Events	trigger album track artist scriptPath tagName	$1 $2 $3 $4 $5 $6
Music will launch	Music Events	trigger bundleCode applicationName applicationPath scriptPath tagName	$1 $2 $3 $4 $5 $6
Music launched	Music Events	trigger bundleCode applicationName applicationPath scriptPath tagName	$1 $2 $3 $4 $5 $6
Music quit	Music Events	trigger bundleCode applicationName applicationPath scriptPath tagName	$1 $2 $3 $4 $5 $6

Showing entries (filtered from total entries)

Apple Remote Events

If you Mac can be controlled by an Apple Remote, then you can use it to trigger scripts with EventScripts. These events are powered by the excellent framework from iospirit, makers of Remote Buddy. If you need sophisticated control via an Apple remote, use Remote Buddy.

Search:

Event	Category	AppleScript Record Properties	Shell Script Arguments
Apple Remote Up	Remote Events	trigger buttonHeld scriptPath tagName	$1 $2 $3 $4
Apple Remote Down	Remote Events	trigger buttonHeld scriptPath tagName	$1 $2 $3 $4
Apple Remote Left	Remote Events	trigger buttonHeld scriptPath tagName	$1 $2 $3 $4
Apple Remote Right	Remote Events	trigger buttonHeld scriptPath tagName	$1 $2 $3 $4
Apple Remote Center	Remote Events	trigger buttonHeld scriptPath tagName	$1 $2 $3 $4
Apple Remote Play/Pause	Remote Events	trigger buttonHeld scriptPath tagName	$1 $2 $3 $4
Apple Remote Menu	Remote Events	trigger buttonHeld scriptPath tagName	$1 $2 $3 $4

Showing entries (filtered from total entries)

Bluetooth Events

Triggered by monitored Bluetooth devices and iBeacons

Search:

Event	Category	AppleScript Record Properties	Shell Script Arguments
Bluetooth became available	Bluetooth Events	trigger scriptPath tagName	$1 $2 $3
Bluetooth became unavailable	Bluetooth Events	trigger scriptPath tagName	$1 $2 $3
Bluetooth device found	Bluetooth Events	trigger deviceName deviceAddress scriptPath tagName	$1 $2 $3 $4 $5
Bluetooth device lost	Bluetooth Events	trigger deviceName deviceAddress scriptPath tagName	$1 $2 $3 $4 $5
iBeacon found	iBeacon Events	trigger uuid deviceUUID scriptPath tagName	$1 $2 $3 $4 $5
iBeacon lost	iBeacon Events	trigger uuid deviceUUID scriptPath tagName	$1 $2 $3 $4 $5

Showing entries (filtered from total entries)

Google Home & Chromecast Events

These events are triggered as EventScripts notices these devices becoming available, unavailable and as their activity changes. Parameters include 'activity' which lets you know what the device is currently doing. Note that 'name' and 'host' are reserved words in AppleScript and should be wrapped in braces, as below, when referencing the event record.

Search:

Event	Category	AppleScript Record Properties	Shell Script Arguments
Chromecast found	Chromecast Events	trigger \|host\| identifier address model \|name\| activity scriptPath tagName	$1 $2 $3 $4 $5 $6 $7 $8 $9
Chromecast lost	Chromecast Events	trigger \|host\| identifier address model \|name\| activity scriptPath tagName	$1 $2 $3 $4 $5 $6 $7 $8 $9
Chromecast activity	Chromecast Events	trigger \|host\| identifier address model \|name\| activity scriptPath tagName	$1 $2 $3 $4 $5 $6 $7 $8 $9

Showing entries (filtered from total entries)

Computer & Power Events

These events let you trigger scripts when your computer sleeps, wakes and is shutdown. The Computer will sleep attempts to delay sleep to allow the script to be executed, but ultimately does not prevent sleeping. If you are only after an application to trigger scripts when your computer is put to sleep, then check out SleepWatcher for a free alternative to EventScripts.

The Power switched to battery event is only appropriate to MacBooks. The other two events should also be triggered on desktops if you swap between mains power and a UPS system that is recognised natively by Mac OS X.

Search:

Event	Category	AppleScript Record Properties	Shell Script Arguments
Computer will shutdown	Computer Events	trigger scriptPath tagName	$1 $2 $3
Computer will sleep	Computer Events	trigger scriptPath tagName	$1 $2 $3
Computer wakes	Computer Events	trigger scriptPath tagName	$1 $2 $3
Power switched to mains	Power Events	trigger scriptPath tagName	$1 $2 $3
Power switched to battery	Power Events	trigger scriptPath tagName	$1 $2 $3
Power switched to UPS	Power Events	trigger scriptPath tagName	$1 $2 $3

Showing entries (filtered from total entries)

Screen Events

Events triggered by changes to your screen setup, including fast user switching in and out of your active workspace.

Search:

Event	Category	AppleScript Record Properties	Shell Script Arguments
Screensaver started	Screen Events	trigger scriptPath tagName	$1 $2 $3
Screensaver will stop	Screen Events	trigger scriptPath tagName	$1 $2 $3
Screensaver stopped	Screen Events	trigger scriptPath tagName	$1 $2 $3
Screen did sleep	Screen Events	trigger scriptPath tagName	$1 $2 $3
Screen did wake	Screen Events	trigger scriptPath tagName	$1 $2 $3
Screen password locked	Screen Events	trigger scriptPath tagName	$1 $2 $3
Screen password unlocked	Screen Events	trigger scriptPath tagName	$1 $2 $3
Screen was added	Screen Events	trigger scriptPath tagName	$1 $2 $3
Screen was removed	Screen Events	trigger scriptPath tagName	$1 $2 $3
Screen configuration changed	Screen Events	trigger scriptPath tagName	$1 $2 $3
Spaces changed	Screen Events	trigger bundleCode applicationName applicationPath scriptPath tagName	$1 $2 $3 $4 $5 $6
Entered fullscreen	Screen Events	trigger bundleCode applicationName applicationPath scriptPath tagName	$1 $2 $3 $4 $5 $6
Exited fullscreen	Screen Events	trigger bundleCode applicationName applicationPath scriptPath tagName	$1 $2 $3 $4 $5 $6
Fast user switch in	Screen Events	trigger userName fullUserName scriptPath tagName	$1 $2 $3 $4 $5
Fast user switch out	Screen Events	trigger userName fullUserName scriptPath tagName	$1 $2 $3 $4 $5

Showing entries (filtered from total entries)

Miscellaneous Events

Audio events only cover in-built Apple audio hardware.

Motion detection requires an inbuilt Apple iSight camera,

Many applications (Safari, Transmission, etc.) post notifications to let the system know that a file has been downloaded. You can trigger events when EventScripts hears these notifications with the download event.

Search:

Event	Category	AppleScript Record Properties	Shell Script Arguments
Headphones connected	Audio Events	trigger scriptPath tagName	$1 $2 $3
Headphones disconnected	Audio Events	trigger scriptPath tagName	$1 $2 $3
File Downloaded	Download Events	trigger bundleCode applicationName applicationPath scriptPath tagName	$1 $2 $3 $4 $5 $6
Screenshot taken	Misc Events	trigger screenshotName screenshotPath screenshotType scriptPath tagName	$1 $2 $3 $4 $5 $6
Desktop picture changed	Misc Events	trigger imagePath scriptPath tagName	$1 $2 $3 $4
Motion detected	Misc Events	trigger scriptPath tagName	$1 $2 $3
AirPlay became available	Audio Events	trigger scriptPath tagName	$1 $2 $3
AirPlay became unavailable	Audio Events	trigger scriptPath tagName	$1 $2 $3

Showing entries (filtered from total entries)

‌

AI Website Maker