AMD OS X
Last updated: November 10th, 2019

Welcome to the AMD OS X Vanilla Guide

The AMD OS X Vanilla guide uses Kernel binary patches to enable native AMD CPU support on macOS without the need for a pre patched kernel file. Below you'll find supported CPUs and macOS versions.

Supported AMD CPUs
Family Codename Example
15h Bulldozer FX Series
16h Jaguar A Series
17h Zen Ryzen, Threadripper, Athlon 2xxGE

This guide will support the following versions of macOS on Zen (17h) and 15h/16h AMD:

  • High Sierra 10.13.6 (17G65, 17G66, 17G8030, 17G8037)
  • Mojave 10.14.6 (18G84, 18G87, 18G95, 18G103)
  • Catalina 10.15.0 (19A583, 19A602)

What Works?
  • Apple Online Services - iCloud, iMessage, Siri etc
  • Airdrop/Handoff when used with a supported WiFi/BT Combo card
What doesn't work?
  • 32-bit Applications. No OPEMU and 10.15 drops support entirely.
  • Older CPUs like Phenom that are missing the SSE4.1 CPU instruction.
  • CPU Power Management
  • AMD Integrated GPUs like the Vega 8/11
A note on GPUs

Visit this page by khronokernel to view a list of supported/unsupported GPUs for macOS Catalina. This will reflect on Mojave also.


Gathering Resources

What you'll need,

Installation

Getting the macOS Installer


Run gibMacOS.bat as Admin.

Upon first run of gibMacOS it'll download and install some requirements. This is normal and nothing to be concerned about.

Requirements

Downloading the installer files fairly straight forward process but may take a while depending on your internet speeds.

To start open the gibMacOS folder and run the gibMacOS script,

gibMacOS

This will allow you to choose the macOS version to download, Now type R and press enter to enable recovery only mode. (This will save time downloading)

Recovery Option

Once selected, which in my case I chose option 4 for Catalina. It will download now the macOS installer files.

Selecting macOS Version

Downloading macOS

Once downloaded you can proceed to the next step.

Creating the macOS Install USB


Run MakeInstall as Admin from within the gibMacOS folder. Upon first run of the tool it will install the required dependancies to create your installer.
Now when at the main menu select the option number next to your USB device. In my case I only had one connected so I entered 1

MakeInstall

On the next screen press "y" then enter to confirm. Once it has selected the drive and formatted it you will be greeted with the next screen,



Now inside the gibMacOS directory navigate to macOS Downloads/publicrelease/*Version You Downloaded* and then hold Shift and right click on RecoveryHDMetaDMG.pkg and choose Copy as Path,



Now right Click on the CMD window to paste the path and press Enter.



The script will now continue and extract the resources and restore them to USB. This is where you need to be patient!



Once finished it will install the Clover bootloader to the USB as default. If you wish to use OpenCore then skip the Clover section and go to OpenCore instead.



Bootloader Setup

The bootloader is what allows macOS to run on PC hardware. I recommend using ProperTree from CorpNewt to modify your config files.

Clover

OpenCore Setup

If you wish to use OpenCore then you'll need to download the package from the Official GitHub here. We will be using version 0.5.2.

To replace the default Clover with OpenCore on your USB open the CLOVER drive in Windows Explorer and delete what's there. Now extract your OpenCore archive and add the three folders to the USB.

That is OpenCore now installed on your USB. Easy right? Now you need to configure it. I strongly recommend opening the Docs/Configuration.pdf file and reading through it to understand what the options do.

Below are the patches only not the full config for both 15h_16h and 17h setups compatible with OpenCore 0.5.2

These files only contain the patches not a full config. Please refer to the guide here from Mykola.

If you require any assistance with setting up OpenCore read the documentation. You can also visit our Discord server for help.

Clover

Clover Setup

To begin with you'll need the example config from the AMD Vanilla GitHub repo for your CPU architecture, Zen or 15h/16h. Once downloaded simply copy the config.plist file onto the CLOVER drive you'll now see in This PC. The full directory you should be in is,

CLOVER / EFI / CLOVER

Now enter the drivers/off folder and copy AptioMemoryFix.efi into drivers/UEFI. While in the UEFI folder delete OsxAptioFix3Drv.efi

Now enter the kexts/other folder. Here you'll need to add some kexts to enable booting and some hardware support. You can find info on this in the Kexts section below.

Kexts


What kexts do you need?

What is absolutely required?

  • VirtualSMC.kext (Or FakeSMC.kext) is as aforementioned essential. This kext is what tells macOS "Yes this is a real Mac", emulating the functionality of the SMC on real Mac's. Without it, no Hackintosh.
  • Lilu.kext - this kext acts as a loader for other kexts and is required for VirtualSMC, Whatevergreen, AppleALC etc. More specifically it can patch kexts, processes and libraries.
  • NullCPUPowerManagement.kext - This kext disables CPU Power Management, as that is not supported on AMD chips.
  • Whatevergreen.kext - this kext fixes a lot of GPU related issues.

On macOS Catalina AppleIntelMCEReporter.kext might panic. To prevent that you need to either use a different SMBIOS model or use a disabler kext from here.


Where can I find these kexts?

All the kexts shown here are available for download on the kext repo provided and maintained by Goldfish64. All these kexts are automatically built when a new kext update is commited.

Ethernet
WiFi and Bluetooth

This section is based on information from CorpNewt.

Apple is pretty minimal with their WiFi support, so I'll only cover the two main chipsets I'm familiar with. I've used a BCM94360CD + PCIe adapter, and BCM94352HMB/BCM94352Z in my Hackintoshes. The BCM94360CD worked OOB with no extras as it's a native card. For the BCM94352 flavors, I've been using AirportBrcmFixup.kext and the companion Lilu.kext for WiFi setup and BrcmBluetoothInjector.kext (on 10.13.6+) or BrcmPatchRAM2.kext alongside BrcmFirmwareData.kext - all of the Brcm* kexts are from RehabMan's OS-X-BrcmPatchRAM repo.

Audio
  • AppleALC.kext - this kext supports most of the commonly used codecs, with the best quality but only works with AMD on the Zen platform.
  • VoodooHDA.kext - should be considered a fallback for codecs not supported by AppleALC or for 15h/16h based systems.
Extra

Depending on what hardware you have in your machine you might need some other kexts. This list is more to be used to give you a general idea, you will probably have to do some google-fu.


You should now be able to boot a Vanilla installer of macOS. Now of course each system is different from the next and somethings may not be working as they should.

Fear not though as we will help you with that. Below you'll find a list of useful links and support platforms to assist you.

Credits

Thanks to the following people who made this guide possible.

  • Shaneee - AMD OS X Owner
  • The acidanthera team for OpenCore.
  • Slice and the Clover team.
  • CorpNewt for gibMacOS.
  • AlGrey for working on the AMD Patches.
  • Mykola for his OpenCore guide and GPU Buyers guide.
  • NoOne, DhinakG, does printf work and AlexTheGreat4000 for suggestions.