A Python-based project revolving around Acidanthera's OpenCorePkg and Lilu for both running and unlocking features in macOS on supported and unsupported Macs.
⚠️ On T2 Macs only, this patcher disables SIP completely to be able to boot macOS properly What is SIP? SIP, in short for System Integrity Protection, protects against attackers from tampering with core system files. However, on T2 Macs, SIP also causes thermal throttling and other issues when booting via OpenCorePkg, so it needs to be disabled, so setting SIP to 0xFFF is hardcoded into misc.py. As such, the SIP settings inside OpenCore Legacy Patcher T2 > Settings (or very soon, instead in the patcher > OpenCore) are mostly rendered useless on T2 Macs. This doesn’t apply to non-T2 Macs, such as T1 or non-T Macs
⚠️ Building EFIs on Hackintoshes is unsupported by this patcher! Building EFIs for Hackintoshes is unsupported by this patcher. I’ll explain clearly why: like Dortania’s OCLP, it generates EFIs for real Macs. They wouldn’t work on Hackintoshes. While OpenCore Legacy Patcher T2 uses OpenCore under the hood, real Macs boot differently macOS from a Hackintosh. Also, a GIGABYTE board with let’s say, i7-8700B may offer the exact same board with different configurations, so predicting what patches are needed is infeasible on something no one does know. Also, on the same board depending on the config you may need different boot arguments. And also, it doesn’t use OpenCore’s version of boot.efi, it uses the one that works on real Macs. Standard Hackintoshes rely on BOOTx64.efi. So calling that OpenCore Legacy Patcher T2 can build EFIs for Hackintoshes just because it uses OpenCore is propaganda - it's true that OpenCore works on Hackintoshes, but that's not true for the patcher itself - it either produces EFIs for Hackintoshes or real Macs, that's it. It can't produce for both. So the release note in 4.0.0.16050 says for itself: fixes a vulnerability where an attacker or bad Hackintosh user could trick a Hackintosh user into building OpenCore EFIs for real Macs by spoofing the SMBIOS as a Mac computer
⚠️ Das Erstellen von EFIs auf Hackintoshes wird von diesem Patcher nicht unterstützt! Das Erstellen von EFIs für Hackintoshes wird von diesem Patcher nicht unterstützt. Ich erkläre Ihnen den Grund: Wie Dortanias OCLP generiert er EFIs für echte Macs. Diese würden auf Hackintoshes nicht funktionieren. Obwohl der OpenCore Legacy Patcher T2 im Hintergrund OpenCore verwendet, booten echte Macs macOS anders als ein Hackintosh. Außerdem kann ein GIGABYTE-Board mit beispielsweise einem i7-8700B in verschiedenen Konfigurationen erhältlich sein. Daher ist es unmöglich vorherzusagen, welche Patches benötigt werden, wenn niemand die genaue Konfiguration kennt. Selbst auf demselben Board können je nach Konfiguration unterschiedliche Boot-Argumente erforderlich sein. Zudem verwendet er nicht die OpenCore-Version von boot.efi, sondern diejenige, die auf echten Macs funktioniert. Standard-Hackintoshes verwenden BOOTx64.efi. Die Behauptung, OpenCore Legacy Patcher T2 könne EFIs für Hackintoshes erstellen, nur weil er OpenCore verwendet, ist Propaganda. Zwar funktioniert OpenCore auf Hackintoshes, aber das stimmt nicht für den Patcher selbst. Er erstellt entweder EFIs für Hackintoshes oder für echte Macs, nicht für beides. Die Versionshinweise zu 4.0.0.16050 belegen dies: "fixes a vulnerability where an attacker or bad Hackintosh user could trick a Hackintosh user into building OpenCore EFIs for real Macs by spoofing the SMBIOS as a Mac computer" oder auf Deutsch übersetzt - „Behebt eine Sicherheitslücke, durch die ein Angreifer oder ein Hackintosh-Nutzer einen Hackintosh-Nutzer dazu verleiten konnte, OpenCore-EFIs für echte Macs zu erstellen, indem er das SMBIOS als Mac-Computer fälschte.“
⚠️ ⚠️ ⚠️ ⚠️ ⚠️ 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:
- Installer boots
- MacBookAir8,1 and MacBookAir8,2 can boot the installer
- Internal hard drive mounts properly on T2 Macs - albert-mueller#69
- ability to reach the desktop
- Post install - issues with second stage
- GPU accelaration/WiFi - most T2 Macs will have GPU accelaration out of the box, and on certain T2 Macs, also WiFi
Our goal of this project is to add support for T2 Macs so unsupported T2 Macs can boot into Tahoe. This project does run also on non-T2 Macs and we're committing to improve macOS 26 Tahoe compatability even on non-T2 Macs.
Noteworthy features of OpenCore Legacy Patcher:
- Support for macOS 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 OCLP-Plus or the official OpenCore Legacy Patcher by Dortania, you can revert the root patches and upgrade to this patcher.
- 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 Monterey through Tahoe installs. For older OSes, OpenCore may function; however, support is currently not provided from Albert Müller.
- 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
-
- for documenting and fixing an issue where sbvmm might not have been injected on T2 Macs
-
- UI redesign
- fixing some bugs, testing and documenting issues
-
- for helping me write a valid patch for AppleKeyStore
- testing and troubleshooting
-
- for fixing framebuffer issues and boot args
- testing and troubleshooting
-
- Adding support for unsupported T2 Macs and the main author of this fork
- Help troubleshooting, determining fixes, fixing security vulnerabilities and writing patches
-
for fixing modern wireless on macOS 26 Tahoe
-
-
- 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