Awake is an application to keep your Mac awake while in clamshell mode (like Amphetamine).
(README syntax: [] denotes an optional argument, <> denotes a required argument)
To install both Awake and its dependency Base, you will need CMake. I recommend installing CMake via Homebrew. After installing CMake, Awake and Base can be downloaded via git or manually, and Awake can be built and installed with CMake.
Install Homebrew: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Install CMake: brew install [--cask] cmake
Get Awake's source code: cd </dir/to/put/Awake/> & git clone -b <version name> [--depth 1] https://github.com/Noah-Everett/Awake.git or download the latest release from here
Get Base's source code: cd </dir/to/put/Base/> & git clone -b v1.0.1 [--depth 1] https://github.com/Noah-Everett/Base.git or download v1.0.1 from here
Setup Base: source </path/to/Base/setup_base.sh>
Build Awake: cd </path/to/Awake/> & mkdir build && cd build & cmake -S ../ -B . & make
Install Awake: cmake --install . [--prefix "</path/to/install/dir/>"] (puts Awake executable in /usr/local/bin/ or wherever --prefix is set to)
Set the PASSWORD environment variable: echo 'export PASSWORD="<system password for sudo>"' >> ~/.zshrc & source ~/.zshrc
You're done! Awake should be installed and runnable in the terminal.
- Open
Shortcuts.app(should already be on your Mac) - Click the
+in the top of the window - In the top left of the window, set the shortcuts name to "Awake"
- In the search bar on the right, search for "Terminal" and double-click on "Run Shell Script"
- In the "Run Shell Script" window, change the
echo "Hello World"to~/.local/bin/awake -p <system password for sudo> - If you wish to pin the shortcut in the menu bar or make a keyboard shortcut, click the sliding bars button in the upper right and check the "Pin in Menu Bar" box or click the "Add Keyboard Shortcut" button to set a keyboard shortcut (recommended keyboard shortcut: ⌥⌘A)
You're done! Everything should be setup.
To run Awake, you can run awake from any directory in the terminal (if awake is installed in ~/.local/bin). For a help statement run awake -h or awake --help.
If running awake results in zsh: segmentation fault awake, make sure the PASSWORD environmental variable is set (~/.zshrc should contain export $PASSWORD="<password used for sudo>"). Alternatively, you can also run awake -p <system password for sudo> which does not require the PASSWORD environmental variable to be set.
To run the Awake shortcut, simply run the shortcut by either using a keyboard shortcut, through the menu bar, or in the Shortcut app. The program will terminate when the Mac stops charging or after 5 minutes of running.
NOTE: If the Mac was not charging when program was started the program will stop itself without any user involvement.
If you require any further assistance, feel free to contact me at NoahEverett898 \at Gmail.com.