mirror of
https://github.com/dortania/OpenCore-Legacy-Patcher.git
synced 2026-06-20 22:20:53 +10:00
Fix linting
This commit is contained in:
@@ -14,7 +14,6 @@ Now that you've loaded OpenCore, now select Install macOS!:
|
|||||||
|
|
||||||

|

|
||||||
|
|
||||||
|
|
||||||
After plenty of verbose booting, you will reach the installer screen! From there it's just like any normal macOS install. For an example of how the boot process looks, see the following video:
|
After plenty of verbose booting, you will reach the installer screen! From there it's just like any normal macOS install. For an example of how the boot process looks, see the following video:
|
||||||
|
|
||||||
* [OpenCore Legacy Patcher Boot Process](https://www.youtube.com/watch?v=AN3zsbQV_n4)
|
* [OpenCore Legacy Patcher Boot Process](https://www.youtube.com/watch?v=AN3zsbQV_n4)
|
||||||
|
|||||||
+1
-2
@@ -31,7 +31,6 @@ Next lets run `Install OpenCore to USB/internal drive`:
|
|||||||
| :--- | :--- |
|
| :--- | :--- |
|
||||||
|  |  |
|
|  |  |
|
||||||
|
|
||||||
* If you have issues, please ensure you install OpenCore onto a FAT32 partition to ensure your Mac is able to boot it. You will need to format your drive as GUID/GPT in Disk Utility
|
* If you have issues, please ensure you install OpenCore onto a FAT32 partition to ensure your Mac is able to boot it. You will need to format your drive as GUID/GPT in Disk Utility
|
||||||
|
|
||||||
|
|
||||||
# Once finished, head to [Booting OpenCore and macOS](./BOOT.md)
|
# Once finished, head to [Booting OpenCore and macOS](./BOOT.md)
|
||||||
@@ -12,7 +12,6 @@ The easiest way to debug yourself is via Patcher Settings. Here there are many d
|
|||||||
* "Enable OpenCore DEBUG"
|
* "Enable OpenCore DEBUG"
|
||||||
* "Enable Kext DEBUG"
|
* "Enable Kext DEBUG"
|
||||||
|
|
||||||
|
|
||||||
When you've enabled these 3 options, rebuild OpenCore and install to your drive. This will provide much greater debug information as well as write logs to the EFI Partition.
|
When you've enabled these 3 options, rebuild OpenCore and install to your drive. This will provide much greater debug information as well as write logs to the EFI Partition.
|
||||||
|
|
||||||
## Obtaining OpenCore logs from disk
|
## Obtaining OpenCore logs from disk
|
||||||
|
|||||||
+1
-3
@@ -2,12 +2,10 @@
|
|||||||
|
|
||||||
For users who want to customize your setup to be more personal, OpenCore does allow for custom icons and images in the boot picker.
|
For users who want to customize your setup to be more personal, OpenCore does allow for custom icons and images in the boot picker.
|
||||||
|
|
||||||
|
|
||||||
* [Custom OpenCore icons](#custom-opencore-icons)
|
* [Custom OpenCore icons](#custom-opencore-icons)
|
||||||
* [Custom Mac Boot Picker icons](#custom-mac-boot-picker-icons)
|
* [Custom Mac Boot Picker icons](#custom-mac-boot-picker-icons)
|
||||||
* [Installing updated icons](#installing-updated-icons)
|
* [Installing updated icons](#installing-updated-icons)
|
||||||
|
|
||||||
|
|
||||||
# Custom OpenCore icons
|
# Custom OpenCore icons
|
||||||
|
|
||||||
To generate custom OpenCore icons, you'll need the following:
|
To generate custom OpenCore icons, you'll need the following:
|
||||||
@@ -32,7 +30,6 @@ To generate custom OpenCore icons, you'll need the following:
|
|||||||
|
|
||||||
Note, for each image we recommend having one of double the size. This ensures that icons are scaled correctly since .icns support dedicated images depending on HiDPI or not.
|
Note, for each image we recommend having one of double the size. This ensures that icons are scaled correctly since .icns support dedicated images depending on HiDPI or not.
|
||||||
|
|
||||||
|
|
||||||
Once you have a custom image you want to use(for example, as a background), download the [latest release of OpenCorePkg](https://github.com/acidanthera/OpenCorePkg/releases) and enter the `Utilities/icnspack/` folder:
|
Once you have a custom image you want to use(for example, as a background), download the [latest release of OpenCorePkg](https://github.com/acidanthera/OpenCorePkg/releases) and enter the `Utilities/icnspack/` folder:
|
||||||
|
|
||||||

|

|
||||||
@@ -42,6 +39,7 @@ Now `cd` this folder in terminal and run the following:
|
|||||||
```sh
|
```sh
|
||||||
./icnspack Background.icns <insert_x1_image> <insert_x2_image>
|
./icnspack Background.icns <insert_x1_image> <insert_x2_image>
|
||||||
```
|
```
|
||||||
|
|
||||||
Once done, you'll see your custom icon generated in `icnspack`'s folder:
|
Once done, you'll see your custom icon generated in `icnspack`'s folder:
|
||||||
|
|
||||||

|

|
||||||
|
|||||||
@@ -14,6 +14,7 @@ The simplest way to download macOS installs would be to use installinstallmacos:
|
|||||||
```sh
|
```sh
|
||||||
[ ! -d ~/macOS-installer/ ] && mkdir ~/macOS-installer; cd ~/macOS-installer; [ ! -f ~/macOS-installer/installinstallmacos.py ] && curl -O https://raw.githubusercontent.com/munki/macadmin-scripts/main/installinstallmacos.py; sudo python installinstallmacos.py
|
[ ! -d ~/macOS-installer/ ] && mkdir ~/macOS-installer; cd ~/macOS-installer; [ ! -f ~/macOS-installer/installinstallmacos.py ] && curl -O https://raw.githubusercontent.com/munki/macadmin-scripts/main/installinstallmacos.py; sudo python installinstallmacos.py
|
||||||
```
|
```
|
||||||
|
|
||||||
* Note: On El Capitan (10.11) and older, you'll need to specify a catalog at the end of the command:
|
* Note: On El Capitan (10.11) and older, you'll need to specify a catalog at the end of the command:
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|||||||
@@ -126,7 +126,6 @@ Regarding OS support, see below:
|
|||||||
| MacPro4,1 | Early 2009 | ^^ | <span style="color:green"> Everything is supported as long as GPU is Metal capable </span> |
|
| MacPro4,1 | Early 2009 | ^^ | <span style="color:green"> Everything is supported as long as GPU is Metal capable </span> |
|
||||||
| MacPro5,1 | Mid-2010, Mid-2012 | ^^ | ^^ |
|
| MacPro5,1 | Mid-2010, Mid-2012 | ^^ | ^^ |
|
||||||
|
|
||||||
|
|
||||||
### Xserve
|
### Xserve
|
||||||
|
|
||||||
| SMBIOS | Year | Supported | Comment |
|
| SMBIOS | Year | Supported | Comment |
|
||||||
|
|||||||
@@ -100,6 +100,7 @@ Below is a run down of the main logic OpenCore Legacy Patcher uses to gain nativ
|
|||||||
* Reason: Fixes DRM support on models with upgraded AMD Metal GPUs
|
* Reason: Fixes DRM support on models with upgraded AMD Metal GPUs
|
||||||
* Logic: Adds args to NVRAM
|
* Logic: Adds args to NVRAM
|
||||||
* Models: Models with upgraded AMD Metal GPUs
|
* Models: Models with upgraded AMD Metal GPUs
|
||||||
|
|
||||||
### UEFI -> ProtocolOverrides
|
### UEFI -> ProtocolOverrides
|
||||||
|
|
||||||
* GopPassThrough
|
* GopPassThrough
|
||||||
@@ -191,7 +192,6 @@ Below is an explanation of what Kexts OpenCore Legacy Patcher will inject into m
|
|||||||
* Models: All models require
|
* Models: All models require
|
||||||
:::
|
:::
|
||||||
|
|
||||||
|
|
||||||
## On-Disk Patches
|
## On-Disk Patches
|
||||||
|
|
||||||
Unfortunately certain on-disk patches are required to achieve full functionality. Below is a breakdown of patches supported
|
Unfortunately certain on-disk patches are required to achieve full functionality. Below is a breakdown of patches supported
|
||||||
@@ -226,15 +226,15 @@ Note, GPU Acceleration Patches are not public yet, the below section is simply d
|
|||||||
* GeForceGA.bundle
|
* GeForceGA.bundle
|
||||||
* GeForceTesla.kext
|
* GeForceTesla.kext
|
||||||
* Skip IOFree Panic - Mojave+
|
* Skip IOFree Panic - Mojave+
|
||||||
* At Offset `0x5CF9A` replace following bytes with `0xEB`
|
* At Offset `0x5CF9A` replace following bytes with `0xEB`
|
||||||
* Avoids `addMemoryRegion/removeMemoryRegion` calls
|
* Avoids `addMemoryRegion/removeMemoryRegion` calls
|
||||||
* At Offset `0x5527` and `0x77993`, replace following bytes with `0x909090909090`
|
* At Offset `0x5527` and `0x77993`, replace following bytes with `0x909090909090`
|
||||||
* GeForceTeslaGLDriver.bundle
|
* GeForceTeslaGLDriver.bundle
|
||||||
* GeForceTeslaVADriver.bundle
|
* GeForceTeslaVADriver.bundle
|
||||||
* NVDANV50HalTesla.kext
|
* NVDANV50HalTesla.kext
|
||||||
* NVDAResmanTesla.kext
|
* NVDAResmanTesla.kext
|
||||||
* 0x1ea59a - 0x1ea5b3: nop
|
* 0x1ea59a - 0x1ea5b3: nop
|
||||||
* Replace VSLGestalt to IOLockLock or any other known symbol of the same length.
|
* Replace VSLGestalt to IOLockLock or any other known symbol of the same length.
|
||||||
|
|
||||||
* AMD/ATI Binaries
|
* AMD/ATI Binaries
|
||||||
* AMD2400Controller.kext
|
* AMD2400Controller.kext
|
||||||
@@ -274,7 +274,7 @@ Note, GPU Acceleration Patches are not public yet, the below section is simply d
|
|||||||
* AppleIntelHD3000GraphicsVADriver.bundle
|
* AppleIntelHD3000GraphicsVADriver.bundle
|
||||||
* AppleIntelSNBGraphicsFB.kext
|
* AppleIntelSNBGraphicsFB.kext
|
||||||
* Board ID Patch
|
* Board ID Patch
|
||||||
* Replace original Board ID with updated model
|
* Replace original Board ID with updated model
|
||||||
* AppleIntelSNBVA.bundle
|
* AppleIntelSNBVA.bundle
|
||||||
|
|
||||||
### Frameworks
|
### Frameworks
|
||||||
|
|||||||
+1
-1
@@ -18,7 +18,7 @@ For those who wish to support this patcher, please see the [Supporting the Patch
|
|||||||
Since this patcher tricks macOS into thinking you're running a newer Mac, certain functionality may be broken:
|
Since this patcher tricks macOS into thinking you're running a newer Mac, certain functionality may be broken:
|
||||||
|
|
||||||
* Boot Camp Assistant.app
|
* Boot Camp Assistant.app
|
||||||
* We recommend following our [guide on getting a UEFI Windows Install working](). Legacy MBR Based installs won't show up in OpenCore
|
* We recommend following our [guide on getting a UEFI Windows Install working](./WINDOWS.md). Legacy MBR Based installs won't show up in OpenCore
|
||||||
|
|
||||||
## How do I get started?
|
## How do I get started?
|
||||||
|
|
||||||
|
|||||||
@@ -2,7 +2,6 @@
|
|||||||
|
|
||||||
To aid users in troubleshooting, we've compiled a list of users who've reported success with OpenCore Legacy patcher as well as the version used. This should aid users in verifying whether issues with the patcher are regression-related with newer versions.
|
To aid users in troubleshooting, we've compiled a list of users who've reported success with OpenCore Legacy patcher as well as the version used. This should aid users in verifying whether issues with the patcher are regression-related with newer versions.
|
||||||
|
|
||||||
|
|
||||||
### MacBook
|
### MacBook
|
||||||
|
|
||||||
| SMBIOS | Tested | Tester | Comment |
|
| SMBIOS | Tested | Tester | Comment |
|
||||||
|
|||||||
@@ -59,7 +59,6 @@ By default, the patcher will try to hide extra boot options such as recovery fro
|
|||||||
|
|
||||||
Full error: "Your Mac needs a firmware update in order to install to this Volume. Please select a Mac OS Extended (Journaled) volume instead."
|
Full error: "Your Mac needs a firmware update in order to install to this Volume. Please select a Mac OS Extended (Journaled) volume instead."
|
||||||
|
|
||||||
|
|
||||||
This error occurs when macOS determines the firmware to not have full APFS support. To resolve is quite simple, when building OpenCore head to "Patcher Settings" and enable "Moderate SMBIOS Patching" or higher. This will ensure that the firmware reported will show as supporting full APFS capabilities.
|
This error occurs when macOS determines the firmware to not have full APFS support. To resolve is quite simple, when building OpenCore head to "Patcher Settings" and enable "Moderate SMBIOS Patching" or higher. This will ensure that the firmware reported will show as supporting full APFS capabilities.
|
||||||
|
|
||||||
## No Brightness Control
|
## No Brightness Control
|
||||||
|
|||||||
+7
-4
@@ -3,10 +3,13 @@
|
|||||||
To remove OpenCore is actually quite simply:
|
To remove OpenCore is actually quite simply:
|
||||||
|
|
||||||
1. Remove OpenCore either from the USB or internal drive
|
1. Remove OpenCore either from the USB or internal drive
|
||||||
* You'll need to mount the drive's EFI partition, and delete the EFI/OC folder as well as the System folder
|
|
||||||
* Note **do not** delete the entire EFI folder, this will likely break any existing Windows and Linux installations
|
* You'll need to mount the drive's EFI partition, and delete the EFI/OC folder as well as the System folder
|
||||||
* [See here for example how to mount](https://dortania.github.io/OpenCore-Post-Install/universal/oc2hdd.html)
|
* Note **do not** delete the entire EFI folder, this will likely break any existing Windows and Linux installations
|
||||||
|
* [See here for example how to mount](https://dortania.github.io/OpenCore-Post-Install/universal/oc2hdd.html)
|
||||||
|
|
||||||
2. Reset NVRAM
|
2. Reset NVRAM
|
||||||
* [Reset NVRAM or PRAM on your Mac](https://support.apple.com/HT204063)
|
|
||||||
|
* [Reset NVRAM or PRAM on your Mac](https://support.apple.com/HT204063)
|
||||||
|
|
||||||
Know that if you are on Big Sur when you remove the EFI folder, your Mac will no longer boot and show the prohibited symbol. Be ready to install an older version of macOS before you uninstall OpenCore.
|
Know that if you are on Big Sur when you remove the EFI folder, your Mac will no longer boot and show the prohibited symbol. Be ready to install an older version of macOS before you uninstall OpenCore.
|
||||||
+1
-1
@@ -1,4 +1,4 @@
|
|||||||
# Updating OpenCore and Co.
|
# Updating OpenCore and Co
|
||||||
|
|
||||||
With OpenCore Legacy Patcher, generally there's very little reason for users to update the OpenCore installed on their machine unless you feel there's a benefit with new versions for your setup.
|
With OpenCore Legacy Patcher, generally there's very little reason for users to update the OpenCore installed on their machine unless you feel there's a benefit with new versions for your setup.
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user