macressler / set-egpu

Display-agnostic acceleration of macOS applications using external GPUs.

Set-eGPU

Allows you to set graphics preferences for macOS applications, and force use of external GPUs, even on internal displays.

Requirements

This script requires the following specifications:

• Mac running external GPU
• macOS 10.13.4 or later

Usage

Install set-eGPU.sh:

curl -s "https://api.github.com/repos/mayankk2308/set-egpu/releases/latest" | grep '"browser_download_url":' | sed -E 's/.*"([^"]+)".*/\1/' | xargs curl -L -s -0 > set-eGPU.sh && chmod +x set-eGPU.sh && ./set-eGPU.sh && rm set-eGPU.sh

This will automatically install the latest version of set-eGPU.sh. Administrative privileges are required only for installation and software updates. All other script activity is performed in a user-privileged shell automatically.

Alternatively, download set-eGPU.sh. Then run the following in Terminal:

cd Downloads
chmod +x set-eGPU.sh
./set-eGPU.sh

On first-time use, the script will auto-install itself as a binary into /usr/local/bin/. This enables much simpler future use. To use the script again, just type the following in Terminal:

set-eGPU

It is worth noting that macOS Mojave uses a completely different and more potent mechanism for setting eGPU application preference, but is in beta stage. This script completely supports that mechanism, but due to Mojave being in beta, the underlying mechanism has bugs and other issues.

Options

Set-eGPU makes it super-easy to perform actions with an interactive menu, and is recommended for most users. Providing no arguments to the script defaults to the menu.

For advanced users that may sometimes prefer bypassing the menu, the script provides convenient arguments in an attempt to be as user-friendly as possible.

1. Set eGPU Preference for All Applications (-sa|--set-all)

Checks all available applications and sets their GPU preference to use eGPUs.

2. Set eGPU Preference for Specified Application(s) (-ss|--set-specified)

Checks specified application(s) and sets its GPU preference to use eGPUs.

3. Check Application eGPU Preference (-c|--check)

Reads specified application(s) GPU preferences.

4. Reset GPU Preferences for All Applications (-ra|--reset-all)

Resets GPU preferences to system defaults for all applications.

5. Reset GPU Preferences for Specified Application(s) (-rs|--reset-specified)

Recover original untouched macOS configuration prior to script modifications.

Testing

Run your application and check Activity Monitor > Window > GPU History (⌘ + 4) for GPU statistics.

License

See the license file for more information.

Donate

A thank you suffices, but for those kind souls who would love to contribute: