Lilu

Lilu

by Acidanthera
Essential

Essential Lilu kext for Hackintosh - provides patching infrastructure and plugin support for other kexts

Download GitHub
Advertisement
Advertisement (336×280)

Lilu

Lilu is an essential kernel extension that provides patching infrastructure for other kexts. It’s a foundational component for most Hackintosh builds, enabling other plugins to function properly.

Overview

Lilu itself doesn’t provide any direct functionality to the end user. Instead, it serves as a platform that other kexts (called “plugins”) use to apply patches to macOS. Without Lilu, many popular kexts like WhateverGreen, AppleALC, and VirtualSMC would not work.

Features

  • Kernel Patching Infrastructure: Provides a framework for other kexts to apply patches
  • Plugin System: Supports a wide range of plugins for various hardware components
  • Low Overhead: Minimal performance impact on the system
  • Wide Compatibility: Works with macOS 10.11 El Capitan through macOS 14 Sonoma

Installation

Prerequisites

  • OpenCore bootloader (0.7.0 or later)
  • macOS 10.11 or later

Steps

  1. Download the latest release from GitHub
  2. Extract the downloaded ZIP file
  3. Copy Lilu.kext to your EFI partition: EFI/OC/Kexts/
  4. Add the kext to your config.plist under Kernel > Add
  5. Ensure Lilu is loaded before any plugins that depend on it
  6. Reboot your system

config.plist Entry

<dict>
    <key>BundlePath</key>
    <string>Lilu.kext</string>
    <key>Comment</key>
    <string>Lilu kext</string>
    <key>Enabled</key>
    <true/>
    <key>ExecutablePath</key>
    <string>Contents/MacOS/Lilu</string>
    <key>MaxKernel</key>
    <string></string>
    <key>MinKernel</key>
    <string></string>
    <key>PlistPath</key>
    <string>Contents/Info.plist</string>
</dict>

Configuration

Lilu doesn’t require any special configuration. However, you can enable debug logging by adding the following boot argument:

liludbg=1

Note: Debug logging should only be enabled for troubleshooting, as it can impact performance.

Troubleshooting

Lilu is not loading

  • Ensure Lilu.kext is in EFI/OC/Kexts/
  • Verify the kext is added to config.plist under Kernel > Add
  • Check that Lilu is loaded before its plugins
  • Verify your OpenCore version is 0.7.0 or later

Plugins are not working

  • Ensure Lilu is loaded before the plugins
  • Check that plugin versions are compatible with your Lilu version
  • Verify all kexts are properly added to config.plist

System won’t boot after adding Lilu

  • Remove Lilu and its plugins temporarily
  • Check for kext conflicts
  • Verify your config.plist is valid
  • Try booting with -liluoff boot argument to disable Lilu

FAQ

Do I need Lilu if I’m not using any plugins?

No, Lilu is only required if you’re using kexts that depend on it (like WhateverGreen, AppleALC, VirtualSMC, etc.).

Can I use Lilu with Clover?

While Lilu can technically work with Clover, it’s recommended to use OpenCore for the best compatibility and support.

What’s the difference between Lilu and other patching kexts?

Lilu provides a unified framework for patching, making it easier for developers to create plugins. It’s more maintainable and flexible than individual patching kexts.

Is Lilu safe to use?

Yes, Lilu is open-source and widely used in the Hackintosh community. It’s developed by Acidanthera, a trusted name in the community.

Resources