diff --git a/docs/DEBUG.md b/docs/DEBUG.md index 793bc0630..dd0b610d1 100644 --- a/docs/DEBUG.md +++ b/docs/DEBUG.md @@ -10,7 +10,10 @@ The easiest way to debug yourself is via Patcher Settings. Here there are many d * "Enable OpenCore DEBUG" * "Enable Kext DEBUG" -![](./images/ocdebugimage.png) +
+ OCLP 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. @@ -18,11 +21,15 @@ When you've enabled these 3 options, rebuild OpenCore and install to your drive. 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) +
+ Mount EFI +
Once you've mounted the EFI Partition of the drive you have macOS on, you should see some nice logs: -![](./images/logs-efi.png) +
+ Mount EFI +
## Obtaining Kernel logs from macOS diff --git a/docs/FAQ.md b/docs/FAQ.md index bd64c94e1..f28f5a587 100644 --- a/docs/FAQ.md +++ b/docs/FAQ.md @@ -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. @@ -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 | | :--- | :--- | diff --git a/docs/TROUBLESHOOTING.md b/docs/TROUBLESHOOTING.md index 1122db042..fbeb29ea4 100644 --- a/docs/TROUBLESHOOTING.md +++ b/docs/TROUBLESHOOTING.md @@ -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) diff --git a/docs/WINDOWS.md b/docs/WINDOWS.md index 68bb208f6..55f6454cb 100644 --- a/docs/WINDOWS.md +++ b/docs/WINDOWS.md @@ -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. @@ -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. \ No newline at end of file +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. diff --git a/docs/images/macos-monterey.png b/docs/images/macos-monterey.png index d8a5d312f..b5c06c512 100644 Binary files a/docs/images/macos-monterey.png and b/docs/images/macos-monterey.png differ diff --git a/docs/images/macos-sequoia.png b/docs/images/macos-sequoia.png index ad1a577ea..c56696623 100644 Binary files a/docs/images/macos-sequoia.png and b/docs/images/macos-sequoia.png differ diff --git a/docs/images/sonoma.png b/docs/images/sonoma.png index a51b43fb0..c5e21ed21 100644 Binary files a/docs/images/sonoma.png and b/docs/images/sonoma.png differ diff --git a/docs/images/ventura.png b/docs/images/ventura.png index ae5f66cd8..0dca9085a 100644 Binary files a/docs/images/ventura.png and b/docs/images/ventura.png differ