Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/lzhoang2801/OpCore-Simplify/llms.txt

Use this file to discover all available pages before exploring further.

OpCore Simplify is a cross-platform Python CLI tool that automates the creation of OpenCore EFI configurations for Hackintosh systems. Building an OpenCore EFI by hand means reading lengthy guides, manually identifying compatible kexts, writing ACPI patches, and carefully authoring a config.plist — a process that is time-consuming and easy to get wrong. OpCore Simplify replaces that manual work with a single guided workflow: point it at your hardware report and it handles everything from compatibility analysis to the final EFI folder.
OpCore Simplify dramatically reduces setup time, but it does not eliminate the need for foundational knowledge. You should still understand the core concepts covered in the Dortania OpenCore Install Guide before attempting a Hackintosh installation. The tool does not guarantee a successful first boot — testing, troubleshooting, and patience are still part of the journey.

​
How It Works

OpCore Simplify follows a linear, menu-driven workflow broken into six stages:
  1. Hardware Report — Import a Report.json generated by Hardware Sniffer (or exported automatically on Windows). The report captures your CPU, GPU, chipset, storage, network, Bluetooth, ACPI tables, and BIOS metadata.
  2. Compatibility Check — The tool analyses your hardware against its internal database and determines which macOS versions are natively supported and which require OpenCore Legacy Patcher.
  3. macOS Version Selection — The most compatible macOS version is pre-selected for you. You can override it by entering a major version number or a full Darwin version string.
  4. ACPI Patches & Kexts — SSDTTime-powered ACPI patches and a curated kext set are chosen automatically based on your hardware. Both are fully customisable from the menu before you build.
  5. SMBIOS Selection — An optimal Mac model identifier is chosen to maximise power management and performance for your CPU generation.
  6. EFI Build — OpenCorePkg and all required kexts are downloaded from Dortania Builds and GitHub, patched, assembled, and written to a Results/ folder alongside a complete config.plist.

​
Key Capabilities

Cross-platform support. OpCore Simplify runs on Windows, macOS, and Linux. The Windows launcher (OpCore-Simplify.bat) installs Python 3 automatically if it is not already present. The macOS launcher (OpCore-Simplify.command) is a double-click script. Linux users invoke python3 OpCore-Simplify.py directly. Broad hardware support. Intel CPUs from 1st Generation (Nehalem/Westmere) through 15th Generation (Arrow Lake / Core Ultra Series 2) are supported, as are AMD Ryzen and Threadripper processors via AMD Vanilla patches. GPU support spans Intel iGPUs (1st–10th Gen), AMD APUs (Vega Raven ASIC family), AMD discrete GPUs (Navi 21/22/23 and older), and NVIDIA Kepler, Maxwell, Pascal, Fermi, and Tesla cards. Wide macOS range. Configurations can be built for macOS High Sierra through macOS Tahoe. Versions that require OpenCore Legacy Patcher are clearly labelled in the version picker. Automatic updates. Every time OpCore Simplify launches it compares the locally stored commit SHA against the latest commit on GitHub. If a newer version is available, it downloads and applies the update before showing the main menu, then restarts automatically. Rich ACPI patching. The tool integrates SSDTTime for standard patches (FakeEC, FixHPET, PLUG, RTCAWAC, and more) and adds custom patches for HEDT systems, sleep-wake fixes, device disabling, and surface-specific quirks. EFI customisation. Beyond the defaults, the tool applies GPU ID spoofing, CPU ID spoofing for unsupported Intel SKUs, custom CPU name strings, ResizeAppleGpuBars configuration, iGPU headless/display switching, SIP settings, Wi-Fi profile injection for itlwm, and many other refinements drawn from community best practices. When OpCore Simplify starts, it displays a status header showing the currently loaded hardware report, selected macOS version, SMBIOS model, and any disabled devices. Below that are the interactive menu options sourced directly from OpCore-Simplify.py:
OptionAction
1Select Hardware Report — load a Report.json (and optional ACPI dump); triggers automatic compatibility check, macOS version selection, hardware customization, SMBIOS selection, ACPI patch selection, and kext selection in sequence
2Select macOS Version — change the target macOS version; recalculates hardware customization, SMBIOS, and kext set
3Customize ACPI Patch — review and toggle individual ACPI patches
4Customize Kexts — enable, disable, or force-load kexts on unsupported macOS versions
5Customize SMBIOS Model — override the automatically chosen Mac model identifier
6Build OpenCore EFI — download OpenCorePkg and kexts, apply all patches, generate config.plist, and write the complete EFI to the Results/ folder
QQuit — exit the program
Option 1 is always the starting point. All other options except Q require a hardware report to be loaded first. On Windows, the hardware report sub-screen also shows option E. Export hardware report (Recommended) — this option does not appear on macOS or Linux because it relies on the Windows-only Hardware Sniffer binary.

​
Get Started

Installation

Set up OpCore Simplify on Windows, macOS, or Linux.

Quickstart

Build your first OpenCore EFI in six guided steps.

Hardware Support

See the full list of supported CPUs, GPUs, and macOS versions.

Troubleshooting

Diagnose common boot failures and configuration problems.

Build docs developers (and LLMs) love

Get started for freeTalk to us