A Python-based project revolving around Acidanthera's OpenCorePkg and Lilu for both running and unlocking features in macOS on supported and unsupported Macs.
⚠️ ⚠️ ⚠️ ⚠️ ⚠️ Warning No support for macOS 27 Golden Gate and newer versions of macOS because macOS 27 Golden Gate and newer versions are arm64-only, so only for Apple Silicon Macs. So the answer is clear. macOS 26 Tahoe is the last supported macOS version by this project.
⚠️ ⚠️ ⚠️ ⚠️ ⚠️ Warnung macOS 27 Golden Gate und neuere macOS-Versionen sind nicht unterstützt, weil diese sind nur für Apple Silicon/arm64 Macs. Also die Antwort ist klar. macOS 26 Tahoe ist die letzte Version, die von dieser Projekt unterstützt wird.
⚠️ EXPERIMENTAL FORK — Adds macOS 15 Sequoia and macOS 26 Tahoe support for T2 Macs. T2 Macs as of now are unsupported by the official OpenCore Legacy Patcher from Dortania. Use it at your own risk. It's still in alpha stage, so I highly recommend to backup all your data and do it only on a spare T2 Mac to experiment. This is experimental alpha software.
⚠️ Attention, please! If you download OpenCore Legacy Patcher T2 from Code > Download, you may run into bugs because I'm writing the code mostly directly from GitHub's interface. If you want to avoid running into weird bugs, I recommend to download from Releases instead.
⚠️ Warnung! Wenn Sie OpenCore Legacy Patcher T2 über Code > Download herunterladen, in der App kann einige Bugs auftreten, weil ich den Code größtenteils direkt über GitHubs Oberfläche schreibe. Um diese zu vermeiden, es ist empfohlen den OpenCore Legacy Patcher T2-App stattdessen über Releases herunterzuladen.
🚧 Not ready for general use
Progress:
- Upgrade config.plist to OpenCore 1.0.7 - done
- Upgrade WhateverGreen and Lilu to the latest version - done
- Upgrade OpenCore-RELEASE.zip to OpenCore 1.0.7
- Upgrade OpenCore-DEBUG.zip to OpenCore 1.0.7
- Fix albert-mueller#23 - done
- Update RestrictEvents to 1.1.6 - done
- Update CryptexFixup to 1.0. - done
- Update FeatureUnlock to 1.1.8 - done
- Set DisableIoMapper to True for T2 Macs - done
- Remove USB port mapping for MacBookAir8,1 and 8,2 - done
- Fix albert-mueller#25
- Return support for MacBookAir8,1 and MacBookAir8,2
- Installer boots
- MacBookAir8,1 and MacBookAir8,2 can boot the installer
- Internal hard drive mounts properly on T2 Macs - albert-mueller#69
- Post-install + ability to reach the desktop
- GPU accelaration/WiFi - most T2 Macs will have WIFi and possibly GPU accelaration out of the box
Our goal of this project is to add support for T2 Macs so unsupported T2 Macs can boot into Sequoia and Tahoe. This project may run on non-T2 Macs, but support is limited for those and that's not the focus of this project.
Noteworthy features of OpenCore Legacy Patcher:
- Support for macOS Big Sur, Monterey, Ventura, Sonoma, Sequoia and eventually add support for Tahoe.
- 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. Here's an exception: if you are already using patchers like OCLP-Mod or the official OpenCore Legacy Patcher by Dortania, you can revert the root patches and upgrade to this patcher. But that's not the case with OCLP-Plus, since OCLP-Plus leaves the integrity with APFS snapshots and SIP broken.
- 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 Sonoma 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
To start using the project, please see our in-depth guide:
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.
To run the project from source, see here: Build and run from source
-
- OpenCorePkg, as well as many of the core kexts and tools
-
- Main co-author
-
- Main co-author
- Great amounts of help with debugging, and code suggestions
-
- iMacs Metal GPUs Upgrade Patch set and documentation
-
- Adding support for unsupported T2 Macs and the main author of this fork
- Help troubleshooting, determining fixes and writing patches
-
- Fix modern wireless on unsupported T2 Macs running macOS 26 Tahoe
-
- developing patches for the T2 chip
- Developing Secure Enclave Processor (SEP) timeout patches
- workflow files
*peltorio
- Fix a critical bug in GitHub Actions by changing macos-version to macos-15
-
- for research on MacBook Air 2018-2019 hardware to fix boot issues
-
- for fixing a bug in OpenCore Legacy Patcher T2 where USB-Map.plist's syntax was invalid and SMBIOS spoofing bug that prevented SMBIOS spoofing from working properly on T2 Macs
- fix graphics accelaration on Intel UHD Graphics 630 on unsupported T2 Macs
- fix your Mac is not supported by macOS 26 Tahoe
- fix Unsupported Mantissa speed kernel panics on T2 MacBooks
-
- 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 MetallibSupportPkg for nVidia Kepler and Intel Core 3rd/4th Generation GPUs
- Metal bundle patches and shims for nVidia Kepler, AMD GCN 1 - 4, and AMD GCN 5 (Vega)
- IOSurface offset patches for nVidia Kepler, AMD GCN 1 - 5, and Intel Core 3rd - 6th Generation GPUs
- legacy Wi-Fi patch set restores functionality for Wi-Fi cards in all 2007 - 2017 models
- T1 patch set restores Touch ID, Apple Pay, and other secure functionality in 2016 - 2017 models
- AppleGVA downgrade for accelerated video decoding on 2012 - 2016 models
- OpenCL and OpenGL downgrade for AMD GCN
- USB 1 patch
-
- non-Metal patch set for nVidia Tesla/Fermi/Maxwell/Pascal, AMD TeraScale 1/2, and Intel Core 1st/2nd Generation GPUs
-
- non-Metal patch set for nVidia Tesla/Fermi/Maxwell/Pascal, AMD TeraScale 1/2, and Intel Core 1st/2nd Generation GPUs
- Metal bundle interposer for AMD GCN 1 - 5 and Intel Core 5th/6th Generation GPUs
- dsce and shared code used by some other patches
-
- Mac Pro on OpenCore Patch set and documentation
- Innie and NightShiftEnabler
-
- AAAMouSSE, telemetrap and SurPlus
-
- Main author of the original GUI
- Development of previous patchers, laying out much of what needs to be patched
-
- Development of previous patchers, laying out much of what needs to be patched
-
mario_bros_tech and the rest of the Unsupported Mac Discord
- Catalyst that started OpenCore Legacy Patcher
-
- SimpleMSR to disable firmware throttling in Nehalem+ MacBooks without batteries
-
- Endless hours helping architect and troubleshoot many portions of the project
-
- Aid with Nvidia Web Driver research and development
- non-Metal patch set for nVidia Tesla/Fermi/Maxwell/Pascal, AMD TeraScale 1/2, and Intel Core 1st/2nd Generation GPUs
- Metal bundle interposer for AMD GCN 1 - 5 and Intel Core 5th/6th Generation GPUs
- LegacyRVPL, SnapshotIsKill, etc. to aid in rapid testing and development
-
- Research and various contributions to the project
- UEFI Legacy XHCI research and development
- NVIDIA OpenCL research and development
MacBook5,2research and development- LegacyKeyboardInjector
- Pre-Ivy Bridge Aquantia Ethernet Patch
- Non-Metal Photo Booth Patch for Monterey+
- GUI and Backend Development
- Updater UI
- macOS Downloader UI
- Downloader UI
- USB Top Case probing
- Developer root patching
- Vaulting implementation
- macOS 15 3802 Helios Research
- UEFI bootx64.efi research
- universal2 build research
- Various documentation contributions
-
Amazing users who've graciously donate hardware:
- JohnD - 2013 Mac Pro
- SpiGAndromeda - AMD Vega 64
- turbomacs - 2014 5k iMac
- vinaypundith - MacBook7,1
- ThatStella7922 - 2017 13" MacBook Pro (A1708)
- zephar - 2008 Mac Pro
- jazo97 - 2011 15" MacBook Pro
- And others (reach out if we forgot you!)
-
MacRumors and Unsupported Mac Communities
- Endless testing and reporting issues
-
Apple
- for macOS and many of the kexts, frameworks and other binaries we reimplemented into newer OSes