+12
日增长
+144
周增长
+356
月增长
18,981
stars
2,084
forks
852
watchers
249
prs
915
issues
96
releases
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
Top issues
#72Hibernation Issues with OpenCore150 comments · 2021-03-02#948Universal Control: Advanced option available after patch but linked device not available30 comments · 2022-02-07#270Windows EFI Partition/boot option disappears in OCLP as soon as you use the "Select Bootdisk" option in either MacOS or Windows.8 comments · 2021-06-07#998macOS Ventura and OpenCore Legacy Patcher Support5 comments · 2022-06-10#783AirPlay to Mac with macOS 12.1 and iMac14,x4 comments · 2021-12-09#316Implement Lower Power Mode (LPM) for older Macs in macOS Monterey3 comments · 2021-06-19#108Legacy Non-Metal GPUs and macOS Big Sur - Sequoia2 comments · 2021-03-18#1190GUI Rework1 comments · 2026-11-08
Discussions
#1165CoreWiFi patches cause slowdowns on macOS 15.0 and later1 comments · 2025-06-13#1152Is it possible to patch legacy USB 1.1 automatically?1 comments · 2024-12-28#1141FeatureUnlock causing chronic instability and crashing on certain machines0 comments · 2024-07-21#10722-Finger Trackpads are botched in macOS 10.12+0 comments · 2023-05-27#1050`SIGILL` on com.apple.audio.IOThread.client1 comments · 2023-04-13#1046Xcode's `lldb-rpc-server` crashing on macOS 13.31 comments · 2023-04-08#1045AppleAHCIPort repeatedly logging aborts on various systems running Ventura 13.30 comments · 2023-04-02#1044Metal rendering issues on 3802, Ventura 13.32 comments · 2023-03-30
Latest release
2.5.1 2.5.1 2026-09-192.5.1 is a small bug fix release for "Root Volume Dirty" error appearing in some cases as well as introducing more clarity. ---------- - Fix "Root Volume Dirty" appearing after unpatching. - Reword "Root Volume Dirty" to be clearer for users. ---------- Full Changelog 2.5.1 Changelog (click to expand) - Fix "Root Volume Dirty" appearing after unpatching if seal remains broken, for example when an update is pending. - Thanks @crystall1nedev - Reword "Root Volume Dirty" to be clearer for users about what it means. - Thanks @crystall1nedev Asset Infor