Skip to content

Commit e94f6ac

Browse files
committed
2 parents 5e4b124 + 67df722 commit e94f6ac

File tree

8 files changed

+31
-7
lines changed

8 files changed

+31
-7
lines changed

docs/DEBUG.md

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,19 +10,26 @@ The easiest way to debug yourself is via Patcher Settings. Here there are many d
1010
* "Enable OpenCore DEBUG"
1111
* "Enable Kext DEBUG"
1212

13-
![](./images/ocdebugimage.png)
13+
<div align="left">
14+
<img src="./images/ocdebugimage.png" alt="OCLP debug" width="600" />
15+
</div>
16+
1417

1518
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.
1619

1720
## Obtaining OpenCore logs from disk
1821

1922
With "Enable OpenCore DEBUG" set, on every boot there will be a .txt file generated on the EFI Partition. To grab these logs, [download and run MountEFI](https://github.com/corpnewt/MountEFI):
2023

21-
![](./images/mountefi.png)
24+
<div align="left">
25+
<img src="./images/mountefi.png" alt="Mount EFI" width="600" />
26+
</div>
2227

2328
Once you've mounted the EFI Partition of the drive you have macOS on, you should see some nice logs:
2429

25-
![](./images/logs-efi.png)
30+
<div align="left">
31+
<img src="./images/logs-efi.png" alt="Mount EFI" width="800" />
32+
</div>
2633

2734
## Obtaining Kernel logs from macOS
2835

docs/FAQ.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -90,7 +90,9 @@ macOS doesn't allow direct downgrades, as such you will have to wipe the disk in
9090

9191
## Why is my system slow?
9292

93-
This can mean many things. Firstly, newer operating systems are harder to run and can appear more slow.
93+
This can mean many things. Firstly, newer operating systems are harder to run and can appear more slow.
94+
95+
Additionally if your macOS installation is recent, Spotlight starts creating a full disk index which can cause high CPU load, high temps and general slowness. It's recommended to keep the system running for few hours, once Spotlight has indexed the load will ease. A way to check whether it's caused by Spotlight is to open Activity Monitor, choosing "All Processes" from the "View" menu item to, then sorting by the CPU value to see if a process called ```mds_stores``` is using a lot of CPU resources.
9496

9597
However, if your system is being **really** slow and you have no transparency in Dock and menubar, this typically indicates that root patches are not installed and as such there is no acceleration. Make sure to install root patches to get proper drivers and functionality. Refer to [Applying post install volume patches](https://dortania.github.io/OpenCore-Legacy-Patcher/POST-INSTALL.html#applying-post-install-volume-patches) and the [Troubleshooting](https://dortania.github.io/OpenCore-Legacy-Patcher/TROUBLESHOOTING.html) section for more information.
9698

@@ -115,9 +117,9 @@ Due to deprecation of OpenGL, many newer applications may require Metal renderin
115117

116118
## What are FeatureUnlock and mediaanalysisd?
117119

118-
FeatureUnlock is an extension to enable some macOS features, such as Sidecar or Universal Control. All features enabled by FeatureUnlock are listed [here](https://github.com/acidanthera/FeatureUnlock). Medianalysisd is a macOS feature mainly utilized for face detection in Photos, as well as Live Text feature.
120+
FeatureUnlock is an extension to enable some macOS features, such as Sidecar or Universal Control. All features enabled by FeatureUnlock are listed [here](https://github.com/acidanthera/FeatureUnlock). Medianalysisd is utilized for face detection in Photos, as well as the Live Text feature.
119121

120-
These features have the potential to cause instability in many places and as such a decision has been made to disable them by default starting from OpenCore Legacy Patcher version 2.1.0. Mediaanalysisd is identified to mainly affect 3802-based* systems. If you want to enable these features at the risk of additional instability, you can do so in the OCLP settings and rebuilding OpenCore.
122+
These features have the potential to cause instability in many places and as such a decision has been made to disable them by default (mediaanalysisd only on 3802-based* systems) starting from OpenCore Legacy Patcher version 2.1.0. If you want to enable these features at the risk of additional instability, you can do so in the OCLP settings and rebuilding OpenCore.
121123

122124
| FeatureUnlock | mediaanalysisd |
123125
| :--- | :--- |

docs/TROUBLESHOOTING.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -94,6 +94,14 @@ Currently there is a "PurgePendingUpdate" tool available [on the Discord server]
9494

9595
Disabling automatic macOS updates is extremely recommended once recovered, to prevent it from happening again.
9696

97+
**macOS Ventura and newer:**
98+
99+
System Settings -> General -> Software Update -> (i) button next to Automatic Updates -> Disable "Download new updates when available".
100+
101+
**macOS Big Sur and Monterey:**
102+
103+
System Preferences -> Software Update -> Advanced -> Disable "Download new updates when available".
104+
97105
## Stuck on boot after root patching
98106

99107
Boot into recovery by pressing space when your disk is selected on the OCLP bootpicker (if you have it hidden, hold ESC while starting up)

docs/WINDOWS.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,13 @@
33
Modern versions of Windows officially support two types of firmware: UEFI and BIOS. Users may want to boot Windows through the OCLP Bootpicker, but only UEFI Installations of Windows will show up in the OCLP Bootpicker.
44
Many older Macs do not "officially" support UEFI Windows installations, leading to installation failures and strange behaviour, but OCLP can be used to prevent almost all of these issues.
55

6+
::: warning
7+
8+
When booting Windows with OpenCore, it's highly recommended to create a new 200MB **MS-DOS (FAT)** partition in Disk Utility to install OpenCore in. This will prevent Windows from overwriting OpenCore with its own bootloader in the EFI partition and causing boot issues.
9+
10+
::::
11+
12+
613
## Minimum Requirements
714

815
This guide will focus on the installation of modern Windows (10/11) without using Boot Camp Assistant.
@@ -232,4 +239,4 @@ Intel's iGPU drivers for the HD 3000 series do not support UEFI booting in Windo
232239

233240
### NVIDIA Tesla Black Screen after driver installation
234241

235-
The NVIDIA Tesla GPUs found in 2008-2010 Macs do not support UEFI booting in Windows. You cannot use UEFI Windows without low-level patching on these machines.
242+
The NVIDIA Tesla GPUs found in 2008-2010 Macs do not support UEFI booting in Windows. You cannot use UEFI Windows without low-level patching on these machines.

docs/images/macos-monterey.png

509 KB
Loading

docs/images/macos-sequoia.png

230 KB
Loading

docs/images/sonoma.png

1.16 MB
Loading

docs/images/ventura.png

654 KB
Loading

0 commit comments

Comments
 (0)