Skip to content

Display-agnostic acceleration of macOS applications using external GPUs.

License

Notifications You must be signed in to change notification settings

SiHengTech01/set-egpu

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Header

macOS Support Github All Releases paypal

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

Note: Mojave has this built-in. For some reason, Mojave does not adhere to plist values anymore. For the time being, set-eGPU functionality will not affect apps on Mojave. This is odd even though it is documented in Mojave.

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

An update for macOS Mojave is currently under R&D. It will happen very soon.

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.

Set-eGPU 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.

Image

License

See the license file for more information.

Donate

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

paypal

About

Display-agnostic acceleration of macOS applications using external GPUs.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Shell 100.0%