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:
- Installer boots
- MacBookAir8,1 and MacBookAir8,2 can boot the installer
- Internal hard drive mounts properly on T2 Macs - #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. For Broadwell GPUs, at this time there are no patches inside the PatcherSupportPkg for macOS 26 Tahoe, so anyone having these GPU series should avoid upgrading to macOS 26 Tahoe. Or another way is if you can write patches, to fork any of the PatcherSupportPkgs that support Tahoe and add patches for this GPU.
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 *DrDonk
- for helping me write a valid patch for AppleKeyStore
-
- for fixing framebuffer issues and boot args
-
- 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