README

OpenCore Legacy Patcher


A Python-based project revolving around Acidanthera's OpenCorePkg and Lilu for both running and unlocking features in macOS on supported and unsupported Macs.

Our project's main goal is to breathe new life into Macs no longer supported by Apple, allowing for the installation and usage of macOS Big Sur and newer on machines as old as 2007.

----------

!GitHub all releases !GitHub top language !Discord

----------

Noteworthy features of OpenCore Legacy Patcher:

 Support for macOS Big Sur, Monterey, Ventura, Sonoma, and Sequoia
 Native Over the Air (OTA) System Updates
 Supports Penryn and newer Macs
 Full support for WPA Wi-Fi and Personal Hotspot on BCM943224 and newer wireless chipsets
 System Integrity Protection, FileVault 2, .im4m Secure Boot and Vaulting
 Recovery OS, Safe Mode and Single-user Mode booting on non-native OSes
 Unlocks features such as Sidecar and AirPlay to Mac even on native Macs
 Enables enhanced SATA and NVMe power management on non-Apple storage devices
 Zero firmware patching required (ie. APFS ROM patching)
 Graphics acceleration for both Metal and non-Metal GPUs

----------

Note: Only clean-installs and upgrades are supported. macOS Big Sur installs already patched with other patchers, such as Patched Sur or bigmac, cannot be used due to broken file integrity with APFS snapshots and SIP.

 You can, however, reinstall macOS with this patcher and retain your original data

Note 2: Currently, OpenCore Legacy Patcher officially supports patching to run macOS Big Sur through Tahoe installs. For older OSes, OpenCore may function; however, support is currently not provided from Dortania.

 For macOS Mojave and Catalina support, we recommend the use of dosdude1's patchers

 Getting Started

To start using the project, please see our in-depth guide:

 OpenCore Legacy Patcher Guide

 Support

This project is offered on an AS-IS basis, we do not guarantee support for any issues that may arise. However, there is a community server with other passionate users and developers that can aid you:

 OpenCore Patcher Paradise Discord Server
   Keep in mind that the Discord server is maintained by the community, so we ask everyone to be respectful.
   Please review our docs on how to debug with OpenCore to gather important information to help others with troubleshooting.

 Running from source

To run the project from source, see here: Build and run from source

 Credits

 Acidanthera
   OpenCorePkg, as well as many of the core kexts and tools
 DhinakG
   Main co-author
 Khronokernel
   Main co-author
 Ausdauersportler
   iMacs Metal GPUs Upgrade Patch set and documentation
   Great amounts of help with debugging, and code suggestions
 vit9696
   Endless amount of help troubleshooting, determining fixes and writing patches
 EduCovas
   macOS Tahoe patch set
   non-Metal patch set for nVidia Tesla/Fermi/Maxwell/Pascal, AMD TeraScale 1/2, and Intel Core 1st/2nd Generation GPUs
   3802 Metal patch set and Metallib