How do I Change Amphetamine’s Preferences?

Amphetamine is highly customizable. After opening Amphetamine’s menu, choose Preferences… from the menu. The following is an overview of the available options in Amphetamine’s Preferences.


General

The General preference pane contains an assortment of options that do not fit into any of the other preferences categories.


  • A: Used throughout Amphetamine where a distinct session duration is not supplied. For example, if you have a session start automatically at launch, this duration will be used. Most, if not all, places where this duration is used are clearly marked.
  • B: Controls the behavior when you left or right click Amphetamine’s icon/image in the system menu bar. Mac users unfamiliar with how to right click on a Mac should refer to this Apple support article.
  • C: Allows compatible displays to sleep while a session is running.
  • D: Start Screen Saver after: Starts the screen saver select in System Preferences after the specified duration of inactivity.
  • E: When enabled, Amphetamine will automatically launch whenever you log in to your user account. Note that Amphetamine will not appear under Login Items in System Preferences ➤ Users & Groups ➤ Login Items. This is a bug in macOS that affects all Mac App Store apps.
  • F: Start Session when Amphetamine Launches: When enabled, Amphetamine will start a new session using the default duration immediately after it launches.
  • G: When enabled, Amphetamine will start a new session using the default duration immediately after your Mac wakes from sleep.
  • H: When enabled, Amphetamine’s icon will not appear in the system Dock, along the side or bottom of your screen (location dependent on how your Mac is configured)
  • I : This will reset any of the choices you have made for Amphetamine to stop presenting messages about various actions/topics/issues so that you can see them again
  • J: This will delete all Amphetamine’s preferences and restore them to their default values.

Power

The Power preference pane contains options for controlling Amphetamine’s behavior when your Mac is running on battery power or AC power (via its charger). If you have an iMac, Mac Pro, Mac mini, or  aa portable/laptop Mac with no battery installed, these options will not be available.


  • A: Amphetamine can end any non-Trigger sessions automatically if your Mac’s battery is below the set threshold.
  • B: Enabling Always Ask Before Ending a Session will ensure that you are always prompted to confirm ending the session.
  • C: Enable to have Amphetamine ignore the battery level (charge %) when your Mac’s power adapter is connected.
  • D: Enable to have Amphetamine start a new session if the previous session ended because of a low battery %.

Triggers

The Triggers preferences is where you configure Triggers, one of Amphetamine’s most powerful features. Read more about Triggers here ****.


  • A: Check to enable the Triggers feature.
  • B: Trigger names appear here. Double click a Trigger’s name to edit the Trigger.
  • C: Enable/disable individual Triggers by checking or unchecking this box, next to each Trigger’s name.
  • D: Click + to add a new Trigger; Click - to delete the selected Trigger.

Drive Alive

The Drive Alive preference pane is where you configure Drive Alive, another one of Amphetamine’s powerful features. Drive Alive can keep your connected drives (HDs, SSDs) awake. Read more about Drive Alive here.


  • A: Check to enable the Drive Alive feature.
  • B: The names of drives configured for Drive alive names appear here.
  • C: Check to always keep this drive alive, even when Amphetamine does not have an active session. Note that 1) if your Mac falls asleep, Amphetamine will not keep your drive alive, and 2) Amphetamine must be running to keep your drive alive.
  • D: Click + to add a new drive, click - to remove the selected drive.
  • E: Choose the interval that Amphetamine will use to wake your drives.

Hot Keys

The Hot Keys preference pane contains options for controlling some of Amphetamine’s features with keyboard shortcuts (a.k.a. hot keys). Click to record a hot key/keyboard shortcut. To delete an existing hot key, click the X button that appears on the right side of the “recorder box" (A, C, E, F).


  • A: Click to record a hot key/keyboard shortcut. To delete an existing hot key, click the X button that appears on the right side of the “recorder box.”
  • B: When a session is already running/active, chose whether to end the session or start a new one using the Default Duration (See General Preferences section for more about Default Duration).
  • C: Start a new session with the specified duration (D).
  • D: The duration used for the previous hot key (C).
  • E: End a session using a hot key.
  • F: This hot key will show Amphetamine's menu in the system menu bar. This allows you to use keyboard navigation to select a duration or adjust Quick Preferences without having to use a mouse or trackpad.

Notifications

The Notifications preference pane contains options for how Amphetamine communications various messages and session status updates.


  • A: Deliver a reminder notification on a regular interval during a running session. The purpose of this notification is to remind you that a session is running and keeping your Mac awake.
  • B: When checked, this enables notifications for when sessions automatically start e.g. via Trigger or AppleScript.
  • C: When checked, this enables notifications for when sessions automatically end e.g. via Trigger or AppleScript.
  • D: When checked, this enables sound playback whenever a notification is sent.
  • E: The sound that will play (if D is checked), when a session automatically starts
  • F: The sound that will play (if D is checked), when a session automatically ends
  • G: Over the course of a day or more, Amphetamine can deliver quite a number of notifications, depending on how you use Amphetamine. Check this box to enable automatic removal of “old” Amphetamine notifications.

Appearance

The Appearance preference pane contains options that control how Amphetamine appears, including its system menu bar icon.


  • A: Choose the image used in the system menu bar to denote the current session status (active/inactive).
  • B: When checked, if there is no active session, the inactive image will appear disabled, or slightly transparent.
  • C: When checked, the time remaining in a session will appear in the system menu bar. If the session does not have a definitive amount of time remaining, the following symbols will appear:
    • Indefinite session:

    • Running app session: A

    • Trigger session: T

    • Date/Time session: 

    • File download session: 

  • D: Choose whether the session time remaining displays in the 12-hour or 24 hours format (e.g. 1:00 PM vs 13:00).
  • E: Choose whether the session time remaining displays h, m, & s markers to indicate hours, minutes, and seconds.
  • F: Choose the font size used for the session time remaining
  • G: When checked, additional details about the active session will appear in Amphetamine’s menu in the system menu bar.
  • H: When checked, additional details about Drive Alive drives will appear in Amphetamine’s menu in the system menu bar.




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.