Arbitrary kext and process patching on macOS
BSD-3-CLAUSE License
An open source kernel extension bringing a platform for arbitrary kext, library, and program patching throughout the system for macOS.
You should install this kext along with the plugin kexts depending on it. The prebuilt binaries are available on releases page. Several existing plugins possibly with code samples are available on known plugins page. To compile a plugin copy the debug version of Lilu.kext into its directory.
-liludbg
to enable debug printing (available in DEBUG binaries).-liludbgall
to enable debug printing in Lilu and all loaded plugins (available in DEBUG binaries).-liluoff
to disable Lilu.-liluuseroff
to disable Lilu user patcher (for e.g. dyld_shared_cache manipulations).-liluslow
to enable legacy user patcher.-lilulowmem
to disable kernel unpack (disables Lilu in recovery mode).-lilubeta
to enable Lilu on unsupported OS versions (macOS 14 and below are enabled by default).-lilubetaall
to enable Lilu and all loaded plugins on unsupported os versions (use very carefully).-liluforce
to enable Lilu regardless of the mode, OS, installer, or recovery.liludelay=1000
to enable 1 second delay after each print for troubleshooting.lilucpu=N
to let Lilu and plugins assume Nth CPUInfo::CpuGeneration.liludump=N
to let Lilu DEBUG version dump log to /var/log/Lilu_VERSION_KERN_MAJOR.KERN_MINOR.txt
after N secondsMost of the plugins cease to function in safe (-x
) mode.
By default Lilu itself does not function in single-user (-s
) mode, unless -liluforce
is present.
InsanelyMac topic in English AppleLife topic in Russian
For the contributors with programming skills the headers are filled with AppleDOC comments. Earlier code changes could be tracked in AppleALC project. Writing and supporting code is fun but it takes time. Please provide most descriptive bugreports or pull requests.