# ryzen-hackintosh is an OpenCore EFI, and it ends where Apple ends x86 > ryzen-hackintosh is a ready-made OpenCore EFI configuration for running macOS on AMD Ryzen hardware, with the compatibility tables, motherboard quirks, BIOS settings and audio layout instructions written down in one README. Its most important line is a caution at the top, that macOS Golden Gate 27.x and newer will not work because Apple has dropped support for the x86 architecture, so the newest system this configuration supports is Tahoe. **mikigal/ryzen-hackintosh** — OpenCore EFI for AMD Ryzen Hackintosh - Repository: https://github.com/mikigal/ryzen-hackintosh - Stars: 1,179 · Forks: 167 - Language: Shell - License: not declared - Published: 2026-10-19 · Updated: 2026-10-19 · Language: en - Canonical page: https://hysenlabs.com/projects/mikigal-ryzen-hackintosh ## The first thing the README tells you is that it is over The table of contents ends with credits, and the compatibility section opens with a caution that deserves to be the first line of any article about this repository. macOS Golden Gate, 27.x, and newer will not work, because Apple has dropped support for the x86 architecture, and other ARM-based CPUs are not supported either because of Apple's custom M-series instructions. The README is direct about the conclusion, that sadly there is nothing to be done about it, that it was a great run, and that the Hackintosh era has come to an end. Below that, the supported versions run downwards from Tahoe 26.x through Sequoia, Sonoma, Ventura, Monterey, Big Sur, Catalina, Mojave and High Sierra, and the configuration uses OpenCore version 1.0.7. That framing matters for anyone reading the project in 2026, because a repository that is still receiving commits is not the same as a repository that still leads somewhere. ## What is actually in the repository The tree is short and it is a firmware configuration rather than a program. The top-level entries are the OC/ directory, which holds the OpenCore configuration, the BOOT/ directory for the bootloader, a Resources/ directory, a screenshot, a README and a .github/ directory with a tests workflow, whose badge is displayed in the title. The configuration file inside OC/ is the artifact that matters, and the whole README is an explanation of its contents. The interesting part is that this is a config.plist, a structured document that OpenCore reads at boot, and every instruction in the documentation is either a value in that file or a setting in the BIOS. That is a mental model worth holding on to when reading the rest, because a reader who expects a script to run is looking for the wrong thing, and a reader who knows what a quirk and a boot-args entry are will find the instructions easy to follow. ## Which processors and which graphics cards The hardware compatibility section is precise. The EFI is compatible with all Ryzen and Athlon 2xxGE processors with macOS-compatible peripherals, and support for 15h, the FX series, 16h, the A series, and Threadripper CPUs is explicitly not covered. Graphics is a table with three rows and an integrated row that says no, which is reinforced by the statement that all laptops with AMD CPUs are not supported due to integrated graphics incompatibility. Nvidia is partially supported, because support for Nvidia GPUs was dropped in Monterey Beta 7, and the only way to get it back is the OpenCore Legacy Patcher, with Kepler series needing the PAT patch and others requiring WebDrivers that work only in High Sierra. AMD is the supported path, with some R7 and R9 GPUs requiring FakeID, and Lexa series not supported, while older than 7000 series work up to High Sierra. For Navi 10 and 20 series, the RX 5000 and RX 6000, the README says to add agdpmod=pikera to boot-args to fix the black screen issue. ## The PAT patch, and what it costs The PAT Patch made by Shaneee is used by default, and the README explains both what it buys and what it breaks. It improves GPU performance, but it has a few caveats. Audio passed by HDMI or DisplayPort will not work or will be unstable, and it may not work with Nvidia GPUs. The last point is why MonitorControl is mentioned, since controlling a monitor's brightness or the HDMI and DP audio volume needs it if you want that behaviour. The practical reading is that the default configuration trades display audio for GPU performance, and a user who needs both has to work out which side to give up. The compatibility table also carries the reason for the FakeID requirement in some R7 and R9 cards, with a link to the spoofing section of the Dortania guides, and the note that the repository points to the Dortania buyers guide for the question of which peripherals are macOS-compatible in the first place. ## Motherboard quirks, one per chipset The motherboard table is where the EFI stops being generic. B550 and A520 require an SSDT-CPUR to boot, and the steps are given, download the compiled SSDT-CPUR.aml, install it into the OC/ACPI directory, and add it to the configuration file, with ProperTree suggested for simplicity. For B550, A520, B450, X470 and X570, SetupVirtualMap has to be disabled, which means going to Booter, Quirks, SetupVirtualMap in the configuration file and setting it to false, and for boards older than A520, B550 and X570 it may be necessary to disable the Disable 10 bit tags patch. On AM5 with Thunderbolt or USB4 it is complicated, because macOS Ventura and newer may not enumerate devices on the PCI bus properly when on-board WiFi and on-board Thunderbolt are both enabled, and the fix is the CaseySJ patch named IOPCIIsHotplugPort with the label Fix PCI bus enumeration on AM5, which is disabled by default and has to be enabled if you hit the problem. Other motherboards should be compatible out of the box. ## BIOS settings that are part of the configuration Several instructions are BIOS changes rather than EFI changes, and they are the ones that trip people up. For PCI Express, if the Above 4G Decoding option is in the BIOS settings, enable it and remove the npci=0x2000 parameter from the boot-args in the NVRAM section, since the two are alternatives and having both causes trouble. For Resizable BAR, if the option is in the BIOS and the GPU supports it, enable it for better GPU performance and then set Booter, Quirks, ResizeAppleGpuBars to 0. For SecureBootModel, if there are issues with Secure Boot in the macOS installer, set Misc, Security, SecureBootModel to Disabled, and after installation set it to the value corresponding to the SMBIOS in use, with a link to the Dortania page on it. The pattern across all three is the same, a BIOS toggle and an EFI value that have to agree, and the README does not say which half breaks first when they disagree. ## Audio, and the one dependency the project refuses The audio section is a procedure rather than a list. If your audio chipset is different from the one in the specification, go to the applealc wiki to find your codec under Codec, and if it is not on the list then you probably have to use VoodooHDA, which this repository does not cover or support. Under Revisions and layouts you will see a set of numbers and layout ids, so you look for the alcid=11 setting in your boot-args and try every layout id except the 0x values one by one until it works, with the example that alcid=10 corresponds to layout 10. The caveats are that external USB audio cards should work out of the box, and that if you have a CPU with an integrated GPU, even if you do not use it, your audio may be broken or unstable, with SpeedKeeper offered as a possible fix that is not guaranteed to work and an external USB audio card described as the best solution. The rest of the document covers the remaining features, including DRMs support, sleep, virtualization, the MKL and Intel Fast Memset patch, and the installation and troubleshooting guides. ## Conclusion ryzen-hackintosh is worth reading for anyone who wants to understand what an EFI configuration actually consists of, because the README is a complete worked example with the failure modes attached, the blacklist, the BIOS switches and the audio layout procedure written out, and that knowledge transfers to any OpenCore setup. It is the wrong thing to install today if you want the newest macOS, since Apple has ended x86 support, and it is the wrong thing for a laptop or for an integrated graphics system, both of which the project rules out. Before you copy this EFI, check the OpenCore version it was built against, because the configuration lists 1.0.7 and the quirks it needs change between versions, and read the motherboard section for your chipset, since the required patches are specific to B550 and A520. ## FAQ ### Which macOS versions does the ryzen-hackintosh EFI support? It supports Tahoe 26.x, Sequoia 15.x, Sonoma 14.x, Ventura 13.x, Monterey 12.x, Big Sur 11.x, Catalina 10.15.x, Mojave 10.14.x and High Sierra 10.13.x, using OpenCore version 1.0.7. macOS Golden Gate 27.x and newer will not work, because Apple has dropped support for the x86 architecture. ### Which CPUs and GPUs does this EFI support? All Ryzen and Athlon 2xxGE processors with macOS-compatible peripherals, with the FX series, A series and Threadripper not covered. Integrated graphics are not supported, laptops with AMD CPUs are not supported, and AMD GPUs are the supported path, with some R7 and R9 requiring FakeID and Navi 10 and 20 series needing agdpmod=pikera in boot-args for the black screen issue. ### What do I have to change for a B550 or A520 motherboard? Those chipsets require an SSDT-CPUR to boot, which you install into the OC/ACPI directory and add to the configuration file with ProperTree, and SetupVirtualMap has to be disabled, which means setting Booter, Quirks, SetupVirtualMap to false in the configuration file. ### How do I get audio working? Find your chipset codec in the applealc wiki, look under Revisions and layouts for the layout ids, and set alcid in your boot-args, trying every layout id except the 0x values one by one, for example alcid=10 for layout 10. If your codec is not on the list you would need VoodooHDA, which the repository does not cover or support. ## Sources - [Issues](https://github.com/mikigal/ryzen-hackintosh/issues) - [mikigal/ryzen-hackintosh on GitHub](https://github.com/mikigal/ryzen-hackintosh) - [README](https://github.com/mikigal/ryzen-hackintosh/blob/master/README.md) --- Hysen Labs editorial analysis, written from the project's own repository and release notes. Cite the canonical page: https://hysenlabs.com/projects/mikigal-ryzen-hackintosh