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.

After you choose your target macOS version, OpCore Simplify runs the Hardware Customization step automatically. This step filters every device in your hardware report against the chosen macOS version and, where multiple compatible devices of the same type exist, asks you to choose which ones to include. Devices that are incompatible with the selected version are disabled and receive ACPI disable patches in the final EFI.

​
Purpose

The goal of hardware customization is to produce a clean, conflict-free device list that accurately reflects what your system will use under macOS. macOS can be sensitive to duplicate or conflicting devices — for example, two active GPUs that each expect to own the display pipeline, or multiple Wi-Fi cards both trying to register with the wireless stack. By resolving these conflicts at this stage, OpCore Simplify can generate a precise config.plist and the correct set of ACPI patches.

​
Devices Processed

Hardware customization iterates over the following device categories in order:
CategoryWhat Happens
BIOSFirmware type is confirmed; if Legacy BIOS is detected, you are offered the option to build for UEFI
GPUIncompatible GPUs are disabled; if multiple compatible GPUs remain, you choose a combination
SoundIncompatible audio codecs are disabled automatically; no user selection required
BiometricAlways disabled (biometric authentication requires Apple T2 chip)
Network (Wi-Fi)Incompatible Wi-Fi cards are disabled; if multiple compatible cards remain, you choose one
Storage ControllersIncompatible controllers are disabled automatically
BluetoothIncompatible adapters are disabled; if multiple compatible adapters remain, you choose one
SD ControllerIncompatible card readers are disabled automatically

​
BIOS Firmware Type Check

If your hardware report shows a Legacy BIOS firmware type, OpCore Simplify pauses and asks whether you want to build the EFI for UEFI mode instead: 
*** BIOS Firmware Type is not UEFI

Do you want to build the EFI for UEFI?
If yes, please make sure to update your BIOS and enable UEFI Boot Mode in your BIOS settings.
You can still proceed with Legacy if you prefer.

Build EFI for UEFI? (Yes/no):
Answering yes updates the firmware type in the customized hardware profile to UEFI and generates a UEFI-compatible EFI. The original report is not modified. Answering no keeps the Legacy firmware type.
Building for UEFI on a Legacy BIOS system requires that you first enable UEFI boot mode in your BIOS settings. OpCore Simplify will remind you of this requirement in the post-build BIOS settings screen. See BIOS Settings for the full checklist.

​
Device Selection for GPU, Wi-Fi, and Bluetooth

When more than one compatible device of the same type is detected, OpCore Simplify presents an interactive selection menu. Devices that are not selected are moved to the disabled list and receive ACPI disable patches.

​
GPU Selection

GPU selection uses a combination-based model rather than a simple pick-one approach, because certain GPU pairings work together in macOS while others conflict. OpCore Simplify builds a list of valid GPU combinations from your compatible GPUs, sorted from smallest (single GPU) to largest (multiple GPUs). Each combination entry shows the device names and their combined compatibility range: 
*** Multiple GPU Devices Detected
Multiple active GPUs can cause kext conflicts in macOS.

Please select a GPU combination configuration:

1. AMD Radeon RX 6800 XT
   Compatibility: High Sierra to Tahoe

2. Intel UHD Graphics 630
   Compatibility: High Sierra to Tahoe

3. AMD Radeon RX 6800 XT + Intel UHD Graphics 630
   Compatibility: High Sierra to Tahoe

Select a GPU combination (1-3):
For desktop systems with a discrete GPU, selecting the discrete GPU alone (option 1 in the example above) and disabling the Intel iGPU is a common and stable choice. Keep the iGPU enabled only if you need features like QuickSync or hardware-accelerated video decoding alongside your discrete GPU.

​
Wi-Fi and Bluetooth Selection

For Wi-Fi and Bluetooth, macOS works best with a single device of each type enabled. When multiple compatible cards are detected, a simple numbered list is shown and you pick one: 
*** Multiple WiFi Devices Detected
macOS works best with only one WiFi device enabled.

Please select which WiFi device you want to use:

1. Intel Wi-Fi 6 AX200
   Device ID: 8086-2723
   Compatibility: High Sierra to Tahoe

2. Broadcom BCM4360
   Device ID: 14E4-43A0
   Compatibility: High Sierra to Ventura
   OCLP Compatibility: Up to Sequoia

Select a WiFi device (1-2):

​
Disabled Devices

Any device that does not meet either the native or OCLP compatibility criteria for the chosen macOS version is automatically added to the disabled devices list. These devices receive ACPI disable patches so that macOS does not attempt to load drivers for them. Disabled devices are shown on the main menu screen for reference: 
  Disabled Devices:
    - Discrete GPU: NVIDIA GeForce RTX 4080
    - Biometric: Synaptics Fingerprint Reader

​
OCLP Devices

If a device’s OCLP Compatibility range includes the chosen macOS version, the device is included in the customized hardware profile and the needs_oclp flag is set to True. This flag triggers the OpenCore Legacy Patcher warning dialog before the EFI build begins, and also causes OCLP-specific kexts to be selected automatically.

​
Device Selection Summary

After all selections are made, OpCore Simplify displays a summary table of every device that was explicitly chosen during selection (GPU, Wi-Fi, Bluetooth). Devices that passed through automatically without a prompt are not listed in this table. 
Device Selection Summary

Selected devices:

Type          Device                                     Device ID
------------------------------------------------------------------
GPU           AMD Radeon RX 6800 XT                      1002-73BF
WiFi          Intel Wi-Fi 6 AX200                        8086-2723
Bluetooth     Intel Bluetooth                            8087-0026

All other devices of the same type have been disabled.
Press Enter to continue to the SMBIOS selection step.

ACPI Patches

Learn how disabled devices receive ACPI patches to prevent macOS from loading unsupported drivers.

Kext Selection

See how the customized device list determines which kexts are included in your EFI.

Build docs developers (and LLMs) love

Get started for freeTalk to us