Skip to content

Display-agnostic acceleration of macOS applications using external GPUs.

License

Notifications You must be signed in to change notification settings

OskarGroth/set-egpu

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Header

macOS Support Github All Releases

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

The script provides users with a variety of options in an attempt to be as user-friendly as possible - as a numbered menu. Advanced users may pass arguments to bypass the menu.

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.

Image

License

See the license file for more information.

About

Display-agnostic acceleration of macOS applications using external GPUs.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Shell 100.0%