From 24bc4432abe1a47cd2cdaa6056b8f7f8260c55a4 Mon Sep 17 00:00:00 2001
From: neon ball <35791009+ParaDoX1994@users.noreply.github.com>
Date: Sun, 3 Nov 2024 03:06:44 +0200
Subject: [PATCH 1/7] Small edit
---
docs/FAQ.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/FAQ.md b/docs/FAQ.md
index bd64c94e1..a414c5059 100644
--- a/docs/FAQ.md
+++ b/docs/FAQ.md
@@ -115,9 +115,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 |
| :--- | :--- |
From 2dc9961ffe2ff686de67ee946586b7afefd05e65 Mon Sep 17 00:00:00 2001
From: neon ball <35791009+ParaDoX1994@users.noreply.github.com>
Date: Sun, 3 Nov 2024 10:18:11 +0200
Subject: [PATCH 2/7] Add FAT partition note about booting Windows
---
docs/WINDOWS.md | 9 ++++++++-
1 file changed, 8 insertions(+), 1 deletion(-)
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.
From 94f77c20a0c7b18fd38df7fa9923d04e4b8af8d3 Mon Sep 17 00:00:00 2001
From: neon ball <35791009+ParaDoX1994@users.noreply.github.com>
Date: Sun, 3 Nov 2024 10:40:10 +0200
Subject: [PATCH 3/7] Add explainer about Spotlight indexing slowness
---
docs/FAQ.md | 4 +++-
1 file changed, 3 insertions(+), 1 deletion(-)
diff --git a/docs/FAQ.md b/docs/FAQ.md
index a414c5059..267b73bfb 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 the "All Processes" from the "View" menu item 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.
From 39c03e3f8b837a945dea62fa52a8b37cb41eebca Mon Sep 17 00:00:00 2001
From: neon ball <35791009+ParaDoX1994@users.noreply.github.com>
Date: Sun, 3 Nov 2024 10:42:14 +0200
Subject: [PATCH 4/7] Small fix
---
docs/FAQ.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/FAQ.md b/docs/FAQ.md
index 267b73bfb..f28f5a587 100644
--- a/docs/FAQ.md
+++ b/docs/FAQ.md
@@ -92,7 +92,7 @@ macOS doesn't allow direct downgrades, as such you will have to wipe the disk in
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 the "All Processes" from the "View" menu item to see if a process called ```mds_stores``` is using a lot of CPU resources.
+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.
From d508e8e9f927a7829671b4ba85002ca82a39959a Mon Sep 17 00:00:00 2001
From: neon ball <35791009+ParaDoX1994@users.noreply.github.com>
Date: Sun, 3 Nov 2024 10:57:18 +0200
Subject: [PATCH 5/7] Adjust image sizes
---
docs/DEBUG.md | 13 ++++++++++---
1 file changed, 10 insertions(+), 3 deletions(-)
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"
-
+
+

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

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

+
## Obtaining Kernel logs from macOS
From ab740371c8e12e4d242ffcb44d80833a8929ac8e Mon Sep 17 00:00:00 2001
From: neon ball <35791009+ParaDoX1994@users.noreply.github.com>
Date: Sun, 3 Nov 2024 11:31:56 +0200
Subject: [PATCH 6/7] Unify OS version image sizes
---
docs/images/macos-monterey.png | Bin 80841 -> 602260 bytes
docs/images/macos-sequoia.png | Bin 408571 -> 644414 bytes
docs/images/sonoma.png | Bin 362106 -> 1577357 bytes
docs/images/ventura.png | Bin 382442 -> 1051999 bytes
4 files changed, 0 insertions(+), 0 deletions(-)
diff --git a/docs/images/macos-monterey.png b/docs/images/macos-monterey.png
index d8a5d312f8855132889372c15c51883d474a6bfd..b5c06c51220cdd91c85905de1841f7ff0a561b05 100644
GIT binary patch
literal 602260
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