What are Triggers?


Triggers are criteria sets that cause a session to automatically start or end by itself. You define the criteria needed for a Trigger to automatically start. When your criterion is no longer met, the Trigger end the session it started. In order for a Trigger to start a new session, your Mac must already be awake. For instance, if you want your Mac to stay awake from 9:00 AM to 5:00 PM on weekdays, your Mac must already be awake at 9:00 AM. Amphetamine cannot wake a Mac that is already asleep.


Triggers can be set up in Amphetamine’s Preferences. Each Trigger you set up has is own set of criteria. If you have multiple Triggers configured, if any individual Trigger’s conditions are met, a new session will start (unless a session is already active).


Enabling/Disabling Triggers


You can disable all Triggers by unchecking the Enable Triggers box in Amphetamine’s Preferences. In Amphetamine 4, you can also disable each Trigger individually by deselecting the Enabled box next to each Trigger’s name in table displayed in Amphetamine’s Triggers preference tab. Note that if the global Enable Triggers box is unchecked, no Triggers will run even if the Enabled box is checked for a specific Trigger.

Creating New Triggers


Creating a new Trigger is super easy:


1. Open Amphetamine's Preferences

Click on Amphetamine’s icon in the system menu bar and select Preferences… . In Amphetamine’s Preferences Window, select the Triggers tab. Click the + button in lower left corner of the window and follow the prompts.


2. Give your Trigger a Name

Enter a memorable name for your Trigger. This will come in handy later on if you need to find your Trigger in the list for editing and if you have automatic session start/end notifications enabled.


3. Configure Display/Screen Saver Options

For each Trigger you create, you can choose to allow or disallow display sleep and/or the screen saver. These per-Trigger settings override the choices you have made in Amphetamine Preferences ➤ General for display sleep and screen saver.


4. Select criteria for your Trigger

Select up to 10 criteria for your Trigger. All criteria must be met for your Trigger to start a new session. 


Available criteria:


WiFi Network

Keep your Mac awake whenever it is connected to a specific WiFi network (uses SSID).


IP Address

Keep your Mac awake whenever your it has a specific IP address, or an IP address that falls within a defined range (via Ethernet or WiFi).


App

Keep your Mac awake whenever a specific app must be running on your Mac. You can additionally configure whether the Trigger requires the app to be frontmost (the active app).


Schedule

Keep your Mac awake whenever on a schedule (i.e. 9:00 AM - 5:00 PM). Note that your Mac must already be awake, and logged in to your user account with Amphetamine running for the Trigger to start a new session. To schedule your Mac to automatically wake from sleep, see this Apple support article; To configure your Mac to not require a password after waking from sleep, see this Apple support article(uncheck box for requiring password). 


Power

Keep your Mac awake based on its power conditions - by its battery charge level or AC/wall adapter connection status. Note that if your Mac does not have an internal battery (iMac, Mac mini, Mac Pro), this option will be disabled.


Display

Keep your Mac awake whenever there are a certain number of displays connected. If your Mac has a built-in display (iMac, Macbook Pro/Air), the built-in display will be included in the count.


Volume/Drive

Keep your Mac awake whenever specific external drives or volumes (including dmg files) are mounted.


USB Device

Keep your Mac awake whenever a specific USB device is connected to your Mac. To select a USB device, it must be connected to your Mac and powered on fully.


Bluetooth Device

Keep your Mac awake whenever a specific Bluetooth device is connected to your Mac. Note that only Bluetooth devices that have been paired and configured for use with your Mac, and which show up in  ➤ System Preferences ➤ Bluetooth ➤ Devicesare usable with this Trigger.


Audio Output

Keep your Mac awake based on which audio output is selected in  ➤ System Preferences ➤ Sound ➤ Output.


CPU Utilization

Keep your Mac awake when your Mac's CPU utilization is above a define threshold.


Idle Time

Keep your Mac awake when your Mac is inactive (no keyboard or mouse input) for a set amount of time.


5. Save

Click the Save button to save your new Trigger. Make sure you have enabled both the global Enable Triggers setting as well as the individual Enabled setting for your Trigger to run successfully.


Editing Triggers

To edit a Trigger, double click its name in the Trigger list. You will be asked to update the Trigger's name first. If you are happy with the existing name, click Continue. Depending on your Mac's configuration, some previously selected Trigger criteria may no longer be available. For instance, if you had set up a Trigger for when a specific USB device is connected to your Mac, and the device is no longer connected, your Trigger will automatically drop the USB device criteria. Double check all of your criteria before saving an edited Trigger. Use the Cancel button to exit Trigger editing without saving changes.


Deleting Triggers

To delete a Trigger, click to highlight it in the Trigger list. Then, click the minus button at the bottom left side of the list to delete the Trigger (this cannot be undone).





Have a question, suggestion, or need further assistance?

Click here to request support, provide feedback, or report an issue.


Love Amphetamine?

Please consider contributing to its development and/or its success.