0xbb / gpu-switch

gpu-switch is an application that allows to switch between the graphic cards of dual-GPU Macbook Pro models
MIT License
543 stars 58 forks source link

gpu-switch

gpu-switch is an application to switch between the integrated and dedicated GPU of dual-GPU MacBook Pro models for the next reboot.

It aims to remove the need of booting into OS X and running gfxCardStatus v2.2.1 to switch to the integrated card.

Warning:

This is new code and it comes without any warranty! It's completely based on reverse engineering. Therefore use it at your own risk and don't blame us if anything breaks.

Linux Usage:

As root you can select the GPU by running gpu-switch and rebooting your machine:

switch to the integrated GPU:

# ./gpu-switch -i

switch to the dedicated GPU:

# ./gpu-switch -d

OS X Usage:

WARNING: broken on macOS +10.12.4

Use $ ./build.sh to build gpu-switch. OS X can switch between the GPUs without having to reboot the MacBook:

switch to the integrated GPU:

$ ./gpu-switch -i

switch to the dedicated GPU:

$ ./gpu-switch -d

enable automatic GPU switching:

$ ./gpu-switch -a

Login Hooks:

$ ./install_hooks.sh can be used to install Login Hooks to automate the swichting process for login/logout.

Windows 8/10 Usage:

MacBook Pro 11,3 and 11,5 notes:

By default the Intel GPU gets switched off by the MacBook Pro 11,3's (and 11,5's) EFI if you boot anything but OS X. So to use the Intel GPU, you need to trick the EFI by using the "apple_set_os" hack either with:

or

or

or

Otherwise you will end up with a powered-down integrated graphics card and a black screen.

Tested Hardware:

Troubleshooting:

If you are facing weird problems a NVRAM reset could help: http://support.apple.com/kb/PH14222?viewlocale=en_US

(Warning: this also resets your EFI boot configuration)

License:

Copyright (C) 2014-2016 Bruno Bierbaumer, Andreas Heider, Malte Bargholz
Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal in the
Software without restriction, including without limitation the rights to
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
the Software, and to permit persons to whom the Software is furnished to do so,
subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE
OR OTHER DEALINGS IN THE SOFTWARE.