Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
  • Loading branch information
khronokernel committed Nov 6, 2024
2 parents 5e4b124 + 67df722 commit e94f6ac
Show file tree
Hide file tree
Showing 8 changed files with 31 additions and 7 deletions.
13 changes: 10 additions & 3 deletions docs/DEBUG.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,19 +10,26 @@ The easiest way to debug yourself is via Patcher Settings. Here there are many d
* "Enable OpenCore DEBUG"
* "Enable Kext DEBUG"

![](./images/ocdebugimage.png)
<div align="left">
<img src="./images/ocdebugimage.png" alt="OCLP debug" width="600" />
</div>


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

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):

![](./images/mountefi.png)
<div align="left">
<img src="./images/mountefi.png" alt="Mount EFI" width="600" />
</div>

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

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

## Obtaining Kernel logs from macOS

Expand Down
8 changes: 5 additions & 3 deletions docs/FAQ.md
Original file line number Diff line number Diff line change
Expand Up @@ -90,7 +90,9 @@ macOS doesn't allow direct downgrades, as such you will have to wipe the disk in

## Why is my system slow?

This can mean many things. Firstly, newer operating systems are harder to run and can appear more slow.
This can mean many things. Firstly, newer operating systems are harder to run and can appear more slow.

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.

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.

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

## What are FeatureUnlock and mediaanalysisd?

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

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

| FeatureUnlock | mediaanalysisd |
| :--- | :--- |
Expand Down
8 changes: 8 additions & 0 deletions docs/TROUBLESHOOTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -94,6 +94,14 @@ Currently there is a "PurgePendingUpdate" tool available [on the Discord server]

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

**macOS Ventura and newer:**

System Settings -> General -> Software Update -> (i) button next to Automatic Updates -> Disable "Download new updates when available".

**macOS Big Sur and Monterey:**

System Preferences -> Software Update -> Advanced -> Disable "Download new updates when available".

## Stuck on boot after root patching

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)
Expand Down
9 changes: 8 additions & 1 deletion docs/WINDOWS.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,13 @@
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.
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.

::: warning

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.

::::


## Minimum Requirements

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

### NVIDIA Tesla Black Screen after driver installation

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.
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.
Binary file modified docs/images/macos-monterey.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/images/macos-sequoia.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/images/sonoma.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/images/ventura.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit e94f6ac

Please sign in to comment.