JohnGuan/AMD_Vanilla

Created May 27, 2022 · View the JohnGuan/AMD_Vanilla repository page

Native AMD macOS via Clover & OpenCore

Want this for your repo?

Render a free sample of any GitHub repo in seconds.

Visualize your own →

Contributors

16

Lines of Code

194

From

Mar 18, 2019

To

Feb 10, 2021

About JohnGuan/AMD_Vanilla

AMD_Vanilla is a collection of kernel binary patches that enable AMD processors to run macOS through OpenCore bootloader modifications. Rather than requiring a completely custom kernel, this project patches the standard macOS kernel on the fly, allowing AMD CPUs to achieve near-native compatibility with the operating system. The patches support multiple AMD processor families including older Bulldozer and Jaguar architectures as well as modern Zen-based Ryzen and Threadripper processors.

The project enables full macOS functionality on AMD systems, including features like iMessage, Siri, FaceTime, and Continuity that typically require Apple hardware. It supports macOS versions from High Sierra through Big Sur and provides different patch options for GPU performance tuning, such as Algrey's original patch that works universally or Shaneee's patch that enhances AMD GPU performance at the cost of potential Nvidia compatibility issues. The patches require OpenCore 0.6.1 or later and include various workarounds for specific issues encountered on different AMD processor families and macOS versions.

The project is primarily aimed at enthusiasts and hackers who want to run macOS on AMD-based PCs. Setup involves creating a bootable USB drive, installing OpenCore, and merging the appropriate CPU family patches into the OpenCore configuration file. The repository provides extensive documentation covering various edge cases and known issues, such as webpage crashes on Mojave for older CPU families and specific ACPI modifications needed for Catalina compatibility.

Share this video