开源软件名称（OpenSource Name）：

开源软件地址(OpenSource Url)：

开源编程语言(OpenSource Language)：

开源软件介绍(OpenSource Introduction)：

set-eGPU.sh allows you to set graphics preferences for macOS applications, and force use of external GPUs, even on internal displays. Please read through the entire documentation to familiarize yourself with the script, the community, and the resources available to you in case you find that you need help.

Contents

A quick run-through of what's included in this document:

• Pre-Requisites
  • macOS requirements, pre-system configuration specifics, and more.
• Installation
  • Installing and running the script.
• Script Options
  • Available capabilities and options in the script.
• Post-Install
  • System configuration after script installation and some other things of note.
• Troubleshooting
  • Additional resources and guides for eGPUs.
• Disclaimer
  • Please read the disclaimer before using this script.
• License
  • By using this script, you consent to the license that the script comes bundled with.
• Support
  • Support the developer if you'd like to.

Pre Requisites

Please read Apple's external GPU documentation first to see what is already supported on macOS. The following is a table that summarizes system requirements for using this script:

Installation

set-eGPU.sh auto-manages itself and provides multiple installation and uninstallation options. Once the pre-requisites are satisfied, install the script by running the following in Terminal:

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

For future use, only the following will be required:

set-eGPU

In case the command above does not work, you can re-use the long installation command and fix the issue.

Administrative privileges are required only for installation and software updates. The script uses sudo to do so. All other script activity is performed in a user-privileged shell automatically.

The script includes a built-in uninstallation mechanism.

Aside

Some applications, such as Photos do not have the option to "Prefer External GPU" in macOS 10.14+. Due to this, you may see a message saying that not all preferences were updated. This is not a big problem. A future update to set-eGPU will more appropriately handle such edge cases.

Script Options

Set-eGPU makes it super-simple to automate eGPU preference management through a variety of options via an interactive menu. Providing no arguments defaults to the menu. The documentation represents v2.0.0 or later.

Post-Install

After installing the script, you likely will not need it again unless you want to manage new apps. Most settings should be permanent. If you upgraded from High Sierra to Mojave or later, you will need to set preferences again, since the mechanism has significant changes after High Sierra.

Troubleshooting

Check if your application is using the eGPU using Activity Monitor before reading further. Troubleshooting plays an important role with eGPUs. New OSes and hardware tend to bring with them new problems and challenges. Even though eGPU support in macOS has become straightforward, not all applications may work as expected. The following is a list of additional resources rich in information:

My username on both communities is @mac_editor. Feel free to mention my username on eGPU.io posts - I get an email notifying me of the same. In any case, with thousands of members, the community is a welcoming place. Don't be shy!

Disclaimer

This script does not make any dangerous/fatal system modifications and only automates some features in macOS. However, the developer is not liable for any damages to your system nonetheless.

License

The bundled license allows commercial use and redistribution as advised under the MIT License. This software comes without any warranty or guaranteed support. By using the script, you agree to adhere to this license. For more information, please see the LICENSE.

Support

If you loved set-eGPU.sh, consider starring the repository or if you would like to, donate via PayPal:

Thank you for using set-eGPU.sh. This project is under active development at this time.