Setting up MarcoPolo's actions
Actions are triggered when MarcoPolo decides to change your context.
Each action has the following properties:
- A type,
- A parameter for the type of action,
- A context that it should be triggered for,
- When it should be triggered (upon Arrival or Departure),
- A delay between changing context and triggering the action,
- Whether it is enabled, and
- A description for human readability.
Most actions will be Arrival actions; that is, they will be triggered when MarcoPolo switches to that context. The alternative is a Departure action, which is triggered when MarcoPolo switches away from that action's context. In this case, the delay parameter will be the length of time from the action being triggered until the context is switched.
Actions of type DefaultPrinter change your computer's default printer.
Actions of type FirewallRule can enable or disable the network firewall for various services.
Actions of type iChat change your iChat status message.
Actions of type MailSMTPServer change the default SMTP server of your Mail.app accounts.
Actions of type Mount attempt to mount a network volume (afp://, smb://, etc.).
Actions of type Mute will mute or unmute your system audio.
Actions of type NetworkLocation will change your current Mac OS X Network Location.
Actions of type Open are the most general actions. Upon triggering, MarcoPolo will open that file: if it is an application, it will be launched; if it is an AppleScript, it will be executed; otherwise, it will be opened with that file's default application. This is roughly equivalent to double-clicking on that file in Finder.
Actions of type ScreenSaverPassword either enable or disable your screen saver's password.
Actions of type ScreenSaverTime can change the idle time before your screen saver activates.
Actions of type ShellScript allow you to execute arbitrary shell scripts using /bin/sh. Arguments may be passed to the script by using a pipe character ("|") as a separator in the parameter. (e.g. /path/to/script.sh|argument1|argument2)
ToggleBluetooth and ToggleWiFi actions
Actions of type ToggleBluetooth or ToggleWiFi allow you to control the power state of your computer's built-in Bluetooth and WiFi controllers.
Actions of type VPN can establish or disconnect from your default PPTP or L2TP VPN.