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).
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.
Keep your Mac awake whenever it is connected to a specific WiFi network (uses SSID).
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).
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).
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).
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.
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.
Keep your Mac awake whenever specific external drives or volumes (including dmg files) are mounted.
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.
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 ➤ Devices are usable with this Trigger.
Keep your Mac awake based on which audio output is selected in ➤ System Preferences ➤ Sound ➤ Output.
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.
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.
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.
Please consider contributing to its development and/or its success.