Updated: 10 August 2026
Lilu is the foundational kernel extension patcher for macOS Hackintosh environments. It provides dynamic binary patching capabilities to user-space and kernel binaries in memory, allowing plugins to add features, fix graphics, inject audio codecs, and resolve hardware quirks without touching read-only system volumes.
1. Official Acidanthera Plugin Ecosystem
| Plugin | Primary Capability | Key Boot Arguments / Settings |
|---|---|---|
| WhateverGreen | GPU framebuffers, multi-display routing, DP/HDMI audio, DRM fixes. | agdpmod=pikera, -wegnoegpu, -rad24 |
| AppleALC | Native HD audio codec injection for Realtek, Conexant, and HDMI sound. | alcid=layout_id (e.g. alcid=1, alcid=11) |
| VirtualSMC | SMC emulation with modular sensors for CPU, GPU, motherboard, and battery. | vsmcgen=1 (force generation) |
| NVMeFix | Autonomous Power State Transition (APST) management and power optimization for third-party SSDs. | None required by default |
| RestrictEvents | System event management, CPU name string override, memory alert suppression, OTA update unblocking. | revpatch=..., revcpu=1 |
| CpuTopologyRebuild | Optimizes thread allocation on Intel hybrid architectures (Alder Lake, Raptor Lake). | None required |
| FeatureUnlock | Enables Sidecar, Universal Control, and AirPlay Receiver on unsupported hardware. | Requires compatible Wi-Fi & Bluetooth |
| CryptexFixup | Allows macOS Ventura, Sonoma, and Sequoia to boot on CPUs lacking native AVX2 support. | -cryptoff (to disable) |
| BlueToolFixup | Bluetooth stack injector required on macOS Monterey, Ventura, Sonoma, and Sequoia. | Companion to Intel or Broadcom Bluetooth kexts |
2. Diagnostic and Debug Boot Arguments
When diagnosing early kernel crashes or verifying plugin initialization:
-liludbg: Enables Lilu debug output in kernel logs.-liludbgall: Enables verbose debug output for Lilu and all loaded plugins.-liluoff: Temporarily disables Lilu and all dependent plugins for emergency rescue.-lilubetaall: Enables Lilu and plugins on unreleased/beta macOS builds.
3. Upgrade & Compatibility Workflow
- Update Lilu First: Never update dependent plugins without updating
Lilu.kextto the latest matching release. - Keep Release Channels Consistent: Match Debug kexts with Debug Lilu, and Release kexts with Release Lilu.
- Clean OpenCore Snapshot: Use ProperTree or OCAT to regenerate kernel entries after adding or removing plugins.
Reliable Starting Points
- Lilu GitHub Releases — Official binaries and changelogs.
- Acidanthera Repositories — Documentation and source trees for all official plugins.