Loading updates...
OpenCore 1.0.6 | December 2025
Auto-update

Complete Hackintosh Guide

The most complete and updated guide to create your EFI from scratch using OpenCore. Compatible with macOS Sequoia 15.x and ready for macOS Tahoe 26.x (2026).

1.0.6

OpenCore Version

15.2

macOS Sequoia

50+

Supported Kexts

100%

Compatibility

Real-Time Updates
This guide automatically fetches the latest versions of OpenCore, kexts, and tools via GitHub API.
Multi-Language
Available in Portuguese (BR), English (US), and Spanish. Language is automatically detected or can be changed above.

Latest Versions

Baseado no ecossistema Dortania Builds (Official Release Monitor).

System Requirements

Ensure your hardware is compatible before starting

Attention: Not all hardware is compatible. Verify carefully before proceeding.

Compatible CPUs

Supported Intel Processors:

  • Intel 8th Gen (Coffee Lake) or newer
  • Alder Lake (12th Gen) with spoofing
  • Raptor/Propel Lake (13/14th Gen) with spoofing
  • AMD Ryzen (Limited Support)

Compatible GPUs

Supported Graphics Cards:

  • AMD RX 6000 series (RDNA 2)
  • AMD RX 5000 series (RDNA 1)
  • AMD Vega/Polaris
  • Intel iGPU (HD 630+)
  • NVIDIA (No support / Legacy)

Other Requirements

Additional Hardware:

  • 16GB+ RAM (Recommended)
  • NVMe or SATA SSD
  • 16GB+ USB Drive
  • Internet Connection

Essential Kexts

Kernel extensions required for full functionality

Attention: Use only kexts necessary for your hardware. Excess kexts cause instability.

Essentials (Must Have)

Kext Function Boot Args / Notes
Lilu.kext Essential base for kernel patching. -
VirtualSMC.kext SMC Emulator. Mandatory for booting. Replaces FakeSMC.
RestrictEvents.kext Essential for Modern/Legacy Hardware
Fixes memory errors (MacPro7,1), unlocks OTA updates on unsupported CPUs (Comet Lake+ on Ventura/Sonoma) and adjusts CPU names.
revpatch=auto (General/OTA)
revpatch=cpuname (CPU Name)
revblock=media (Fix Ventura+ crash)
CpuTopologyRebuild.kext Optimizes performance on Hybrid CPUs (Alder Lake 12th+). Use with -ctrsmt (if HyperThreading ON)
NVMeFix.kext Power management for non-Apple NVMe SSDs. improves stability. -nvmefyas (Force L1)
Essential for Samsung/Phison.
XHCI-unsupported.kext Enables non-native USB controllers (common on 400/500/600 series chipsets). Usually no boot-args.

VirtualSMC Plugins

Kext Function Compatibility / Notes
SMCProcessor.kext CPU Temperature Monitoring. Intel Core & AMD (Some).
Requires VirtualSMC.
SMCSuperIO.kext Fan Speed Monitoring. Desktops. Requires compatible chips (Nuvoton/ITE).
SMCBatteryManager.kext Battery Monitoring. Laptops. Essential for battery status.
SMCLightSensor.kext Ambient Light Sensor (ALS) for auto-brightness. Laptops (requires ACPI sensor).
AMDRyzenCPUPowerManagement.kext Power Management and Monitoring for AMD Ryzen. AMD Ryzen (Replaces SMCProcessor in some cases).

Graphics

Kext Function Boot Args / Notes
WhateverGreen.kext Essential patches for GPUs (Intel/AMD/NVIDIA). DRM, Backlight, etc. Standard. agdpmod=pikera (RX 5000/6000)
-wegnoegpu (Disable dGPU)
NootRX.kext Exclusive support for AMD Navi 2x (non-native RX 6700/6900). INCOMPATIBLE with WhateverGreen. Do not use agdpmod=pikera (automatic). Remove WEG!
NootedRed.kext Support for AMD Ryzen APU iGPUs (Vega). Requires VRAM adjustments in BIOS.

Audio & Network

Kext Function Boot Args / Notes
AppleALC.kext Native audio (Realtek/Synaptics). alcid=1 (Layout ID)
-alcdbg (Debug)
IntelMausi.kext Intel Ethernet (I219V, etc). -
RealtekRTL8111.kext Realtek Gigabit Ethernet. -
LucyRTL8125Ethernet.kext Realtek 2.5GbE Ethernet (RTL8125). -
itlwm.kext Intel Wi-Fi (OpenIntelWireless Works). Ethernet Mode (stable). Requires HeliPort App.

Wi-Fi & Bluetooth

Kext Function Boot Args / Notes
itlwm.kext Intel Wi-Fi (OpenIntelWireless). Ethernet Mode (manual connection via App). Requires HeliPort App. More stable.
AirportItlwm.kext Native Intel Wi-Fi (Apple Integration). Supports Location Services, etc. VERSION SENSITIVE (Use exact kext for your macOS version).
IntelBluetoothFirmware.kext Firmware for Intel Bluetooth. Accompanies IntelBTPatcher.kext and BlueToolFixup.kext on macOS Monterey+.
BlueToolFixup.kext Fixes Bluetooth stack on macOS Monterey, Ventura and Sonoma (Broken legacy support). Mandatory for Intel/Broadcom BT on macOS 12+.
AirportBrcmFixup.kext Patches for non-native Broadcom Wi-Fi or to force loading. -brcmfxbeta (Sonoma)
brcmfx-country=BR

USB & Extras

Kext Function Compatibility / Notes
USBToolBox.kext Easy USB mapping (Windows/macOS). Requires UTBMap.kext generated by the tool.
USBInjectAll.kext Injects all USB ports (Temporary for mapping). Remove after creating your USB Map!
ECEnabler.kext Fixes Battery reading (Status 0%) on many laptops without complex DSDT patches. Essential for Laptops.
BrightnessKeys.kext Enables brightness keys (Fn) automatically. Laptops.
VoodooPS2Controller.kext PS2 Keyboards, old Synaptics/ELAN Trackpads. Most Laptops.
VoodooI2C.kext Modern I2C Mouse/Trackpad (Dell XPS, new HP, etc). Requires satellite (e.g. VoodooI2CHID).
NEVER use NootRX.kext with WhateverGreen.kext! They are incompatible.

Choosing the Right SMBIOS

SMBIOS defines which Mac your Hackintosh will emulate

2025 Update: For macOS Sequoia 15.x and Tahoe 26.x, MacPro7,1 is the recommended choice for desktops with dedicated AMD GPUs.
Hardware Recommended SMBIOS Compatibility Notes
Desktop + Dedicated AMD GPU MacPro7,1 Sequoia 15.x ✅
Tahoe 26.x ✅
Best for RX 6000
Desktop + AMD GPU (Alternative) iMacPro1,1 Sequoia 15.x ✅
Tahoe 26.x ⚠️
May be deprecated
Desktop + Intel iGPU iMac20,1 / iMac20,2 Sequoia 15.x ✅ For 10th Gen Intel
Laptop + AMD GPU MacBookPro16,1 Sequoia 15.x ✅ For high-end laptops
Laptop + Intel iGPU MacBookPro16,2 Sequoia 15.x ✅ For standard laptops

Important SMBIOS Rules

  • MacPro7,1: does NOT need agdpmod=pikera with NootRX.kext
  • iMacPro1,1: Requires agdpmod=pikera with Navi GPUs (if not using NootRX)
  • iMac SMBIOS: Assumes iGPU presence
  • No iGPU: Use MacPro7,1 or iMacPro1,1
  • Generate new serials: Use GenSMBIOS to create unique serials

Hardware Limitations

Understand what works and what DOES NOT work before starting

⚠️ READ THIS FIRST!
Not all hardware is compatible. This section lists known limitations to avoid frustration. Verify BEFORE proceeding!

🔴 CPU Support

Supported CPUs:
  • Intel Desktop: Yonah to Comet Lake (10th Gen)
  • Intel HEDT/Server: Nehalem to Cascade Lake-X
  • Intel Laptop: Arrandale to Ice Lake
  • AMD Desktop: Bulldozer (15h), Jaguar (16h), and Ryzen (17h)
❌ NOT Supported:
  • Intel Atom, Celeron, Pentium Mobile - Do NOT work
  • AMD Laptops - No models supported
  • AMD: Not all macOS features work (see below)

Architecture Requirements:

Feature Requirement macOS Version
SSE3 Mandatory for all versions 10.4.1+
SSSE3 Mandatory for 64-bit 10.6+
SSE4.2 Mandatory (emulation available) 10.14+
AVX2 Mandatory (no workaround) 13.0+ (Ventura)
🚫 macOS Ventura (13.0+) & Sonoma (14.0+):
CPUs older than Haswell (4th Gen) are NO LONGER supported due to AVX2 requirement. This includes Ivy Bridge, Sandy Bridge, etc.

Core/Thread Limits:

  • OS X 10.10 and older: Max 24 threads
  • OS X 10.11+: Max 64 threads
  • Workaround: Use cpus= boot-arg or disable Hyperthreading

🎮 GPU Support

📚 Complete Guide:
Consult the GPU Buyers Guide for detailed compatibility info.

⚠️ Dedicated GPUs in Laptops:

  • 90% of dedicated Laptop GPUs DO NOT work due to switchable graphics (Optimus/Switchable Graphics)
  • The dGPU must be disabled/turned off in most cases
  • External outputs (HDMI/DP) may or may not work depending on wiring
  • Some rare laptops lack switchable graphics and might work (if GPU is supported)

Support by Vendor:

Vendor Status Notes
AMD (Polaris/Vega/Navi) Excellent RX 400/500/5000/6000 work well
NVIDIA (Kepler) Limited GTX 600/700 work up to Big Sur
NVIDIA (Maxwell+) Not Supported GTX 900/1000/2000/3000/4000 do NOT work
Intel (iGPU) Good HD/UHD Graphics work (except Arc)

💾 Storage Support

✅ Works Well:
Most SATA and NVMe drives work perfectly in macOS.
⚠️ Problematic Drives:
  • Samsung PM981/PM991 - Causes kernel panics, requires NVMeFix.kext (issues may persist)
  • Micron 2200S - Same issues as PM981
  • Samsung 970 EVO Plus - Fixed with firmware update
  • Intel 600p - May cause issues (660p works fine)
  • Intel Optane Memory - Not supported for HDD acceleration
# Solution for PM981/PM991/Micron 2200S # Add NVMeFix.kext to EFI/OC/Kexts/ # Note: May still have boot issues! # Recommendation: Replace drive if possible

🌐 Network Support

Ethernet (Wired):

Virtually all Ethernet adapters are supported, either natively or via community kexts.
Exceptions requiring config:
  • Intel I225-V 2.5Gb - Requires device properties
  • Intel I350 1Gb - Requires device properties
  • Intel 10Gb (X520/X540) - Workarounds available
  • Mellanox/Qlogic - Not Supported

Wi-Fi & Bluetooth:

⚠️ Laptops:
Most Wi-Fi cards in laptops (Intel/Qualcomm) are NOT natively supported.
Brand Status Notes
Broadcom Best Choice Native support, works perfectly (Fenvi T919 recommended)
Intel Unofficial Requires AirportItlwm / IntelBluetoothFirmware
Atheros Limited Only up to High Sierra
Qualcomm Not Supported No drivers available

🔧 Other Components

❌ Not Supported:
  • Fingerprint Sensors - Touch ID cannot be emulated
  • Windows Hello (I2C) - Connected via iGPU, DOES NOT work
  • Windows Hello (USB) - May work only as a camera
  • Intel Smart Sound Technology - Internal microphone DOES NOT work
  • Combo Headphone Jack - Audio input may not work
⚡ Thunderbolt 3/4:
Support is still unstable, especially with Alpine Ridge controllers. Hotplug can cause kernel panics. To use USB-C, connect at boot and keep connected. Disabling Thunderbolt in BIOS resolves issues.

🔌 Motherboard Support

In most cases, all motherboards are supported as long as the CPU is compatible.
⚠️ MSI 500-series AMD Boards:
A520, B550, and X570 boards have issues with macOS Monterey+. PCIe devices are not enumerated correctly. Big Sur or older is recommended.
✅ Update: Fixed in latest AMD vanilla patches!
📚 Additional Resources:
For more detailed information, consult:

Hardware Analysis & Config Generator

Upload your hardware report and generate a perfect config.plist automatically

Step 1: Upload Hardware Report

Drag and drop your Report.json (HardwareSniffer) or Report.htm (AIDA64) file here:

Drop your file here or click to browse

Supported: .json (HardwareSniffer) or .htm/.html (AIDA64)

Configurations by Generation

Complete config.plist guide (Click to expand)

AMD Ryzen (Zen)

Ryzen 1000-7000 & Threadripper

ACPI
  • SSDT-EC-USBX-DESKTOP.aml
  • SSDT-CPUR.aml (B550/A520) or SSDT-PLUG.aml
Booter
Quirks
  • EnableWriteUnprotector: False
  • RebuildAppleMemoryMap: True
  • SetupVirtualMap: True
DeviceProperties
Typically empty for AMD (Most iGPUs not supported).
Kernel
AMD Patches
Quirks
  • ProvideCurrentCpuInfo: True
  • PanicNoKextDump: True
  • PowerTimeoutKernelPanic: True
Misc
Boot (Cosmetics)
  • PickerMode: External (Enable GUI/Themes)
  • PickerAttributes: 17 (Mouse Support)
  • ShowPicker: True
  • PollAppleHotKeys: True
Security & Debug
  • SecureBootModel: Disabled
  • AppleDidMessage: True (if using Debug)
  • ScanPolicy: 0
  • Vault: Optional
NVRAM
Boot-args
-v keepsyms=1 debug=0x100 npci=0x2000 alcid=1
Remove -v for Apple Logo boot (Clean Boot).
PlatformInfo
MacPro7,1 (Recommended)
iMacPro1,1 (Alternative)
UEFI
Output (Visuals)
  • Resolution: Max (Native Res)
  • TextRenderer: BuiltinGraphics
  • ConsoleMode: Max
Drivers
  • OpenRuntime.efi
  • HfsPlus.efi
⚙️ BIOS Settings
DISABLE
  • Fast Boot
  • Secure Boot
  • Serial/COM Port
  • Parallel Port
  • CSM (Compatibility Support Module) - CRITICAL!
ENABLE
  • Above 4G Decoding (Critical)
  • EHCI/XHCI Hand-off
  • OS Type: Windows 8.1/10 UEFI Mode
  • SATA Mode: AHCI

Intel 8th-10th Gen

Comet Lake (Native)

ACPI
  • SSDT-PLUG.aml
  • SSDT-EC-USBX.aml
  • SSDT-AWAC.aml
  • SSDT-RHUB.aml (Examples: Asus Z490)
Booter
Quirks
  • DevirtualiseMmio: True
  • ProtectUefiServices: False
  • RebuildAppleMemoryMap: True
  • SetupVirtualMap: True
DeviceProperties
iGPU (UHD 630 Desktop)
<key>AAPL,ig-platform-id</key> <data>BwCbPg==</data> <key>device-id</key> <data>mz4AAA==</data>
Use 07009B3E for Headless (dGPU only).
Kernel
Quirks
  • AppleXcpmCfgLock: True (If CFG-Lock enabled)
  • DisableIoMapper: True (If VT-d enabled)
  • PanicNoKextDump: True
Misc
Boot (Cosmetics)
  • PickerMode: External (Enable GUI/Themes)
  • PickerAttributes: 17 (Mouse Support)
  • ShowPicker: True
Security
  • SecureBootModel: Disabled
  • ScanPolicy: 0
  • Vault: Optional
NVRAM
Boot-args
-v keepsyms=1 debug=0x100 alcid=1
Remove -v for Apple Logo boot (Clean Boot).
PlatformInfo
iMac20,1 (High-end 10th Gen)
iMac20,2 (Mid-range 10th Gen)
iMac19,1 (8th/9th Gen)
UEFI
Output (Visuals)
  • Resolution: Max (Native Res)
  • TextRenderer: BuiltinGraphics
Drivers
  • OpenRuntime.efi
  • HfsPlus.efi
⚙️ BIOS Settings
DISABLE
  • Fast Boot
  • Secure Boot
  • CSM (Compatibility Support Module)
  • Intel SGX
  • CFG Lock (MSR 0xE2) - CRITICAL!
ENABLE
  • VT-x
  • Above 4G Decoding
  • Hyper-Threading
  • Execute Disable Bit
  • EHCI/XHCI Hand-off
  • DVMT Pre-Allocated: 64MB+

Intel 12th-14th Gen

Alder/Raptor (Spoof)

ACPI
  • SSDT-PLUG-ALT.aml (Required)
  • SSDT-EC-USBX.aml
  • SSDT-AWAC.aml
Booter
Quirks
  • DevirtualiseMmio: True
  • RebuildAppleMemoryMap: True
  • SetupVirtualMap: True
  • SyncRuntimePermissions: True
DeviceProperties
Note: iGPU (UHD 770) is NOT supported.
You need a dedicated GPU (AMD RX 400/500/5000/6000 series).
Kernel
Emulate (Comet Lake Spoof)
Cpuid1Data: 55060A00 00000000 00000000 00000000
Cpuid1Mask: FFFFFFFF 00000000 00000000 00000000
Quirks
  • ProvideCurrentCpuInfo: True
  • PanicNoKextDump: True
  • PowerTimeoutKernelPanic: True
Misc
Boot (Cosmetics)
  • PickerMode: External (Enable GUI/Themes)
  • PickerAttributes: 17 (Mouse Support)
  • ShowPicker: True
Security
  • SecureBootModel: Disabled
  • ScanPolicy: 0
  • Vault: Optional
NVRAM
Boot-args
-v keepsyms=1 debug=0x100 agdpmod=pikera
Remove -v for Apple Logo boot (Clean Boot).
PlatformInfo
MacPro7,1 (Recommended)
iMacPro1,1 (Alternative)
UEFI
Output (Visuals)
  • Resolution: Max (Native Res)
  • TextRenderer: BuiltinGraphics
Quirks
  • ResizeAppleGpuBars: -1 (Disabled - Critical!)
⚙️ BIOS Settings
DISABLE
  • Fast Boot
  • Secure Boot
  • Serial/COM Port
  • Parallel Port
  • CSM (Must be off for GPU to work)
  • Intel SGX
  • CFG Lock
ENABLE
  • VT-x & VT-d
  • Above 4G Decoding
  • Hyper-Threading
  • Execute Disable Bit
  • EHCI/XHCI Hand-off

Intel Laptops

3rd Gen - 10th Gen (iGPU)

ACPI
  • SSDT-PLUG.aml / SSDT-PLUG-DRTNIA.aml
  • SSDT-EC-USBX-LAPTOP.aml
  • SSDT-PNLF.aml (Backlight)
  • SSDT-XOSI.aml (Trackpad)
Graphics (HD/UHD)
Copy proper AAPL,ig-platform-id: See List
Ivy Bridge AAPL,ig-platform-id: 04006601
Haswell AAPL,ig-platform-id: 0600260A
Skylake AAPL,ig-platform-id: 00001B19
Kaby Lake AAPL,ig-platform-id: 00001B59
Coffee/Comet Lake AAPL,ig-platform-id: 0900A53E
Ice Lake AAPL,ig-platform-id: 0000528A
NVRAM
Common Layouts: 3, 11, 13, 21, 28, 29
Boot-arg: alcid=13
UEFI -> Quirks
ReleaseUsbOwnership: True
Booter
Quirks
  • DevirtualiseMmio: False
  • EnableWriteUnprotector: False
  • ProtectUefiServices: False
  • ProvideCustomSlide: True
  • RebuildAppleMemoryMap: True
  • SetupVirtualMap: False (True for Haswell and older)
  • SyncRuntimePermissions: True
DeviceProperties
Add - Copy & Paste Ready Examples
Intel UHD 620 (Kaby Lake-R / 8th Gen)
For: i3-8130U, i5-8250U, i5-8350U, i7-8550U, i7-8650U
<key>PciRoot(0x0)/Pci(0x2,0x0)</key> <dict> <key>AAPL,ig-platform-id</key> <data>AAAWWQ==</data> <key>device-id</key> <data>FllgAA==</data> <key>framebuffer-patch-enable</key> <data>AQAAAA==</data> <key>framebuffer-stolenmem</key> <data>AAAwAQ==</data> <key>framebuffer-fbmem</key> <data>AACQAA==</data> </dict>
Notes: AAPL,ig-platform-id = 0x59160000 | device-id = 0x16590000 (spoofs UHD 620 to HD 620)
Intel UHD 630 (Coffee Lake / 8th-9th Gen)
For: i5-8300H, i5-9300H, i7-8750H, i7-9750H, i9-8950HK, i9-9880H
<key>PciRoot(0x0)/Pci(0x2,0x0)</key> <dict> <key>AAPL,ig-platform-id</key> <data>AAAWWQ==</data> <key>device-id</key> <data>mz4AAA==</data> <key>framebuffer-patch-enable</key> <data>AQAAAA==</data> <key>framebuffer-stolenmem</key> <data>AAAwAQ==</data> <key>framebuffer-fbmem</key> <data>AACQAA==</data> </dict>
Notes: AAPL,ig-platform-id = 0x59160000 | device-id = 0x3E9B0000 (for UHD 630)
Audio (AppleALC)
<key>PciRoot(0x0)/Pci(0x1f,0x3)</key> <dict> <key>layout-id</key> <data>DQAAAA==</data> </dict>
Common layouts: 3, 11, 13 (0x0D000000), 21, 28, 29 - Try different values if audio doesn't work
Important Notes
  • DVMT patches (framebuffer-*) are only needed if BIOS doesn't allow 64MB+ DVMT allocation
  • For UHD 620, device-id spoofs it to HD 620 for better compatibility
  • For external displays (HDMI/DP), you may need additional framebuffer patches
  • If you have a dedicated GPU, disable it in BIOS or use SSDT-dGPU-Off
Kernel
Add (Kexts)
  • Lilu.kext - Required
  • VirtualSMC.kext + SMCProcessor + SMCBatteryManager
  • WhateverGreen.kext - Graphics patches
  • AppleALC.kext - Audio
  • VoodooPS2Controller.kext - Keyboard/Trackpad (PS2)
  • VoodooI2C.kext + VoodooI2CHID - I2C Trackpad (if applicable)
  • ECEnabler.kext - Battery readout
  • BrightnessKeys.kext - Fn brightness keys
  • RealtekRTL8111.kext or IntelMausi.kext - Ethernet
  • AirportItlwm.kext + IntelBluetoothFirmware - Intel Wi-Fi
Quirks
  • AppleCpuPmCfgLock: True (if CFG-Lock can't be disabled in BIOS)
  • AppleXcpmCfgLock: True (if CFG-Lock can't be disabled in BIOS)
  • DisableIoMapper: True (if VT-d can't be disabled in BIOS)
  • PanicNoKextDump: True
  • PowerTimeoutKernelPanic: True
  • XhciPortLimit: False (use USBMap.kext instead)
Misc
Boot
  • HideAuxiliary: True
  • PickerMode: Builtin
  • ShowPicker: True
  • Timeout: 5
Debug
  • AppleDebug: True
  • ApplePanic: True
  • DisableWatchDog: True
  • Target: 67 (for debugging)
Security
  • AllowSetDefault: True
  • BlacklistAppleUpdate: True
  • ScanPolicy: 0
  • SecureBootModel: Default
  • Vault: Optional
NVRAM
Add
7C436110-AB2A-4BBB-A880-FE41995C9F82
  • boot-args: -v keepsyms=1 debug=0x100 alcid=13
  • csr-active-config: 00000000 (SIP enabled)
  • prev-lang:kbd: 656E2D55533A30 (en-US:0)
4D1EDE05-38C7-4A6A-9CC6-4BCCA8B38C14
  • UIScale: 01 (normal) or 02 (HiDPI)
PlatformInfo
Generic
Recommended SMBIOS:
  • Ivy Bridge: MacBookPro10,1 (15") or MacBookPro10,2 (13")
  • Haswell: MacBookPro11,1 (13") or MacBookPro11,2 (15")
  • Broadwell: MacBookPro12,1 (13")
  • Skylake: MacBookPro13,1 (13") or MacBookPro13,3 (15")
  • Kaby Lake: MacBookPro14,1 (13") or MacBookPro14,2 (13" Touch)
  • Coffee Lake: MacBookPro15,2 (13") or MacBookPro15,1 (15")
  • Comet Lake: MacBookPro16,2 (13") or MacBookPro16,1 (16")
  • Ice Lake: MacBookAir9,1 or MacBookPro16,2
Generate SMBIOS: GenSMBIOS Tool
UEFI
Drivers
  • OpenRuntime.efi - Required
  • HfsPlus.efi - Required for HFS+ (macOS)
  • OpenCanopy.efi - Optional (GUI boot picker)
Quirks
  • RequestBootVarRouting: True
  • ReleaseUsbOwnership: True
  • UnblockFsConnect: False
Input
  • KeySupport: True
  • PointerSupport: False
Output
  • ProvideConsoleGop: True
  • Resolution: Max
  • TextRenderer: BuiltinGraphics
⚙️ BIOS Settings
✅ Enable:
  • UEFI Boot Mode
  • AHCI Mode (for SATA)
  • Above 4G Decoding (if available)
  • Hyper-Threading
  • Execute Disable Bit
  • EHCI/XHCI Hand-off
❌ Disable:
  • Secure Boot
  • Fast Boot
  • CFG-Lock (if possible)
  • VT-d (if not needed)
  • CSM/Legacy Boot
  • Intel SGX
  • Intel Platform Trust

Step-by-Step Installation

Complete guide to create your EFI from scratch

0. Create USB (Windows/macOS)

Use our exclusive tool to download and create the installer:

Download macOS Recovery

1. OpenCore Download

Download the latest OpenCore version:

https://github.com/acidanthera/OpenCorePkg/releases

Recommended version: 1.0.6 or higher

2. EFI Structure

Create the following folder structure:

EFI/ ├── BOOT/ │ └── BOOTx64.efi └── OC/ ├── ACPI/ ├── Drivers/ ├── Kexts/ ├── Resources/ ├── Tools/ ├── OpenCore.efi └── config.plist

3. UEFI Drivers

Add essential drivers in EFI/OC/Drivers/:

  • OpenRuntime.efi (Required)
  • HfsPlus.efi (HFS+ support)
  • OpenCanopy.efi (GUI boot picker)
  • ResetNvramEntry.efi (reset NVRAM)

4. Kexts

Add necessary kexts in EFI/OC/Kexts/:

  • Lilu.kext
  • VirtualSMC.kext + plugins
  • WhateverGreen.kext OR NootRX.kext
  • AppleALC.kext
  • Network Kexts (Ethernet/WiFi)
  • CpuTopologyRebuild.kext (if 12th/13th gen)

5. Config.plist

Configure config.plist using:

  • ProperTree (Recommended editor)
  • Use Sample.plist as base
  • Configure SMBIOS with GenSMBIOS
  • Add necessary boot-args
  • Configure quirks for your hardware

6. Boot & Installation

Final steps:

  • Copy EFI to USB
  • Configure BIOS (see below)
  • Boot from USB
  • Install macOS
  • Copy EFI to internal disk

BIOS Settings

Essential settings for correct functionality

Disable

  • Fast Boot
  • Secure Boot
  • CSM/Legacy Boot
  • Intel SGX
  • Intel PTT/fTPM
  • CFG Lock (se possível)

Habilitar

  • Above 4G Decoding (CRÍTICO!)
  • Resizable BAR (ReBAR)
  • XHCI Hand-off
  • VT-x (Virtualization)
  • VT-d (pode manter habilitado)
  • UEFI Boot Mode

GPU Settings

  • Primary Display: PCIe
  • DVMT Pre-Allocated: 64MB+
  • iGPU: Disabled (se usar dGPU)
  • iGPU Multi-Monitor: Disabled

Important Boot Arguments

Boot arguments for different situations

Boot-arg Function When to use
-v Verbose mode (mostra log de boot) Debug e instalação
keepsyms=1 Mantém símbolos em kernel panic Debug de problemas
debug=0x100 Desabilita watchdog (evita reboots) Debug de kernel panics
alcid=X Define layout de áudio (X = número) Configuração de áudio
agdpmod=pikera Fix tela preta GPUs Navi ⚠️ NÃO usar com NootRX!
-igfxvesa Modo VESA para iGPU Problemas com iGPU
npci=0x2000 Fix PCI configuration Problemas de boot
Important: Com MacPro7,1 + NootRX.kext, você NÃO precisa de agdpmod=pikera. The fix is already included in NootRX!

Useful Resources and Links

Official documentation and essential tools

Frequently Asked Questions

Common questions and answers

Which SMBIOS should I use?

For desktop with dedicated AMD GPU: MacPro7,1 (recommended for Sequoia/Tahoe) or iMacPro1,1. For desktop with Intel iGPU: iMac20,1/20,2.

Do I need agdpmod=pikera?

NO if using MacPro7,1 + NootRX.kext! The fix is included in NootRX. Only iMac/iMacPro SMBIOS without NootRX need it.

Does RX 6700 XT work in macOS?

YES! But it needs NootRX.kext. No native support, but works perfectly in Sequoia 15.x with NootRX.

Does Alder Lake (12th Gen) work?

YES! But requires CPU spoofing (Comet Lake) and CpuTopologyRebuild.kext for E-cores.

Does Intel Wi-Fi work?

YES! Use itlwm.kext + HeliPort.app. AirDrop/Handoff do NOT work. For full functionality, use Broadcom.

How to update OpenCore?

Download new version, replace OpenCore.efi and drivers, compare config.plist sample and update Quirks.

Troubleshooting

How to fix common boot errors

Black Screen after boot?
  • Check if using NootRX.kext (for RX 6000)
  • Remove agdpmod=pikera if using MacPro7,1 + NootRX
  • Check if WhateverGreen and NootRX are not together
  • Confirm Above 4G Decoding is enabled in BIOS
Kernel Panic on boot?
  • Add debug=0x100 keepsyms=1 to boot-args
  • Check if all kexts are updated
  • Confirm Lilu.kext loads first
  • Check Kernel quirks in config.plist
Audio not working?
  • Check if AppleALC.kext is installed
  • Configure correct layout-id in DeviceProperties
  • Test different layouts (common: 1, 7, 11, 13)
  • Add alcid=X to boot-args (X = layout)

Hackintosh and Beyond Tools

Professional tools developed by Hnanoto to facilitate EFI creation

Official Channel: Hackintosh and Beyond on YouTube
GitHub: github.com/hnanoto
Developer: Hnanoto - Creator of essential tools for the Hackintosh community

Tops Tools 2.0

The definitive ALL-IN-ONE tool for Hackintosh!

macOS application that centralizes 23+ essential tools in a modern SwiftUI interface.

Key Features:

  • Mass download of tools
  • Dependency management (Python)
  • Automatic update check
  • Modern SwiftUI Interface
  • Multi-language support
  • Smart tool organization
  • Direct execution of tools
  • Regular updates

Included Tools (23+):

OpenCorePkg
OcBinaryData
ProperTree
Hackintool
MountEFI
SSDTTime
gibMacOS
GenSMBIOS
USBMap
OC-Update
CPU-Name
gibMacRecovery
CloverBootloader
Lilu-and-Friends
Update_Clover
update_opencore
Open_EFIs_FSKIT
Python 3
Hackintool-On-AppleSilicon
OpCore-Simplify
Hardware-Sniffer
OpenCore Binaries
MaciASL
Download Tops Tools 2.0

OpCore Simplify

Smart and automated EFI builder

  • Automatic hardware report generation
  • macOS version selection
  • ACPI customization
  • Smart kext selection
  • Automatic EFI folder build
  • Ideal for beginners and experts

Result in 'results' folder ready for use

Hardware Sniffer

Automatic hardware detection

  • Identifies CPU, GPU, RAM
  • Detects motherboard and chipset
  • Lists PCI/USB devices
  • Recommends suitable SMBIOS
  • Suggests required kexts
  • Exports complete report

Update Scripts

Automatic bootloader updaters

  • update_opencore - Updates OpenCore
  • Update_Clover - Updates Clover
  • Automatic version download
  • Previous EFI backup
  • Preserves configuration
  • Optimized Python scripts

Lilu and Friends

Custom kext compiler

  • Compiles kexts from source
  • Custom versions
  • Specific patches
  • Debug builds available
  • Ideal for development
  • Support for multiple kexts

Open EFIs FSKIT

Collection of ready-made EFIs

  • Pre-configured EFIs
  • Diverse hardware supported
  • Base for customization
  • Regularly updated
  • Documentation included
  • Active Community

CPU-Name

CPU Name Correction

  • Displays correct CPU name
  • Automatic patches
  • Intel and AMD support
  • SMBIOS integration
  • Easy configuration
  • Compatible with all versions
Learn more on the official channel!
The channel Hackintosh and Beyond offers complete tutorials, step-by-step guides, and support for all these tools.
Subscribe to stay updated with the latest news and tools from the Hackintosh community!

Special Credits

Developed by: Hnanoto

Channel: Hackintosh and Beyond

Hackintosh and Beyond © 2025. All rights reserved.

Join the Community!

Become a VIP Member

Get exclusive benefits, early access to tools, and priority support!

Join Now

Discord

Active community with real-time support

Join Discord

Telegram

Official group for discussions and news

Join Telegram

Support the Project

Help keep tools free

Donate via PayPal

hackintoshandbeyond@gmail.com

How to Find Us

Join the biggest Hackintosh community!

Post-Installation

Essential configurations after installing macOS

Congratulations! macOS installed successfully!
Now let's configure essential features for a perfect Hackintosh.

How to Follow this Guide

Not all sections are mandatory. Focus on what is essential for your hardware:

Universal & USB:
Recommended for ALL (Stability).
Laptops:
Essential for battery and trackpad.
Security:
FileVault and SIP (Optional).
Cosmetics:
GUI, Boot Chime, Dual Boot.

1. USB Mapping (CRITICAL)

USB mapping is ESSENTIAL for stability, sleep, and device compatibility.

Why map USB?

  • macOS has a 15 USB port limit
  • Prevents sleep/wake issues
  • Improves general system stability
  • Fixes issues with Bluetooth/WiFi
  • Required for iServices to work

Mapping Tools

Tool Platform Difficulty Recommended
USBToolBox Windows + macOS Easy ✅ Yes
Hackintool macOS Medium ✅ Yes
USBMap macOS Advanced ⚠️ Advanced
# USBToolBox - Recommended Method # Download: https://github.com/USBToolBox/tool # On Windows: execute Windows.exe # On macOS: python3 USBToolBox.py # Steps: # 1. Choose "D" to discover ports # 2. Connect devices to each port # 3. Choose "S" to select ports # 4. Choose "K" to generate kext # 5. Copy UTBMap.kext to EFI/OC/Kexts/
Important: Remove XhciPortLimit quirk after mapping USB!

2. Fixing Sleep/Wake

Settings for sleep and wake to work perfectly.

pmset Settings

# Disable hibernation sudo pmset -a hibernatemode 0 sudo rm /var/vm/sleepimage sudo mkdir /var/vm/sleepimage # Disable Power Nap sudo pmset -a powernap 0 # Disable wake on LAN sudo pmset -a womp 0 # Configure darkwake sudo pmset -a darkwake 0 # Check settings pmset -g

BIOS Settings for Sleep

  • Disable Wake on LAN
  • Disable USB Wake
  • Enable XHCI Hand-off
  • Disable ErP (if available)

Advanced Troubleshooting (Culprits)

Displays & Laptops
  • Lid Wake (HP/Skylake+): Fix random wake caused by lid. Use SSDT-HP-FixLidSleep.
  • Fix Temp: sudo pmset -a lidwake 0
RTC (Real Time Clock)

Fix "BIOS Restarted in Safemode" on Z390+.

  • Fix 1: DisableRtcChecksum (Kernel -> Quirks)
  • Fix 2: RTCMemoryFixup.kext + rtcfx_exclude=58-59
NVMe & USB
  • Avoid: Samsung PM981/PM991, Micron 2200S
  • Fix: Use NVMeFix.kext
  • USB: Map USB ports properly (Max 15)
Darkwake boot-args

Try different values if sleep fails 1 sec after wake:

darkwake=0, 1, 2, 3, 8, 10, 512

3. Configuring iServices (iMessage, FaceTime)

Steps to get iMessage and FaceTime working.

WARNING: Use UNIQUE serials! Never use serials from other people or pre-made EFIs!

Step by Step

  1. Generate unique SMBIOS
    # Use GenSMBIOS python3 GenSMBIOS.command # Choose option 1 to download MacSerial # Choose option 2 to select SMBIOS # Choose option 3 to generate serial # Use MacPro7,1 or iMac20,1
  2. Check serial - Go to checkcoverage.apple.com and check. It must show "Unable to verify".
  3. Configure ROM - Use the MAC address of your Ethernet card (without colons).
  4. Clear NVRAM - Reboot and obtain "Reset NVRAM" in boot picker.
  5. Login to iCloud - Wait 24-48h for full activation.

4. Power Management

Optimize power consumption and CPU performance.

Intel Power Management

  • Use SSDT-PLUG.aml (mandatory)
  • CPUFriend.kext for fine tuning
  • CPUFriendDataProvider.kext (generated)
# Generate CPUFriendDataProvider git clone https://github.com/corpnewt/CPUFriendFriend cd CPUFriendFriend python3 CPUFriendFriend.command # Choose LFM (Low Frequency Mode): # - 800 MHz for best savings # - 1200 MHz for balanced # - Base frequency for performance

AMD Power Management

  • Use DummyPowerManagement = True
  • AMDRyzenCPUPowerManagement.kext (optional)
  • SMCAMDProcessor.kext for sensors

5. DRM (Netflix, Apple TV+, Amazon Prime)

Configure DRM for streaming to work.

Service Requirement Solution
Netflix (Safari) Native DRM Works with iGPU or AMD GPU
Apple TV+ FairPlay DRM Requires iGPU or AMD Polaris+
Amazon Prime Widevine Works on any GPU
Tip: To test DRM, use the website drm-test.appspot.com

Fixing Audio (AppleALC)

Enabling native audio using AppleALC.

1. Find your Audio Codec

Use Hackintool (Audio tab) or check Windows Device Manager to find your Realtek codec name (e.g. ALC256, ALC892).

2. Choose a Layout ID

Consult the supported codecs list and test layout-ids one by one. View List

3. Apply (boot-args)

alcid=1 # (Replace 1 with your layout-id)
HP Laptops: Often require SSDT-HP-FixHPET for audio to work.

Intel Power Management

# Gerar CPUFriendDataProvider git clone https://github.com/corpnewt/CPUFriendFriend cd CPUFriendFriend python3 CPUFriendFriend.command # Escolha LFM (Low Frequency Mode): # - 800 MHz para melhor economia # - 1200 MHz para balanced # - Frequência base para performance

AMD Power Management

5. DRM (Netflix, Apple TV+, Amazon Prime)

Configurar DRM para streaming funcionar.

Serviço Requisito Solução
Netflix (Safari) DRM nativo Funciona com iGPU ou AMD GPU
Apple TV+ FairPlay DRM Requer iGPU ou AMD Polaris+
Amazon Prime Widevine Funciona em qualquer GPU
Dica: Para testar DRM, use o site drm-test.appspot.com

Fixing Audio (AppleALC)

Habilitando áudio nativo usando AppleALC.

1. Descubra seu Codec de Áudio

Use o Hackintool (aba Áudio) ou verifique o Gerenciador de Dispositivos do Windows para encontrar o nome do seu codec Realtek (ex: ALC256, ALC892).

2. Escolha um Layout ID

Consulte a lista de codecs suportados e teste os layout-ids um por um. Ver Lista

3. Aplique (boot-args)

alcid=1 # (Substitua 1 pelo seu layout-id)
Laptops HP: Frequentemente requerem SSDT-HP-FixHPET para o áudio funcionar.

Cosmetics (OpenCanopy & Tips)

Make your Hackintosh look premium during boot.

Enable Graphical GUI (OpenCanopy)
  1. Download OcBinaryData (Resources folder).
  2. Add OpenCanopy.efi to Drivers.
  3. Config.plist -> Misc -> Boot -> PickerMode: External.
  4. Config.plist -> Misc -> Boot -> PickerAttributes: 17.
Enable Boot Sound (Chime)
  1. Enable AudioDxe.efi driver in UEFI -> Drivers.
  2. UEFI -> Audio -> AudioSupport: True.
  3. UEFI -> Audio -> AudioCodec: 0.
  4. UEFI -> Audio -> AudioOutMask: -1.
  5. NVRAM -> 7C436110-AB2A-4BBB-A880-FE41995C9F82 -> SystemAudioVolume: 46.
Hide Verbose Text (-v)

Remove only after your system is 100% stable!

  • NVRAM -> UUID -> boot-args: Remove -v.

6. Dual Boot (macOS + Windows/Linux)

Configure dual boot properly.

Best Practices

Synchronize Time

# On Windows (as Administrator): reg add "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\TimeZoneInformation" /v RealTimeIsUniversal /d 1 /t REG_DWORD /f # Or on macOS: sudo systemsetup -setusingnetworktime on

Maintenance and Security

Guide to keep your Hackintosh secure and updated

How to Update (Safe)

Follow this order to avoid breaking the system:

Security (SIP & FileVault)

SIP (System Integrity Protection)

Disable (csr-active-config: FF0F0000) only to install kexts in /System (Root Patching). For normal use, keep enabled (00000000).

FileVault (Encryption)

Requires complex configuration (Misc -> Security -> Vault). Do not enable without reading official docs, or you will lose data access.

ACPI and SSDTs Explained

Understand what each SSDT does and when to use it

What is ACPI?
ACPI (Advanced Configuration and Power Interface) is a specification that defines hardware tables for the OS. SSDTs are secondary tables that add or modify functionality.

SSDT-EC-USBX

What it does:

When to use:

SSDT-PLUG

What it does:

When to use:

SSDT-AWAC

What it does:

When to use:

SSDT-PMC

What it does:

When to use:

SSDT-RHUB

What it does:

When to use:

SSDT-PNLF (Laptops)

What it does:

When to use:

SSDT-GPI0 (Laptops)

What it does:

When to use:

SSDT-CPUR (AMD)

What it does:

When to use:

How to Compile SSDTs

Use SSDTTime to generate automatically

# Download SSDTTime git clone https://github.com/corpnewt/SSDTTime cd SSDTTime python3 SSDTTime.command # Available options: # 1. FixHPET - Fix HPET IRQ conflicts # 2. FakeEC - Creates fake EC # 3. PluginType - Generates SSDT-PLUG # 4. PMC - Generates SSDT-PMC # 5. AWAC - Generates SSDT-AWAC # 6. USB Reset - Generates SSDT-RHUB

📋 Required SSDTs by Platform

Tip: Use SSDTTime to automatically generate the necessary SSDTs for your hardware!

🖥️ Desktop Intel:

Generation Required SSDTs
Penryn - Ivy Bridge SSDT-EC + CPU-PM (manual)
Haswell - Skylake SSDT-EC + SSDT-PLUG
Kaby Lake - Coffee Lake SSDT-EC-USBX + SSDT-PLUG
Comet Lake (400-series) SSDT-EC-USBX + SSDT-PLUG + SSDT-AWAC + SSDT-RHUB
Rocket Lake (500-series) SSDT-EC-USBX + SSDT-PLUG + SSDT-AWAC + SSDT-RHUB
Alder/Raptor Lake (600/700) SSDT-EC-USBX + SSDT-PLUG-ALT + SSDT-AWAC + SSDT-RHUB

💻 Laptop Intel:

Attention: Laptops need ALL desktop SSDTs + SSDT-PNLF + SSDT-GPI0 (if I2C trackpad)

🔴 Desktop AMD:

Platform Required SSDTs
B450, X470, X570 SSDT-EC-USBX
B550, A520 SSDT-EC-USBX + SSDT-CPUR

Detailed Config.plist

Fine-tuning for maximum stability and performance

Booter Quirks

Essential fixes for the bootloader to load the kernel.

Quirk Description Platform
AvoidRuntimeDefrag Fixes UEFI runtime services All
EnableSafeModeSlide Allows usage of safe mode (Shift) All
EnableWriteUnprotector Allows writing to protected memory Intel < 9th Gen
RebuildAppleMemoryMap Rebuilds memory map for compatibility Intel > 9th Gen

DeviceProperties (GPU Patching)

Essential configuration for Intel iGPU (Intel HD/UHD Graphics).

Graphics Accelerator (iGPU)

PciRoot(0x0)/Pci(0x2,0x0) ├── AAPL,ig-platform-id | Data | 07009B3E ├── device-id | Data | 9B3E0000 ├── framebuffer-patch-enable | Data | 01000000
Warning: Dedicated AMD GPUs usually don't need DeviceProperties, only boot-args or SSDTs!

Kernel Quirks

Patches applied directly to the macOS kernel.

Misc (Security & Boot)

Critical security and boot behavior settings.

Security

Boot

NVRAM (Boot-args)

Common boot arguments.

Argument Description
-v Verbose Mode (shows text logs on boot). Essential for debug.
debug=0x100 Prevents auto reboot on Kernel Panic.
keepsyms=1 Shows debug symbols in Kernel Panic (helps identify cause).
alcid=1 Default Layout ID for AppleALC. Change number according to your codec.
agdpmod=pikera Required for AMD Navi GPUs (RX 5000/6000). Fixes black screen.
amfi=0x80 Disables AMFI (Required for OCLP on Sonoma/Sequoia).

Platform Recommendations

💻 Laptops (Intel)

🖥️ Desktops (AMD)

Advanced Troubleshooting

Diagnosis and solution for complex issues

Understanding Kernel Panics

If PC reboots before loading:

  1. Add debug=0x100 keepsyms=1 to boot-args
  2. Add -v for verbose mode
  3. Record the screen at the moment of crash

Common Errors:

Graphics Issues (GPU)

Audio (AppleALC)

If audio doesn't work even with AppleALC and alcid:

  1. Check if HPET is fixed (SSDTTime FixHPET)
  2. Confirm audio controller appears in Hackintool
  3. Try boot-arg alcdelay=1000 (delays loading)

🚫 Specific Boot Issues

Stuck at [EB|#LOG:EXITBS:START]:
  • Problem with Booter Quirks. Try enabling DevirtualiseMmio
  • Check RebuildAppleMemoryMap and SyncRuntimePermissions
  • For Z390+: Disable SetupVirtualMap
Stuck at "Waiting for Root Device":
  • USB Issue: Try different USB 2.0 ports, use USBInjectAll.kext temporarily
  • SATA Issue: Check if SATA is in AHCI mode (not RAID/IDE)
  • Problematic NVMe: Add NVMeFix.kext (PM981/PM991)
# Useful debug boot-args: -v # Verbose mode (shows boot log) debug=0x100 # Disables watchdog (prevents panic reboot) keepsyms=1 # Keeps symbols in kernel panic alcid=1 # Audio Layout ID agdpmod=pikera # For Navi GPUs (RX 5000/6000) -wegnoegpu # Disables dedicated GPU (laptops)

💀 Specific Kernel Panics

Error Cause Solution
AppleIntelMCEReporter Dual-socket or HEDT Add AppleMCEReporterDisabler.kext
AppleIntelCPUPowerManagement Missing SSDT-PLUG Generate SSDT-PLUG with SSDTTime
IOPCIFamily (X99) Above 4G Decoding Enable Above 4G in BIOS + ResizeAppleGpuBars
cckprng_int_gen Missing SSE4.2 CPU too old (pre-Nehalem)
AppleIntelI210Ethernet Intel I225-V/I210 Add specific device properties

🖥️ GPU Problems

Black Screen after IOConsoleUsers:
  • Navi GPUs (RX 5000/6000): Add agdpmod=pikera (if not using NootRX)
  • Intel iGPU: Check DeviceProperties (AAPL,ig-platform-id)
  • NVIDIA: Not supported in Monterey+ (use -wegnoegpu)
Scrambled Screen on Laptops:
Add -igfxmlr boot-arg (WhateverGreen) to force max panel resolution.

Common Framebuffer Patches:

# DeviceProperties for Intel iGPU (Coffee Lake example) PciRoot(0x0)/Pci(0x2,0x0) AAPL,ig-platform-id 07009B3E # Headless (no monitor on iGPU) device-id 9B3E0000 # Fake ID if needed framebuffer-patch-enable 01000000 framebuffer-stolenmem 00003001 # 48MB # For laptops with internal panel: AAPL,ig-platform-id 00009B3E # With video output

🔌 USB Problems

15 Port Limit:
macOS has a limit of 15 USB ports per controller. Use USBMap or USBToolBox to map correctly.
XhciPortLimit:
  • macOS 11.3+: XhciPortLimit does NOT work anymore!
  • Use USBInjectAll.kext + manual mapping
  • Or use USBToolBox.kext (recommended)

USB Mapping Steps:

  1. Download USBToolBox (Windows) or USBMap (macOS)
  2. Identify all USB ports by testing with a pendrive
  3. Select the 15 most important ports (USB 2.0 + USB 3.0)
  4. Generate USBMap.kext or UTBMap.kext
  5. Remove USBInjectAll.kext and disable XhciPortLimit

✅ Post-Installation Problems

Sleep/Wake Issues:

iServices (iMessage/FaceTime):

Check:
  • Valid Serial Number but NOT in use (check at checkcoverage.apple.com)
  • En0 (Ethernet) as primary interface
  • ROM = Ethernet card MAC address
  • Valid MLB matching the Serial

Audio doesn't work:

  1. Check if AppleALC.kext is loaded (kextstat | grep AppleALC)
  2. Test different layout IDs (alcid=1, alcid=2, etc.)
  3. Check if HPET is fixed (SSDT-HPET)
  4. Consult supported codecs

🛠️ Debug Tools

Tool Function Command/Usage
Hackintool All-in-one for debug GitHub
IORegistryExplorer View devices and properties GitHub
gfxutil Find GPU DevicePath ./gfxutil -f display
kextstat List loaded kexts kextstat | grep -v apple
pmset Power management pmset -g
log show View system logs log show --last boot

Glossary of Terms

Definitions of Hackintosh technical terms

A

ACPI

Advanced Configuration and Power Interface - Standard interface for power management and hardware configuration

AMFI

Apple Mobile File Integrity - Security layer that enforces code signing and library validation.

AVX / AVX2

Advanced Vector Extensions - CPU instructions required for modern macOS (AVX2 required for Sonoma+).

B

Bootloader

Software responsible for loading the operating system (e.g. OpenCore)

C

Config.plist

The main configuration file for OpenCore that stores all your Hackintosh settings.

D

DSDT

Differentiated System Description Table - The main ACPI table that describes your system hardware.

E

EFI Partition

Extensible Firmware Interface - A small partition on your disk where the bootloader lives.

G

Gatekeeper

Security technology that ensures only trusted software runs on your Mac.

K

Kext

Kernel Extension - Drivers for macOS (similar to .sys/.inf on Windows)

Kernel Panic

A critical system error that causes macOS to restart or hang (the "Blue Screen" of Mac).

M

Metal

Apple's high-performance graphics API. Modern macOS requires a Metal-compatible GPU.

N

NVRAM

Non-Volatile Random Access Memory - Memory that stores system settings even after power off

O

OpenCore

Modern and secure bootloader for Hackintosh, successor to Clover

Q

Quirk

Specific fix or patch to resolve hardware incompatibilities

S

SIP

System Integrity Protection - A security feature that protects the most sensitive parts of the operating system.

SMBIOS

System Management BIOS - Defines which Mac model your Hackintosh will emulate

SSDT

Secondary System Description Table - Secondary ACPI tables that add or modify functionality

U

UEFI

Unified Extensible Firmware Interface - Modern replacement for legacy BIOS

USB Mapping

The process of defining which physical USB ports will be active in macOS to stay under the 15-port limit.

V

Verbose Mode

Boot mode that shows detailed system logs (boot-arg: -v)