OpenCore Legacy Patcher — T1 & T2 macOS Tahoe Edition
Developed & Maintained by albert-mueller (Albert Müller) with community contributions
Restoring full graphics acceleration, Broadcom Wi-Fi, audio routing, and T1/T2 security on macOS 26 Tahoe & macOS 15 Sequoia
👑 Authorship & Contributions
This repository is the dedicated development fork led by albert-mueller (Albert Müller). While building upon work by Dortania, Acidanthera, and Albert Müller, this fork independently engineered the critical solutions that make macOS 26 Tahoe fully usable on legacy and T1/T2 hardware:- T1 Security & Native Login: Engineered the Native Software Keystore login flow on macOS Tahoe for
MacBookPro14,1,MacBookPro14,2, andMacBookPro14,3(retaining Apple ID/iCloud, resolving Keychain panics). - Broadcom Wi-Fi Restoration: Unblocked the
IOSkywalkFamilykernel stack in the EFI builder and root patcher on macOS 15 & 26 Tahoe, restoring full Wi-Fi functionality on Broadcom chipsets (14E4:43BA). - GPU Hardware Acceleration & GuC: Injected Intel GuC firmware loading (
igfxfw=2) and display port keepalive (igfxonln=1) for Kaby Lake, eliminating Tahoe UI micro-stutters. - AMD Polaris Power-Gating: Developed the
radpg=15andagdpmod=pikerapatch combination for Radeon Pro 555/560 dGPUs, eliminating GPU switching lags. - AMD Legacy GCN Fix: Resolved the missing
AMDOpenCLimport bug in root patch payloads. - Tahoe Metal Libraries: Ported MetallibSupportPkg to macOS Tahoe (26.x) with multi-endpoint fallback.
A Python-based project revolving around Acidanthera's OpenCorePkg and Lilu for both running and unlocking features in macOS on supported and unsupported Macs. Security researchers can report vulnerabilities in the app via GitHub Security advisories.
⚠️ Attention! Macs with Intel Core i7 prior to 4th generation currently will be unable to boot macOS 26 due to missing AVX2 instructions. This means:
- 2014 MacBook Pro or later
- 2014 MacBook Air or later
- 2015 MacBook or later
- 2014 Mac mini or later
- 2013 Mac Pro or later
⚠️ Attention! Macs with Intel Core 2 Duos:
- 2010 11 inch and 13 inch MacBook Air
- 2010 MacBook Pro
- 2010 Mac mini
- 2010 MacBook
- 2009 MacBook Pro
- 2009 MacBook Air
- 2009 MacBook
- Mac mini 2009
- Mac Pro 2008
- MacBook Air 2008
- MacBook Pro 2008
- MacBook 2008
⚠️ 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. 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 all unsupported 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.
T2 Mac Support
💡 Recommended Download: Always download pre-compiled releases directly from Releases for guaranteed stability, bundled payloads, and proper packaging.
🚧 Not ready for general use
Progress:
- [X] Installer boots
- [ ] MacBookAir8,1 and MacBookAir8,2 can boot the installer
- [X] Internal hard drive mounts properly on T2 Macs
- [ ] 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
🌟 Validated & Working Models on macOS 26 Tahoe (Standard / Safe Build)
Thanks to recent testing and optimizations, the following models are fully operational on macOS 26 Tahoe using the Standard Build Profile:
- MacBook Pro (13-inch, 2017, Two TB3 Ports) —
MacBookPro14,1:
igfxfw=2, zero stuttering).
* Networking: Broadcom Wi-Fi (14E4:43BA / AirportBrcmNIC) working via Modern Wireless root patching and unblocked Skywalk driver.
* Audio & Video: Fully functional, smooth UI rendering and media playback.
- MacBook Pro (15-inch, 2017) —
MacBookPro14,3:
agdpmod=pikera & radpg=15 power-gating fix).
* Security & Auth: T1 security chip supported with password login, Apple Account & iCloud connectivity.
* Networking & Audio: Broadcom Wi-Fi & AppleHDA / AppleALC audio (alcid=13).
- MacBook Pro (13-inch, 2017, Four TB3 Ports) —
MacBookPro14,2:
🧪 Work in Progress / Experimental Testing
- MacBook Pro (15-inch, Mid 2015) —
MacBookPro11,4 / MacBookPro11,5(Haswell/Broadwell):
- Unsupported T2 Macs, such as 2018 Mac mini
❓ Frequently Asked Questions (FAQ) & Community Feedback
Here are solutions and verified reports from our community threads:
Q: Does macOS 26 Tahoe work smoothly on MacBook Pro 2017 models?
- Yes! Both
MacBookPro14,1(13" Function Keys) andMacBookPro14,3(15" Touch Bar & T1) are confirmed fully functional on macOS 26 Tahoe with full hardware graphics acceleration, audio, and Broadcom Wi-Fi. - Community Report: See @azeeproject's test report in Discussion #281 and the Wi-Fi fix confirmation in #18311204.
Q: How is the Dual GPU and T1 chip handled on MacBook Pro 15" 2017 (MacBookPro14,3)?
- Dual GPU: Automatic GPU switching works smoothly between Intel HD 630 and AMD Radeon Pro 555/560 using
agdpmod=pikeraand theradpg=15power-gating fix to prevent stuttering. - T1 Chip & Security: Retains native password login and Apple Account / iCloud syncing. Headphone jack and speakers work with
alcid=13.
Q: I got NameError: name 'AMDOpenCL' is not defined during Root Patching. How do I fix it?
- Resolution: This bug in legacy AMD GCN root patching was resolved in release
4.0.0.18002.8and newer. - Community Reference: See discussion with @WhiteLighter78 in Issue #194.
Q: Are MacBook Pro 2016 Touch Bar & T1 models (MacBookPro13,2 / MacBookPro13,3) supported on Tahoe?
- Resolution: Yes, Touch Bar and keyboard/trackpad control operate natively; login authentication is handled via the Native Software Keystore pipeline.
- Community Reference: See discussion with @TheRaddish1313 in Issue #284.
Q: Why did Wi-Fi not turn on after updating to Tahoe?
- Resolution: Ensure you are running 4.0.0.18002.9 or newer. Rebuild and install OpenCore EFI to your disk, reboot, and run the Post-Install Root Patch ("Networking: Modern Wireless"). The new release unblocks
IOSkywalkFamilydrivers on macOS 15/26.
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
- 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:
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:
* 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
* 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 * Adding support for T1 Macs on Tahoe * developing patches for T1 and non-T1 Macs for macOS 26 Tahoe * fixing some bugs, testing and documenting issues * 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 * improving support for Metallibs on macOS 26 Tahoe on unsupported non-T2 Macs * for fixing USB1.1 compatability with Sequoia and Tahoe * developing patches for the T2 chip * Developing Secure Enclave Processor (SEP) timeout patches * workflow files * 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 * VMM Patch Set * Development of previous patchers, laying out much of what needs to be patched- mario_bros_tech and the rest of the Unsupported Mac Discord
MacBook5,2 research 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:
- MacRumors and Unsupported Mac Communities
- Apple