Skip to content

Commit 5ad1080

Browse files
committed
- change readme.md
- fix Patch Bugs
1 parent 692f233 commit 5ad1080

28 files changed

+80
-168
lines changed

CHANGELOG.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
1-
# OpenCore Legacy Patcher changelog
2-
## 2.4.1
1+
# OCLP-R changelog
2+
## 2.6.0
3+
## 2.5.0
34
- Add macOS 26 constants
45
- Allow macOS 26 Beta download
56
- Add macOS 26 USB-Map-Tahoe.kext

LICENSE.txt

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ Redistribution and use in source and binary forms, with or without modification,
77
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
88
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
99
3. All advertising materials mentioning features or use of this software must display the following acknowledgement:
10-
This product includes software developed by Dortania and OpenCore Legacy Patcher contributors.
11-
4. Neither the name of OpenCore Legacy Patcher, nor the names of Dortania, Dhinak G, or Mykola Grymalyuk may be used to endorse or promote products derived from this software without specific prior written permission.
10+
This product includes software developed by Dortania and OCLP-R contributors.
11+
4. Neither the name of OCLP-R, nor the names of Dortania, Dhinak G, or Mykola Grymalyuk may be used to endorse or promote products derived from this software without specific prior written permission.
1212

1313
THIS SOFTWARE IS PROVIDED BY DHINAK G AND MYKOLA GRYMALYUK "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL DHINAK G NOR MYKOLA GRYMALYUK BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

PRIVACY.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Privacy Policy
22

3-
OpenCore Legacy Patcher may collect pseudo-anonymized data about the host system and the OpenCore Legacy Patcher application. This data is used to improve the project and to help diagnose issues. The data collected is as follows:
3+
OCLP-R may collect pseudo-anonymized data about the host system and the OCLP-R application. This data is used to improve the project and to help diagnose issues. The data collected is as follows:
44

55
* System's UUID as a SHA1 hash
66
* This is used to identify the system and to prevent duplicate reports

README.md

Lines changed: 6 additions & 93 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,17 @@
11
<div align="center">
22
<img src="docs/images/OC-Patcher.png" alt="OpenCore Patcher Logo" width="256" />
3-
<h1>OpenCore Legacy Patcher</h1>
3+
<h1>OCLP-R</h1>
44
</div>
55

66
A Python-based project revolving around [Acidanthera's OpenCorePkg](https://github.com/acidanthera/OpenCorePkg) and [Lilu](https://github.com/acidanthera/Lilu) for both running and unlocking features in macOS on supported and unsupported Macs.
77

88
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.
99

1010
----------
11-
12-
![GitHub all releases](https://img.shields.io/github/downloads/dortania/OpenCore-Legacy-Patcher/total?color=white&style=plastic) ![GitHub top language](https://img.shields.io/github/languages/top/dortania/OpenCore-Legacy-Patcher?color=4B8BBE&style=plastic) ![Discord](https://img.shields.io/discord/417165963327176704?color=7289da&label=discord&style=plastic)
13-
11+
![GitHub all releases](https://img.shields.io/github/downloads/hackdoc/OCLP-R/total?color=white&style=plastic) ![GitHub top language](https://img.shields.io/github/languages/top/hackdoc/OCLP-R?color=4B8BBE&style=plastic)
1412
----------
1513

16-
Noteworthy features of OpenCore Legacy Patcher:
14+
Noteworthy features of OCLP-R:
1715

1816
* Support for macOS Big Sur, Monterey, Ventura, Sonoma and Sequoia
1917
* Native Over the Air (OTA) System Updates
@@ -32,23 +30,16 @@ Note: Only clean-installs and upgrades are supported. macOS Big Sur installs alr
3230

3331
* You can, however, reinstall macOS with this patcher and retain your original data
3432

35-
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.
33+
Note 2: Currently, OCLP-R 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.
3634

3735
* For macOS Mojave and Catalina support, we recommend the use of [dosdude1's patchers](http://dosdude1.com)
3836

3937
## Getting Started
4038

4139
To start using the project, please see our in-depth guide:
4240

43-
* [OpenCore Legacy Patcher Guide](https://dortania.github.io/OpenCore-Legacy-Patcher/)
44-
45-
## Support
41+
* [OCLP-R Guide](https://dortania.github.io/OpenCore-Legacy-Patcher/)
4642

47-
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:
48-
49-
* [OpenCore Patcher Paradise Discord Server](https://discord.gg/rqdPgH8xSN)
50-
* Keep in mind that the Discord server is maintained by the community, so we ask everyone to be respectful.
51-
* Please review our docs on [how to debug with OpenCore](https://dortania.github.io/OpenCore-Legacy-Patcher/DEBUG.html) to gather important information to help others with troubleshooting.
5243

5344
## Running from source
5445

@@ -58,85 +49,7 @@ To run the project from source, see here: [Build and run from source](./SOURCE.m
5849

5950
* [Acidanthera](https://github.com/Acidanthera)
6051
* OpenCorePkg, as well as many of the core kexts and tools
61-
* [DhinakG](https://github.com/DhinakG)
62-
* Main co-author
63-
* [Khronokernel](https://github.com/Khronokernel)
52+
* [Pyquick](https://github.com/pyquick)
6453
* Main co-author
65-
* [Ausdauersportler](https://github.com/Ausdauersportler)
66-
* iMacs Metal GPUs Upgrade Patch set and documentation
67-
* Great amounts of help with debugging, and code suggestions
6854
* [vit9696](https://github.com/vit9696)
6955
* Endless amount of help troubleshooting, determining fixes and writing patches
70-
* [EduCovas](https://github.com/covasedu)
71-
* [non-Metal patch set](https://github.com/moraea/non-metal-frameworks) for nVidia Tesla/Fermi/Maxwell/Pascal, AMD TeraScale 1/2, and Intel Core 1st/2nd Generation GPUs
72-
* [3802 Metal patch set](https://github.com/moraea/misc-patches/tree/main/3802-Metal-15) and [MetallibSupportPkg](https://github.com/dortania/MetallibSupportPkg) for nVidia Kepler and Intel Core 3rd/4th Generation GPUs
73-
* Metal bundle patches and shims for [nVidia Kepler](https://github.com/moraea/misc-patches/tree/main/Kepler%2013%2B), [AMD GCN 1 - 4](https://github.com/moraea/misc-patches/tree/main/GCN%2013%2B), and [AMD GCN 5 (Vega)](https://github.com/moraea/misc-patches/tree/main/vega%2013%2B)
74-
* [IOSurface offset patches](https://github.com/moraea/misc-patches/tree/main/Sonoma%2014.4%20IOSurface) for nVidia Kepler, AMD GCN 1 - 5, and Intel Core 3rd - 6th Generation GPUs
75-
* [legacy Wi-Fi patch set](https://github.com/moraea/unsupported-wifi-patches) restores functionality for Wi-Fi cards in all 2007 - 2017 models
76-
* [T1 patch set](https://github.com/moraea/misc-patches/tree/main/T1-Patch) restores Touch ID, Apple Pay, and other secure functionality in 2016 - 2017 models
77-
* AppleGVA downgrade for accelerated video decoding on 2012 - 2016 models
78-
* OpenCL and OpenGL downgrade for AMD GCN
79-
* [USB 1 patch](https://github.com/moraea/misc-patches/tree/main/IOUSBHostFamily-14.4)
80-
* [ASentientHedgehog](https://github.com/moosethegoose2213)
81-
* [non-Metal patch set](https://github.com/moraea/non-metal-frameworks) for nVidia Tesla/Fermi/Maxwell/Pascal, AMD TeraScale 1/2, and Intel Core 1st/2nd Generation GPUs
82-
* [ASentientBot](https://github.com/ASentientBot)
83-
* [non-Metal patch set](https://github.com/moraea/non-metal-frameworks) for nVidia Tesla/Fermi/Maxwell/Pascal, AMD TeraScale 1/2, and Intel Core 1st/2nd Generation GPUs
84-
* [Metal bundle interposer](https://github.com/moraea/misc-patches/tree/main/sequoia%2031001%20interposer) for AMD GCN 1 - 5 and Intel Core 5th/6th Generation GPUs
85-
* [dsce](https://github.com/moraea/dsce) and [shared code](https://github.com/moraea/moraea-common) used by some other patches
86-
* [cdf](https://github.com/cdf)
87-
* Mac Pro on OpenCore Patch set and documentation
88-
* [Innie](https://github.com/cdf/Innie) and [NightShiftEnabler](https://github.com/cdf/NightShiftEnabler)
89-
* [Syncretic](https://forums.macrumors.com/members/syncretic.1173816/)
90-
* [AAAMouSSE](https://forums.macrumors.com/threads/mp3-1-others-sse-4-2-emulation-to-enable-amd-metal-driver.2206682/), [telemetrap](https://forums.macrumors.com/threads/mp3-1-others-sse-4-2-emulation-to-enable-amd-metal-driver.2206682/post-28447707) and [SurPlus](https://github.com/reenigneorcim/SurPlus)
91-
* [dosdude1](https://github.com/dosdude1)
92-
* Main author of the [original GUI](https://github.com/dortania/OCLP-GUI)
93-
* Development of previous patchers, laying out much of what needs to be patched
94-
* [parrotgeek1](https://github.com/parrotgeek1)
95-
* [VMM Patch Set](https://github.com/dortania/OpenCore-Legacy-Patcher/blob/4a8f61a01da72b38a4b2250386cc4b497a31a839/payloads/Config/config.plist#L1222-L1281)
96-
* [BarryKN](https://github.com/BarryKN)
97-
* Development of previous patchers, laying out much of what needs to be patched
98-
* [mario_bros_tech](https://github.com/mariobrostech) and the rest of the Unsupported Mac Discord
99-
* Catalyst that started OpenCore Legacy Patcher
100-
* [arter97](https://github.com/arter97/)
101-
* [SimpleMSR](https://github.com/arter97/SimpleMSR/) to disable firmware throttling in Nehalem+ MacBooks without batteries
102-
* [Mr.Macintosh](https://mrmacintosh.com)
103-
* Endless hours helping architect and troubleshoot many portions of the project
104-
* [flagers](https://github.com/flagersgit)
105-
* Aid with Nvidia Web Driver research and development
106-
* [non-Metal patch set](https://github.com/moraea/non-metal-frameworks) for nVidia Tesla/Fermi/Maxwell/Pascal, AMD TeraScale 1/2, and Intel Core 1st/2nd Generation GPUs
107-
* [Metal bundle interposer](https://github.com/moraea/misc-patches/tree/main/sequoia%2031001%20interposer) for AMD GCN 1 - 5 and Intel Core 5th/6th Generation GPUs
108-
* LegacyRVPL, SnapshotIsKill, etc. to aid in rapid testing and development
109-
* [joevt](https://github.com/joevt)
110-
* [FixPCIeLinkrate](https://github.com/joevt/joevtApps)
111-
* [Jazzzny](https://github.com/Jazzzny)
112-
* Research and various contributions to the project
113-
* UEFI Legacy XHCI research and development
114-
* NVIDIA OpenCL research and development
115-
* `MacBook5,2` research and development
116-
* LegacyKeyboardInjector
117-
* Pre-Ivy Bridge Aquantia Ethernet Patch
118-
* Non-Metal Photo Booth Patch for Monterey+
119-
* GUI and Backend Development
120-
* Updater UI
121-
* macOS Downloader UI
122-
* Downloader UI
123-
* USB Top Case probing
124-
* Developer root patching
125-
* Vaulting implementation
126-
* macOS 15 3802 Helios Research
127-
* UEFI bootx64.efi research
128-
* universal2 build research
129-
* Various documentation contributions
130-
* Amazing users who've graciously donate hardware:
131-
* [JohnD](https://forums.macrumors.com/members/johnd.53633/) - 2013 Mac Pro
132-
* [SpiGAndromeda](https://github.com/SpiGAndromeda) - AMD Vega 64
133-
* [turbomacs](https://github.com/turbomacs) - 2014 5k iMac
134-
* [vinaypundith](https://forums.macrumors.com/members/vinaypundith.1212357/) - MacBook7,1
135-
* [ThatStella7922](https://github.com/ThatStella7922) - 2017 13" MacBook Pro (A1708)
136-
* zephar - 2008 Mac Pro
137-
* jazo97 - 2011 15" MacBook Pro
138-
* And others (reach out if we forgot you!)
139-
* MacRumors and Unsupported Mac Communities
140-
* Endless testing and reporting issues
141-
* Apple
142-
* for macOS and many of the kexts, frameworks and other binaries we reimplemented into newer OSes

SOURCE.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
# Build and run from source
22

3-
OpenCore Legacy Patcher at its core is a Python-based GUI/CLI-based application. In turn, to run the project from source, you simply need to invoke the OpenCore-Patcher-GUI.command file via Python.
3+
OCLP-R at its core is a Python-based GUI/CLI-based application. In turn, to run the project from source, you simply need to invoke the OpenCore-Patcher-GUI.command file via Python.
44

55
For developers wishing to validate mainline changes, you may use this link: [GUI (Graphical Based App)](https://nightly.link/dortania/OpenCore-Legacy-Patcher/workflows/build-app-wxpython/main/OpenCore-Patcher.pkg.zip)
66

7-
* **Warning**: Nightly builds (untagged builds built from the latest commit) are actively developed OpenCore Legacy Patcher builds. These builds have not been tested, are not guaranteed to work, and are not guaranteed to be safe. Do not use nightlies without a good reason to do so, and do not use them on your main machine. Additionally, these binaries should not be used without first consulting the [CHANGELOG](./CHANGELOG.md).
7+
* **Warning**: Nightly builds (untagged builds built from the latest commit) are actively developed OCLP-R builds. These builds have not been tested, are not guaranteed to work, and are not guaranteed to be safe. Do not use nightlies without a good reason to do so, and do not use them on your main machine. Additionally, these binaries should not be used without first consulting the [CHANGELOG](./CHANGELOG.md).
88

99
**Do not share _any_ links to these binaries** in forums; please link to **this document only**.
1010
* Additionally, do not reupload these binaries or download binaries from other sites. Using binaries from untrusted sources is a security issue, as they may have been tampered with.
@@ -35,7 +35,7 @@ If you have any installation errors, see the following troubleshooting options:
3535
* Our build server currently uses Python 3.11 for generating binaries used in releases
3636
* Use .whl snapshots for installing additional dependencies
3737

38-
## Running OpenCore Legacy Patcher
38+
## Running OCLP-R
3939

4040
To run the project from source, simply invoke via python3:
4141

ci_tooling/privileged_helper_tool/README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# OpenCore Legacy Patcher Privileged Helper Tool
1+
# OCLP-R Privileged Helper Tool
22

3-
`com.dortania.opencore-legacy-patcher.privileged-helper` is OpenCore Legacy Patcher's Privileged Helper Tool.
3+
`com.dortania.opencore-legacy-patcher.privileged-helper` is OCLP-R's Privileged Helper Tool.
44

55
The architecture is as such:
66
1. The main application (OpenCore-Patcher.app) will send arguments to the privileged helper tool to execute.
@@ -12,7 +12,7 @@ The helper tool is able to execute code as root by using the "Set UID" bit prese
1212

1313
## Running from source
1414

15-
Since running OpenCore Legacy Patcher from source will lack Dortania's code signature, you will need to disable code signature verification in the privileged helper tool otherwise root commands will fail.
15+
Since running OCLP-R from source will lack Dortania's code signature, you will need to disable code signature verification in the privileged helper tool otherwise root commands will fail.
1616

1717
To do so, compile the privileged helper tool with debug:
1818
```
@@ -31,4 +31,4 @@ If possible, we highly recommend creating a developer account with Apple and sig
3131
* Note that Dortania's Team ID will need to be replaced in main.m with your own Team ID (`S74BDJXQMD` -> `YOUR_TEAM`)
3232
* Additionally you will be required to compile OpenCore-Patcher.app with your own Developer ID Application certificate
3333

34-
If this is not possible, we recommend using [OpenCore Legacy Patcher's prebuilt binaries](../../SOURCE.md) instead.
34+
If this is not possible, we recommend using [OCLP-R's prebuilt binaries](../../SOURCE.md) instead.
Binary file not shown.

docs/ACCEL.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -133,7 +133,7 @@ In the event Apple removes 11.2.3 from their catalogue, we've provided a mirror
133133

134134
## Unable to switch GPUs on 2011 15" and 17" MacBook Pros
135135

136-
Currently, with OpenCore Legacy Patcher, GPU switching between the iGPU and dGPU is broken. The simplest way to set a specific GPU is to disable the dGPU when you wish to remain on the more power efficient iGPU.
136+
Currently, with OCLP-R, GPU switching between the iGPU and dGPU is broken. The simplest way to set a specific GPU is to disable the dGPU when you wish to remain on the more power efficient iGPU.
137137

138138
The best way to achieve this is to boot to Recovery (or Single User Mode if the dGPU refuses to function at all) and run the following command:
139139

@@ -149,7 +149,7 @@ Note: This driver only provides partial support in macOS, full graphics accelera
149149

150150
## Erratic Colours on ATI TeraScale 2 GPUs (HD5000/HD6000)
151151

152-
Resolved with OpenCore Legacy Patcher v0.4.2
152+
Resolved with OCLP-R v0.4.2
153153

154154
::: details Legacy Fix (prior to 0.4.2)
155155

@@ -172,15 +172,15 @@ The following tool can be used to work-around this issue:
172172

173173
## Cannot Login on 2011 15" and 17" MacBook Pros
174174

175-
By default, OpenCore Legacy Patcher will assume MacBookPro8,2/3 have a faulty dGPU and disable acceleration. This is the safest option for most users as enabling dGPU acceleration on faulty Macs will result in failed booting.
175+
By default, OCLP-R will assume MacBookPro8,2/3 have a faulty dGPU and disable acceleration. This is the safest option for most users as enabling dGPU acceleration on faulty Macs will result in failed booting.
176176

177177
However, if your machine does not have the dGPU disabled via NVRAM, you'll experience a login loop. To work around this is quite simple:
178178

179179
1. Boot macOS in Single User Mode
180180
* Press Cmd+S in OpenCore's menu when you turn the Mac on
181181
2. When the command line prompt appears, enter the dGPU disabler argument (at the bottom)
182182
3. Reboot and patched macOS should work normally
183-
4. If you still want to use the dGPU, run OpenCore Legacy Patcher and enable TS2 Acceleration from settings. Go to `Patcher Settings -> Developer Settings -> Set TeraScale 2 Accel`, then root patch again.
183+
4. If you still want to use the dGPU, run OCLP-R and enable TS2 Acceleration from settings. Go to `Patcher Settings -> Developer Settings -> Set TeraScale 2 Accel`, then root patch again.
184184
5. Either Reset NVRAM or set `gpu-power-prefs` to zeros to re-enable the dGPU
185185

186186
```sh

docs/BOOT.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -76,7 +76,7 @@ Now that you've loaded OpenCore, "select Install macOS":
7676

7777
You will soon reach the installer screen! If you enabled verbose mode when building OCLP, a lot of text will run across the screen. From there, it's just like any normal macOS install. For an example of how the boot process looks, see the following video:
7878

79-
* [OpenCore Legacy Patcher Boot Process](https://www.youtube.com/watch?v=AN3zsbQV_n4)
79+
* [OCLP-R Boot Process](https://www.youtube.com/watch?v=AN3zsbQV_n4)
8080

8181
**Important:** If you're using a brand new disk that has not been used before, choose "View -> Show all devices" in Disk Utility and format the entire disk by choosing the topmost option in the sidebar to avoid a missing internal EFI later when trying to boot OpenCore to internal disk.
8282

docs/BUILD.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Now that we have a macOS installer, let's now build our OpenCore configuration!
44

55
If you haven't downloaded OpenCore Patcher yet, do so now:
66

7-
* [OpenCore Legacy Patcher Releases](https://github.com/dortania/Opencore-Legacy-Patcher/releases)
7+
* [OCLP-R Releases](https://github.com/dortania/Opencore-Legacy-Patcher/releases)
88

99
Next, run the `OpenCore-Patcher.app`
1010

0 commit comments

Comments
 (0)