From 7718e9277a49d1ebe58ae759abb9e05f3d2aaffe Mon Sep 17 00:00:00 2001 From: khronokernel <48863253+khronokernel@users.noreply.github.com> Date: Wed, 24 Mar 2021 23:48:35 +0000 Subject: [PATCH] =?UTF-8?q?Deploying=20to=20gh-pages=20from=20=20@=20ce09c?= =?UTF-8?q?cf1151e82aec94bf84eb8247b31ddae7954=20=F0=9F=9A=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 404.html | 6 +++--- BOOT.html | 4 ++-- BUILD.html | 4 ++-- DEBUG.html | 4 ++-- DONATE.html | 4 ++-- HOW.html | 4 ++-- ICNS.html | 4 ++-- INSTALLER.html | 4 ++-- LICENSE.html | 4 ++-- MODELS.html | 4 ++-- PATCHEXPLAIN.html | 4 ++-- POST-INSTALL.html | 4 ++-- START.html | 4 ++-- TERMS.html | 6 +++--- TROUBLESHOOTING.html | 4 ++-- UNINSTALL.html | 4 ++-- assets/js/{11.e2e5627a.js => 11.3c01cd2d.js} | 2 +- assets/js/{12.5178ceb2.js => 12.eedc6e54.js} | 2 +- assets/js/{16.6f201ab2.js => 16.954b6fe1.js} | 2 +- assets/js/{22.bb09aa12.js => 22.41816288.js} | 2 +- assets/js/{3.687eb7d5.js => 3.20a56ab6.js} | 2 +- assets/js/{5.455ab867.js => 5.2a6b8475.js} | 2 +- assets/js/{app.839c8b9c.js => app.16a074a0.js} | 6 +++--- index.html | 4 ++-- 24 files changed, 45 insertions(+), 45 deletions(-) rename assets/js/{11.e2e5627a.js => 11.3c01cd2d.js} (95%) rename assets/js/{12.5178ceb2.js => 12.eedc6e54.js} (87%) rename assets/js/{16.6f201ab2.js => 16.954b6fe1.js} (96%) rename assets/js/{22.bb09aa12.js => 22.41816288.js} (62%) rename assets/js/{3.687eb7d5.js => 3.20a56ab6.js} (89%) rename assets/js/{5.455ab867.js => 5.2a6b8475.js} (81%) rename assets/js/{app.839c8b9c.js => app.16a074a0.js} (93%) diff --git a/404.html b/404.html index cbfd7ddfa..e6df6d99a 100644 --- a/404.html +++ b/404.html @@ -11,13 +11,13 @@ - + -

404

That's a Four-Oh-Four.
+ - + diff --git a/BOOT.html b/BOOT.html index 5db56c67a..7dad0907b 100644 --- a/BOOT.html +++ b/BOOT.html @@ -11,7 +11,7 @@ - + @@ -28,6 +28,6 @@ ⟶

- + diff --git a/BUILD.html b/BUILD.html index b765f37d7..db8e921ab 100644 --- a/BUILD.html +++ b/BUILD.html @@ -11,7 +11,7 @@ - + @@ -28,6 +28,6 @@ ⟶

- + diff --git a/DEBUG.html b/DEBUG.html index 6e93b5218..5629ae4f0 100644 --- a/DEBUG.html +++ b/DEBUG.html @@ -11,7 +11,7 @@ - + @@ -29,6 +29,6 @@ ⟶

- + diff --git a/DONATE.html b/DONATE.html index f198cdba4..8a25fbe3c 100644 --- a/DONATE.html +++ b/DONATE.html @@ -11,7 +11,7 @@ - + @@ -31,6 +31,6 @@ ⟶

- + diff --git a/HOW.html b/HOW.html index e68649db6..79b667c45 100644 --- a/HOW.html +++ b/HOW.html @@ -11,7 +11,7 @@ - + @@ -28,6 +28,6 @@ ⟶

- + diff --git a/ICNS.html b/ICNS.html index e5310a430..a6574466e 100644 --- a/ICNS.html +++ b/ICNS.html @@ -11,7 +11,7 @@ - + @@ -32,6 +32,6 @@ ⟶

- + diff --git a/INSTALLER.html b/INSTALLER.html index 323ab2af8..8c3e75e77 100644 --- a/INSTALLER.html +++ b/INSTALLER.html @@ -11,7 +11,7 @@ - + @@ -30,6 +30,6 @@ ⟶

- + diff --git a/LICENSE.html b/LICENSE.html index 539c351e3..4fb5fa8d4 100644 --- a/LICENSE.html +++ b/LICENSE.html @@ -11,7 +11,7 @@ - + @@ -31,6 +31,6 @@ ⟶

- + diff --git a/MODELS.html b/MODELS.html index b1c059fdb..eba147807 100644 --- a/MODELS.html +++ b/MODELS.html @@ -11,7 +11,7 @@ - + @@ -29,6 +29,6 @@ ⟶

- + diff --git a/PATCHEXPLAIN.html b/PATCHEXPLAIN.html index 940f2f5d1..fd31216e6 100644 --- a/PATCHEXPLAIN.html +++ b/PATCHEXPLAIN.html @@ -11,7 +11,7 @@ - + @@ -48,6 +48,6 @@

- + diff --git a/POST-INSTALL.html b/POST-INSTALL.html index 3679807e4..09690596d 100644 --- a/POST-INSTALL.html +++ b/POST-INSTALL.html @@ -11,7 +11,7 @@ - + @@ -28,6 +28,6 @@ ⟶

- + diff --git a/START.html b/START.html index 567dfcc6b..e42c938c7 100644 --- a/START.html +++ b/START.html @@ -11,7 +11,7 @@ - + @@ -24,6 +24,6 @@ ⟶

- + diff --git a/TERMS.html b/TERMS.html index 090801763..af9e296b8 100644 --- a/TERMS.html +++ b/TERMS.html @@ -11,7 +11,7 @@ - + @@ -19,7 +19,7 @@ GitHub (opens new window)

# OpenCore Patcher Terminology

With OpenCore Legacy Patcher, we use a lot of different terms to refer to hardware including SSE4.1, 32-Bit Firmware, etc. This page is to help users understand what all these confusing words mean.

# Terminology

Term Description
macOS Apple's own UNIX based OS used for Mac machines and "What makes a Mac a Mac".
Windows Microsoft's proprietary OS that is used and supported on a wide range of devices (stay with this OS if you don't want headaches)
Linux Family of open source Unix-like operating systems based on the Linux kernel, an operating system kernel first released on September 17, 1991, by Linus Torvalds. Linux is typically packaged in a Linux distribution. Note that while macOS and Linux may be UNIX-based, they're vastly different.
Bootloader Piece of software that loads an OS, usually made by the OS creators. OpenCore is technically not a bootloader per se (see boot manager explanation down below). Apple's Boot.efi would be the actual boot loader in a Mac.
Boot Manager Piece of software that manages bootloaders – we have many of these: Clover, systemd-boot, OpenCore, rEFInd, rEFIt... These are generally seen as prepping the system for the actual boot loader.
Term Description
OpenCore The new hotness on the scene, made with security in mind by the Acidanthera team (opens new window), has faster booting and lighter weight than previous boot managers. Supports many native Mac features such as SIP, FileVault, Secure Boot, etc
ACPI Tables defined in your firmware defining your hardware and different methods, tied directly to how IOKit/IOService handles device setup
NVRAM Non-volitile storage, where many variables are stored including default boot options, Hibernation keys, Secure Boot information, etc
Term Description
XNU Also known as X is Not Unix, XNU is referred to as macOS's "kernel" and the heart of what makes macOS tick
Kexts Also known as Kernel Extensions, are macOS's drivers. They're used to perform different tasks like device drivers or for a different purpose (in this patcher) like patching the OS, injecting information or running tasks.
KernelCollection Also known as the ImmutableKernel and PrelinkedKernel, this is a bundle of the kernel(XNU) and kernel extensions(Kexts) that we use to boot macOS. This is also what OpenCore patches in memory to allow us to have a seamless experience
- PrelinkedKernel: Default caching system since 10.7
- ImmutableKernel: Secure Boot based caching system since 10.13
- KernelCollection: Merge of both Prelinked and ImmutableKernel's since macOS 11, Big Sur
IOKit Backbone of how Kernel Extentions (Kexts) probe and attach onto hardware, starts quickly after kernel initates
WindowServer Backbone of the GUI interface in macOS, one of the first userfacing userspace programs to kick-in
Term Description
EFI It can denote two things:
- Mac's firmware, which is the same as UEFI, but pretty modified for Macs only, so not so "Universal"
- The partition on your hard drive that stores software read by the UEFI to load OSes (like the Windows bootloader) or UEFI Applications (like OpenCore), it's FAT32 formatted and has an ID type of EF00 (in hex). It can be named ESP or SYSTEM, and it's usually from 100MB to 400MB in size but the size doesn't reflect upon anything.
HFS+ Also known as MacOS Journaled, this was the default macOS drive format up until macOS 10.13, format was designed around spinning disks
APFS This was the default macOS drive from macOS 10.13 and onwards for SSDs, and standard for all drives in Mojave. Format was designed around SSDs primarily.
32 and 64-Bit CPU The bit number of a CPU determines how much data a CPU can address.
- 32-Bit CPUs were only supported up-to Mac OS X 10.6, Snow Leopard.
32-Bit Firmware The bit number of a Firmware determines how much data the firmware can address. In some older Macs, it's common to have a 64-Bit CPU can have a 32-Bit firmware
- 32-Bit Firmwares were only supported up-to Mac OS X 10.7, Lion.
SSE Instructions Also known as SIMD Single-Precision Floating-Point Instructions, these are defined as instruction sets supported by your CPU. In macOS, there are a certain number of instruction sets required for normal operation:
- SSE3: Required for all Intel CPUs since Mac OS X 10.4, Tiger
- SSSE3: Required for all Intel 64-Bit CPUs since Mac OS X 10.6, Snow Leopard
- SSE4.1: Required for all Intel CPUs since macOS 10.12, Sierra

+ (opens new window)

# OpenCore Patcher Terminology

With OpenCore Legacy Patcher, we use a lot of different terms to refer to hardware including SSE4.1, 32-Bit Firmware, etc. This page is to help users understand what all these confusing words mean.

# Terminology

Term Description
macOS Apple's own UNIX based OS used for Mac machines and "What makes a Mac a Mac".
Windows Microsoft's proprietary OS that is used and supported on a wide range of devices (stay with this OS if you don't want headaches)
Linux Family of open source Unix-like operating systems based on the Linux kernel, an operating system kernel first released on September 17, 1991, by Linus Torvalds. Linux is typically packaged in a Linux distribution. Note that while macOS and Linux may be UNIX-based, they're vastly different.
Bootloader Piece of software that loads an OS, usually made by the OS creators. OpenCore is technically not a bootloader per se (see boot manager explanation down below). Apple's Boot.efi would be the actual boot loader in a Mac.
Boot Manager Piece of software that manages bootloaders – we have many of these: Clover, systemd-boot, OpenCore, rEFInd, rEFIt... These are generally seen as prepping the system for the actual boot loader.
Term Description
OpenCore The new hotness on the scene, made with security in mind by the Acidanthera team (opens new window), has faster booting and lighter weight than previous boot managers. Supports many native Mac features such as SIP, FileVault, Secure Boot, etc
ACPI Tables defined in your firmware defining your hardware and different methods, tied directly to how IOKit/IOService handles device setup
NVRAM Non-volitile storage, where many variables are stored including default boot options, Hibernation keys, Secure Boot information, etc
Term Description
XNU Also known as X is Not Unix, XNU is referred to as macOS's "kernel" and the heart of what makes macOS tick
Kexts Also known as Kernel Extensions, are macOS's drivers. They're used to perform different tasks like device drivers or for a different purpose (in this patcher) like patching the OS, injecting information or running tasks.
KernelCollection Also known as the ImmutableKernel and PrelinkedKernel, this is a bundle of the kernel(XNU) and kernel extensions(Kexts) that we use to boot macOS. This is also what OpenCore patches in memory to allow us to have a seamless experience
- PrelinkedKernel: Default caching system since 10.7
- ImmutableKernel: Secure Boot based caching system since 10.13
- KernelCollection: Merge of both Prelinked and ImmutableKernel's since macOS 11, Big Sur
IOKit Backbone of how Kernel Extentions (Kexts) probe and attach onto hardware, starts quickly after kernel initates
WindowServer Backbone of the GUI interface in macOS, one of the first userfacing userspace programs to kick-in
OTA Short for Over The Air, refers to native OS updates via System Preferences like a supported Mac
DELTA Often used with OTA, refers to OS updates that much smaller than full installers (generally ~3GB), note Deltas require the root volume to be unmotified otherwise ~12GB updates will occur.
Term Description
EFI It can denote two things:
- Mac's firmware, which is the same as UEFI, but pretty modified for Macs only, so not so "Universal"
- The partition on your hard drive that stores software read by the UEFI to load OSes (like the Windows bootloader) or UEFI Applications (like OpenCore), it's FAT32 formatted and has an ID type of EF00 (in hex). It can be named ESP or SYSTEM, and it's usually from 100MB to 400MB in size but the size doesn't reflect upon anything.
HFS+ Also known as MacOS Journaled, this was the default macOS drive format up until macOS 10.13, format was designed around spinning disks
APFS This was the default macOS drive from macOS 10.13 and onwards for SSDs, and standard for all drives in Mojave. Format was designed around SSDs primarily.
32 and 64-Bit CPU The bit number of a CPU determines how much data a CPU can address.
- 32-Bit CPUs were only supported up-to Mac OS X 10.6, Snow Leopard.
32-Bit Firmware The bit number of a Firmware determines how much data the firmware can address. In some older Macs, it's common to have a 64-Bit CPU can have a 32-Bit firmware
- 32-Bit Firmwares were only supported up-to Mac OS X 10.7, Lion.
SSE Instructions Also known as SIMD Single-Precision Floating-Point Instructions, these are defined as instruction sets supported by your CPU. In macOS, there are a certain number of instruction sets required for normal operation:
- SSE3: Required for all Intel CPUs since Mac OS X 10.4, Tiger
- SSSE3: Required for all Intel 64-Bit CPUs since Mac OS X 10.6, Snow Leopard
- SSE4.1: Required for all Intel CPUs since macOS 10.12, Sierra

⟵ ⟶

- + diff --git a/TROUBLESHOOTING.html b/TROUBLESHOOTING.html index e2d3aeda0..685e2b49e 100644 --- a/TROUBLESHOOTING.html +++ b/TROUBLESHOOTING.html @@ -11,7 +11,7 @@ - + @@ -30,6 +30,6 @@ ⟶

- + diff --git a/UNINSTALL.html b/UNINSTALL.html index d6314637f..b0a7b1748 100644 --- a/UNINSTALL.html +++ b/UNINSTALL.html @@ -11,7 +11,7 @@ - + @@ -28,6 +28,6 @@ ⟶

- + diff --git a/assets/js/11.e2e5627a.js b/assets/js/11.3c01cd2d.js similarity index 95% rename from assets/js/11.e2e5627a.js rename to assets/js/11.3c01cd2d.js index 167f8062b..503f84a82 100644 --- a/assets/js/11.e2e5627a.js +++ b/assets/js/11.3c01cd2d.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[11],{319:function(e,t,o){e.exports=o.p+"assets/img/mountefi.f1bedccd.png"},371:function(e,t,o){e.exports=o.p+"assets/img/logs-efi.c416d33f.png"},398:function(e,t,o){"use strict";o.r(t);var r=o(25),s=Object(r.a)({},(function(){var e=this,t=e.$createElement,r=e._self._c||t;return r("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[r("h1",{attrs:{id:"how-to-debug-with-opencore"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#how-to-debug-with-opencore"}},[e._v("#")]),e._v(" How to debug with OpenCore")]),e._v(" "),r("p",[e._v("For those who've hit an odd bug and unsure if it's user error or patcher, the below will tell you how to get more verbose debug information as well as logs to help "),r("a",{attrs:{href:"https://github.com/dortania/OpenCore-Legacy-Patcher/issues",target:"_blank",rel:"noopener noreferrer"}},[e._v("file issues with us"),r("OutboundLink")],1)]),e._v(" "),r("ul",[r("li",[e._v("For users who are less experienced, we recommend asking on the "),r("a",{attrs:{href:"https://discord.gg/XbbWAsE",target:"_blank",rel:"noopener noreferrer"}},[e._v("Unsupported Mac Discord Server"),r("OutboundLink")],1),e._v(" for help.")])]),e._v(" "),r("h2",{attrs:{id:"debugging-yourself"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#debugging-yourself"}},[e._v("#")]),e._v(" Debugging yourself")]),e._v(" "),r("p",[e._v("The easiest way to debug yourself is via Patcher Settings. Here there are many different settings however the 3 main options that will help are:")]),e._v(" "),r("ul",[r("li",[e._v('"Enable Verbose Mode"')]),e._v(" "),r("li",[e._v('"Enable OpenCore DEBUG"')]),e._v(" "),r("li",[e._v('"Enable Kext DEBUG"')])]),e._v(" "),r("p",[e._v("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.")]),e._v(" "),r("h2",{attrs:{id:"obtaining-opencore-logs-from-disk"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#obtaining-opencore-logs-from-disk"}},[e._v("#")]),e._v(" Obtaining OpenCore logs from disk")]),e._v(" "),r("p",[e._v('With "Enable OpenCore DEBUG" set, every boot there will be a .txt file generated in your disk. To grab these logs, '),r("a",{attrs:{href:"https://github.com/corpnewt/MountEFI",target:"_blank",rel:"noopener noreferrer"}},[e._v("download and run MountEFI"),r("OutboundLink")],1),e._v(":")]),e._v(" "),r("p",[r("img",{attrs:{src:o(319),alt:""}})]),e._v(" "),r("p",[e._v("Once you've mounted the EFI Partition of the drive you have macOS on, you should see some nice logs:")]),e._v(" "),r("p",[r("img",{attrs:{src:o(371),alt:""}})]),e._v(" "),r("h2",{attrs:{id:"obtaining-kernel-logs-from-macos"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#obtaining-kernel-logs-from-macos"}},[e._v("#")]),e._v(" Obtaining Kernel logs from macOS")]),e._v(" "),r("p",[e._v('With "Enable Kext DEBUG" set, every boot will now have much more detailed logs stored in the OS. To get these logs, simply run the below command:')]),e._v(" "),r("div",{staticClass:"language-sh extra-class"},[r("pre",{pre:!0,attrs:{class:"language-sh"}},[r("code",[r("span",{pre:!0,attrs:{class:"token function"}},[e._v("sudo")]),e._v(" "),r("span",{pre:!0,attrs:{class:"token function"}},[e._v("dmesg")]),e._v(" "),r("span",{pre:!0,attrs:{class:"token operator"}},[e._v(">")]),e._v(" ~/Desktop/DMESG.txt\n")])])]),r("p",[e._v("From there, you'll have a log on your desktop.")]),e._v(" "),r("h2",{attrs:{id:"filing-an-issue-with-us"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#filing-an-issue-with-us"}},[e._v("#")]),e._v(" Filing an issue with us")]),e._v(" "),r("p",[e._v("Now that you have proper logs, you can now "),r("a",{attrs:{href:"https://github.com/dortania/OpenCore-Legacy-Patcher/issues",target:"_blank",rel:"noopener noreferrer"}},[e._v("file issues with us"),r("OutboundLink")],1),e._v(". Reminder we want the following info:")]),e._v(" "),r("ul",[r("li",[e._v("Model patching for (ie. MacBookPro10,1)")]),e._v(" "),r("li",[e._v("Target OS (ie. macOS 11.2.3)")]),e._v(" "),r("li",[e._v("Host OS (ie. macOS 10.15.7)")]),e._v(" "),r("li",[e._v("Upload of your OpenCore Build Folder")]),e._v(" "),r("li",[e._v("Upload of your OpenCore log (if applicable)")]),e._v(" "),r("li",[e._v("Upload of your Kernel log (if applicable)")])]),e._v(" "),r("p",[e._v("Additionally, please search whether the issue has been reported before. This avoids having duplicate issues.")])])}),[],!1,null,null,null);t.default=s.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[11],{319:function(e,t,o){e.exports=o.p+"assets/img/mountefi.f1bedccd.png"},379:function(e,t,o){e.exports=o.p+"assets/img/logs-efi.c416d33f.png"},401:function(e,t,o){"use strict";o.r(t);var r=o(25),s=Object(r.a)({},(function(){var e=this,t=e.$createElement,r=e._self._c||t;return r("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[r("h1",{attrs:{id:"how-to-debug-with-opencore"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#how-to-debug-with-opencore"}},[e._v("#")]),e._v(" How to debug with OpenCore")]),e._v(" "),r("p",[e._v("For those who've hit an odd bug and unsure if it's user error or patcher, the below will tell you how to get more verbose debug information as well as logs to help "),r("a",{attrs:{href:"https://github.com/dortania/OpenCore-Legacy-Patcher/issues",target:"_blank",rel:"noopener noreferrer"}},[e._v("file issues with us"),r("OutboundLink")],1)]),e._v(" "),r("ul",[r("li",[e._v("For users who are less experienced, we recommend asking on the "),r("a",{attrs:{href:"https://discord.gg/XbbWAsE",target:"_blank",rel:"noopener noreferrer"}},[e._v("Unsupported Mac Discord Server"),r("OutboundLink")],1),e._v(" for help.")])]),e._v(" "),r("h2",{attrs:{id:"debugging-yourself"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#debugging-yourself"}},[e._v("#")]),e._v(" Debugging yourself")]),e._v(" "),r("p",[e._v("The easiest way to debug yourself is via Patcher Settings. Here there are many different settings however the 3 main options that will help are:")]),e._v(" "),r("ul",[r("li",[e._v('"Enable Verbose Mode"')]),e._v(" "),r("li",[e._v('"Enable OpenCore DEBUG"')]),e._v(" "),r("li",[e._v('"Enable Kext DEBUG"')])]),e._v(" "),r("p",[e._v("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.")]),e._v(" "),r("h2",{attrs:{id:"obtaining-opencore-logs-from-disk"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#obtaining-opencore-logs-from-disk"}},[e._v("#")]),e._v(" Obtaining OpenCore logs from disk")]),e._v(" "),r("p",[e._v('With "Enable OpenCore DEBUG" set, every boot there will be a .txt file generated in your disk. To grab these logs, '),r("a",{attrs:{href:"https://github.com/corpnewt/MountEFI",target:"_blank",rel:"noopener noreferrer"}},[e._v("download and run MountEFI"),r("OutboundLink")],1),e._v(":")]),e._v(" "),r("p",[r("img",{attrs:{src:o(319),alt:""}})]),e._v(" "),r("p",[e._v("Once you've mounted the EFI Partition of the drive you have macOS on, you should see some nice logs:")]),e._v(" "),r("p",[r("img",{attrs:{src:o(379),alt:""}})]),e._v(" "),r("h2",{attrs:{id:"obtaining-kernel-logs-from-macos"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#obtaining-kernel-logs-from-macos"}},[e._v("#")]),e._v(" Obtaining Kernel logs from macOS")]),e._v(" "),r("p",[e._v('With "Enable Kext DEBUG" set, every boot will now have much more detailed logs stored in the OS. To get these logs, simply run the below command:')]),e._v(" "),r("div",{staticClass:"language-sh extra-class"},[r("pre",{pre:!0,attrs:{class:"language-sh"}},[r("code",[r("span",{pre:!0,attrs:{class:"token function"}},[e._v("sudo")]),e._v(" "),r("span",{pre:!0,attrs:{class:"token function"}},[e._v("dmesg")]),e._v(" "),r("span",{pre:!0,attrs:{class:"token operator"}},[e._v(">")]),e._v(" ~/Desktop/DMESG.txt\n")])])]),r("p",[e._v("From there, you'll have a log on your desktop.")]),e._v(" "),r("h2",{attrs:{id:"filing-an-issue-with-us"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#filing-an-issue-with-us"}},[e._v("#")]),e._v(" Filing an issue with us")]),e._v(" "),r("p",[e._v("Now that you have proper logs, you can now "),r("a",{attrs:{href:"https://github.com/dortania/OpenCore-Legacy-Patcher/issues",target:"_blank",rel:"noopener noreferrer"}},[e._v("file issues with us"),r("OutboundLink")],1),e._v(". Reminder we want the following info:")]),e._v(" "),r("ul",[r("li",[e._v("Model patching for (ie. MacBookPro10,1)")]),e._v(" "),r("li",[e._v("Target OS (ie. macOS 11.2.3)")]),e._v(" "),r("li",[e._v("Host OS (ie. macOS 10.15.7)")]),e._v(" "),r("li",[e._v("Upload of your OpenCore Build Folder")]),e._v(" "),r("li",[e._v("Upload of your OpenCore log (if applicable)")]),e._v(" "),r("li",[e._v("Upload of your Kernel log (if applicable)")])]),e._v(" "),r("p",[e._v("Additionally, please search whether the issue has been reported before. This avoids having duplicate issues.")])])}),[],!1,null,null,null);t.default=s.exports}}]); \ No newline at end of file diff --git a/assets/js/12.5178ceb2.js b/assets/js/12.eedc6e54.js similarity index 87% rename from assets/js/12.5178ceb2.js rename to assets/js/12.eedc6e54.js index 9830fa096..6718088af 100644 --- a/assets/js/12.5178ceb2.js +++ b/assets/js/12.eedc6e54.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[12],{372:function(e,t,o){e.exports=o.p+"assets/img/oc-explained.d196cefa.png"},400:function(e,t,o){"use strict";o.r(t);var r=o(25),a=Object(r.a)({},(function(){var e=this,t=e.$createElement,r=e._self._c||t;return r("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[r("h1",{attrs:{id:"boot-process-with-opencore-legacy-patcher"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#boot-process-with-opencore-legacy-patcher"}},[e._v("#")]),e._v(" Boot Process with OpenCore Legacy Patcher")]),e._v(" "),r("p",[e._v('OpenCore Legacy Patcher itself is actually quite a "dumb" program, and essentially edits a config.plist file and moves files around, it actually has little logic regarding the boot process. The real magic of OCLP is '),r("a",{attrs:{href:"https://github.com/acidanthera/OpenCorePkg",target:"_blank",rel:"noopener noreferrer"}},[e._v("OpenCorePkg"),r("OutboundLink")],1),e._v(", our back-end and what makes this patcher so powerful.")]),e._v(" "),r("h2",{attrs:{id:"boot-process-with-opencore"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#boot-process-with-opencore"}},[e._v("#")]),e._v(" Boot Process with OpenCore")]),e._v(" "),r("p",[e._v("To understand a bit more of how OpenCore is able revive older Macs in such a native-like way, we need to go over "),r("em",[e._v("how")]),e._v(" OpenCore works with your Mac:")]),e._v(" "),r("p",[r("img",{attrs:{src:o(372),alt:""}})])])}),[],!1,null,null,null);t.default=a.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[12],{367:function(e,t,o){e.exports=o.p+"assets/img/oc-explained.d196cefa.png"},398:function(e,t,o){"use strict";o.r(t);var r=o(25),a=Object(r.a)({},(function(){var e=this,t=e.$createElement,r=e._self._c||t;return r("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[r("h1",{attrs:{id:"boot-process-with-opencore-legacy-patcher"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#boot-process-with-opencore-legacy-patcher"}},[e._v("#")]),e._v(" Boot Process with OpenCore Legacy Patcher")]),e._v(" "),r("p",[e._v('OpenCore Legacy Patcher itself is actually quite a "dumb" program, and essentially edits a config.plist file and moves files around, it actually has little logic regarding the boot process. The real magic of OCLP is '),r("a",{attrs:{href:"https://github.com/acidanthera/OpenCorePkg",target:"_blank",rel:"noopener noreferrer"}},[e._v("OpenCorePkg"),r("OutboundLink")],1),e._v(", our back-end and what makes this patcher so powerful.")]),e._v(" "),r("h2",{attrs:{id:"boot-process-with-opencore"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#boot-process-with-opencore"}},[e._v("#")]),e._v(" Boot Process with OpenCore")]),e._v(" "),r("p",[e._v("To understand a bit more of how OpenCore is able revive older Macs in such a native-like way, we need to go over "),r("em",[e._v("how")]),e._v(" OpenCore works with your Mac:")]),e._v(" "),r("p",[r("img",{attrs:{src:o(367),alt:""}})])])}),[],!1,null,null,null);t.default=a.exports}}]); \ No newline at end of file diff --git a/assets/js/16.6f201ab2.js b/assets/js/16.954b6fe1.js similarity index 96% rename from assets/js/16.6f201ab2.js rename to assets/js/16.954b6fe1.js index 536851a0b..05d58fca3 100644 --- a/assets/js/16.6f201ab2.js +++ b/assets/js/16.954b6fe1.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[16],{399:function(e,t,o){"use strict";o.r(t);var a=o(25),n=Object(a.a)({},(function(){var e=this,t=e.$createElement,o=e._self._c||t;return o("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[o("h1",{attrs:{id:"supporting-the-patcher"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#supporting-the-patcher"}},[e._v("#")]),e._v(" Supporting the patcher")]),e._v(" "),o("p",[e._v("OpenCore Legacy Patcher is a hobby project for us developers, and while we love helping out the community it's very difficult for us to troubleshoot issues remotely. The best way for us to get to work on the patcher, fix issues and add enhancements is having the hardware in-hand. As a hobby project, neither of the main developers can afford to buy every legacy Mac to test on. In reality only one of us even has a legacy Mac to test on, a MacBook7,1 and the other has no Mac at all.")]),e._v(" "),o("p",[e._v("The best way to support us in all honesty is to donate any old hardware you no longer need, as this allows us to have machines to test locally and push fixes much faster. While we appreciate cash donations, this makes it much more difficult for us to handle as an organization.")]),e._v(" "),o("p",[e._v("Main hardware we'd appreciate:")]),e._v(" "),o("ul",[o("li",[e._v("Any Mac you own\n"),o("ul",[o("li",[e._v("Does require SSE4,1 CPU to test on Sierra and newer however")])])]),e._v(" "),o("li",[e._v("Any legacy GPU supporting macOS\n"),o("ul",[o("li",[e._v("Does not require to be Mac flashed")]),e._v(" "),o("li",[e._v("Following generations would would be beneficial:\n"),o("ul",[o("li",[e._v("Nvidia 8000 series through 500")]),e._v(" "),o("li",[e._v("AMD/ATI 2000 series through 6000")])])])])])]),e._v(" "),o("p",[e._v("If you have any legacy hardware you're willing to donate, please contact us at the following email:")]),e._v(" "),o("ul",[o("li",[e._v("khronokernel@icloud.com")])])])}),[],!1,null,null,null);t.default=n.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[16],{397:function(e,t,o){"use strict";o.r(t);var a=o(25),n=Object(a.a)({},(function(){var e=this,t=e.$createElement,o=e._self._c||t;return o("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[o("h1",{attrs:{id:"supporting-the-patcher"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#supporting-the-patcher"}},[e._v("#")]),e._v(" Supporting the patcher")]),e._v(" "),o("p",[e._v("OpenCore Legacy Patcher is a hobby project for us developers, and while we love helping out the community it's very difficult for us to troubleshoot issues remotely. The best way for us to get to work on the patcher, fix issues and add enhancements is having the hardware in-hand. As a hobby project, neither of the main developers can afford to buy every legacy Mac to test on. In reality only one of us even has a legacy Mac to test on, a MacBook7,1 and the other has no Mac at all.")]),e._v(" "),o("p",[e._v("The best way to support us in all honesty is to donate any old hardware you no longer need, as this allows us to have machines to test locally and push fixes much faster. While we appreciate cash donations, this makes it much more difficult for us to handle as an organization.")]),e._v(" "),o("p",[e._v("Main hardware we'd appreciate:")]),e._v(" "),o("ul",[o("li",[e._v("Any Mac you own\n"),o("ul",[o("li",[e._v("Does require SSE4,1 CPU to test on Sierra and newer however")])])]),e._v(" "),o("li",[e._v("Any legacy GPU supporting macOS\n"),o("ul",[o("li",[e._v("Does not require to be Mac flashed")]),e._v(" "),o("li",[e._v("Following generations would would be beneficial:\n"),o("ul",[o("li",[e._v("Nvidia 8000 series through 500")]),e._v(" "),o("li",[e._v("AMD/ATI 2000 series through 6000")])])])])])]),e._v(" "),o("p",[e._v("If you have any legacy hardware you're willing to donate, please contact us at the following email:")]),e._v(" "),o("ul",[o("li",[e._v("khronokernel@icloud.com")])])])}),[],!1,null,null,null);t.default=n.exports}}]); \ No newline at end of file diff --git a/assets/js/22.bb09aa12.js b/assets/js/22.41816288.js similarity index 62% rename from assets/js/22.bb09aa12.js rename to assets/js/22.41816288.js index 31cac2645..05e697ea2 100644 --- a/assets/js/22.bb09aa12.js +++ b/assets/js/22.41816288.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[22],{409:function(e,t,r){"use strict";r.r(t);var a=r(25),o=Object(a.a)({},(function(){var e=this,t=e.$createElement,r=e._self._c||t;return r("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[r("h1",{attrs:{id:"opencore-patcher-terminology"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#opencore-patcher-terminology"}},[e._v("#")]),e._v(" OpenCore Patcher Terminology")]),e._v(" "),r("p",[e._v("With OpenCore Legacy Patcher, we use a lot of different terms to refer to hardware including "),r("code",[e._v("SSE4.1")]),e._v(", "),r("code",[e._v("32-Bit Firmware")]),e._v(", etc. This page is to help users understand what all these confusing words mean.")]),e._v(" "),r("h1",{attrs:{id:"terminology"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#terminology"}},[e._v("#")]),e._v(" Terminology")]),e._v(" "),r("table",[r("thead",[r("tr",[r("th",[e._v("Term")]),e._v(" "),r("th",[e._v("Description")])])]),e._v(" "),r("tbody",[r("tr",[r("td",[r("strong",[e._v("macOS")])]),e._v(" "),r("td",[e._v('Apple\'s own UNIX based OS used for Mac machines and "What makes a Mac a Mac".')])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("Windows")])]),e._v(" "),r("td",[e._v("Microsoft's proprietary OS that is used and supported on a wide range of devices (stay with this OS if you don't want headaches)")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("Linux")])]),e._v(" "),r("td",[e._v("Family of open source Unix-like operating systems based on the Linux kernel, an operating system kernel first released on September 17, 1991, by Linus Torvalds. Linux is typically packaged in a Linux distribution. Note that while macOS and Linux may be UNIX-based, they're vastly different.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("Bootloader")])]),e._v(" "),r("td",[e._v("Piece of software that loads an OS, usually made by the OS creators. OpenCore is technically not a bootloader per se (see boot manager explanation down below). Apple's Boot.efi would be the actual boot loader in a Mac.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("Boot Manager")])]),e._v(" "),r("td",[e._v("Piece of software that manages bootloaders – we have many of these: Clover, systemd-boot, OpenCore, rEFInd, rEFIt... These are generally seen as prepping the system for the actual boot loader.")])])])]),e._v(" "),r("hr"),e._v(" "),r("table",[r("thead",[r("tr",[r("th",[e._v("Term")]),e._v(" "),r("th",[e._v("Description")])])]),e._v(" "),r("tbody",[r("tr",[r("td",[r("strong",[e._v("OpenCore")])]),e._v(" "),r("td",[e._v("The new hotness on the scene, made with security in mind by the "),r("a",{attrs:{href:"https://github.com/acidanthera",target:"_blank",rel:"noopener noreferrer"}},[e._v("Acidanthera team"),r("OutboundLink")],1),e._v(", has faster booting and lighter weight than previous boot managers. Supports many native Mac features such as SIP, FileVault, Secure Boot, etc")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("ACPI")])]),e._v(" "),r("td",[e._v("Tables defined in your firmware defining your hardware and different methods, tied directly to how IOKit/IOService handles device setup")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("NVRAM")])]),e._v(" "),r("td",[e._v("Non-volitile storage, where many variables are stored including default boot options, Hibernation keys, Secure Boot information, etc")])])])]),e._v(" "),r("hr"),e._v(" "),r("table",[r("thead",[r("tr",[r("th",[e._v("Term")]),e._v(" "),r("th",[e._v("Description")])])]),e._v(" "),r("tbody",[r("tr",[r("td",[r("strong",[e._v("XNU")])]),e._v(" "),r("td",[e._v("Also known as "),r("strong",[e._v("X")]),e._v(" is "),r("strong",[e._v("N")]),e._v("ot "),r("strong",[e._v("U")]),e._v('nix, XNU is referred to as macOS\'s "kernel" and the heart of what makes macOS tick')])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("Kexts")])]),e._v(" "),r("td",[e._v("Also known as "),r("strong",[e._v("K")]),e._v("ernel "),r("strong",[e._v("Ext")]),e._v("ensions, are macOS's drivers. They're used to perform different tasks like device drivers or for a different purpose (in this patcher) like patching the OS, injecting information or running tasks.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("KernelCollection")])]),e._v(" "),r("td",[e._v("Also known as the ImmutableKernel and PrelinkedKernel, this is a bundle of the kernel(XNU) and kernel extensions(Kexts) that we use to boot macOS. This is also what OpenCore patches in memory to allow us to have a seamless experience "),r("br"),e._v("- PrelinkedKernel: Default caching system since 10.7 "),r("br"),e._v("- ImmutableKernel: Secure Boot based caching system since 10.13 "),r("br"),e._v("- KernelCollection: Merge of both Prelinked and ImmutableKernel's since macOS 11, Big Sur")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("IOKit")])]),e._v(" "),r("td",[e._v("Backbone of how Kernel Extentions (Kexts) probe and attach onto hardware, starts quickly after kernel initates")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("WindowServer")])]),e._v(" "),r("td",[e._v("Backbone of the GUI interface in macOS, one of the first userfacing userspace programs to kick-in")])])])]),e._v(" "),r("hr"),e._v(" "),r("table",[r("thead",[r("tr",[r("th",[e._v("Term")]),e._v(" "),r("th",[e._v("Description")])])]),e._v(" "),r("tbody",[r("tr",[r("td",[r("strong",[e._v("EFI")])]),e._v(" "),r("td",[e._v("It can denote two things: "),r("br"),e._v('- Mac\'s firmware, which is the same as UEFI, but pretty modified for Macs only, so not so "Universal" '),r("br"),e._v("- The partition on your hard drive that stores software read by the UEFI to load OSes (like the Windows bootloader) or UEFI Applications (like OpenCore), it's FAT32 formatted and has an ID type of EF00 (in hex). It can be named ESP or SYSTEM, and it's usually from 100MB to 400MB in size but the size doesn't reflect upon anything.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("HFS+")])]),e._v(" "),r("td",[e._v("Also known as MacOS Journaled, this was the default macOS drive format up until macOS 10.13, format was designed around spinning disks")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("APFS")])]),e._v(" "),r("td",[e._v("This was the default macOS drive from macOS 10.13 and onwards for SSDs, and standard for all drives in Mojave. Format was designed around SSDs primarily.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("32 and 64-Bit CPU")])]),e._v(" "),r("td",[e._v("The bit number of a CPU determines how much data a CPU can address. "),r("br"),e._v("- 32-Bit CPUs were only supported up-to Mac OS X 10.6, Snow Leopard.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("32-Bit Firmware")])]),e._v(" "),r("td",[e._v("The bit number of a Firmware determines how much data the firmware can address. In some older Macs, it's common to have a 64-Bit CPU can have a 32-Bit firmware"),r("br"),e._v("- 32-Bit Firmwares were only supported up-to Mac OS X 10.7, Lion.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("SSE Instructions")])]),e._v(" "),r("td",[e._v("Also known as "),r("strong",[e._v("S")]),e._v("IMD "),r("strong",[e._v("S")]),e._v("ingle-Precision Floating-Point "),r("strong",[e._v("I")]),e._v("nstructions, these are defined as instruction sets supported by your CPU. In macOS, there are a certain number of instruction sets required for normal operation: "),r("br"),e._v("- SSE3: Required for all Intel CPUs since Mac OS X 10.4, Tiger "),r("br"),e._v("- SSSE3: Required for all Intel 64-Bit CPUs since Mac OS X 10.6, Snow Leopard "),r("br"),e._v("- SSE4.1: Required for all Intel CPUs since macOS 10.12, Sierra")])])])]),e._v(" "),r("hr")])}),[],!1,null,null,null);t.default=o.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[22],{409:function(e,t,r){"use strict";r.r(t);var o=r(25),a=Object(o.a)({},(function(){var e=this,t=e.$createElement,r=e._self._c||t;return r("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[r("h1",{attrs:{id:"opencore-patcher-terminology"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#opencore-patcher-terminology"}},[e._v("#")]),e._v(" OpenCore Patcher Terminology")]),e._v(" "),r("p",[e._v("With OpenCore Legacy Patcher, we use a lot of different terms to refer to hardware including "),r("code",[e._v("SSE4.1")]),e._v(", "),r("code",[e._v("32-Bit Firmware")]),e._v(", etc. This page is to help users understand what all these confusing words mean.")]),e._v(" "),r("h1",{attrs:{id:"terminology"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#terminology"}},[e._v("#")]),e._v(" Terminology")]),e._v(" "),r("table",[r("thead",[r("tr",[r("th",[e._v("Term")]),e._v(" "),r("th",[e._v("Description")])])]),e._v(" "),r("tbody",[r("tr",[r("td",[r("strong",[e._v("macOS")])]),e._v(" "),r("td",[e._v('Apple\'s own UNIX based OS used for Mac machines and "What makes a Mac a Mac".')])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("Windows")])]),e._v(" "),r("td",[e._v("Microsoft's proprietary OS that is used and supported on a wide range of devices (stay with this OS if you don't want headaches)")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("Linux")])]),e._v(" "),r("td",[e._v("Family of open source Unix-like operating systems based on the Linux kernel, an operating system kernel first released on September 17, 1991, by Linus Torvalds. Linux is typically packaged in a Linux distribution. Note that while macOS and Linux may be UNIX-based, they're vastly different.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("Bootloader")])]),e._v(" "),r("td",[e._v("Piece of software that loads an OS, usually made by the OS creators. OpenCore is technically not a bootloader per se (see boot manager explanation down below). Apple's Boot.efi would be the actual boot loader in a Mac.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("Boot Manager")])]),e._v(" "),r("td",[e._v("Piece of software that manages bootloaders – we have many of these: Clover, systemd-boot, OpenCore, rEFInd, rEFIt... These are generally seen as prepping the system for the actual boot loader.")])])])]),e._v(" "),r("hr"),e._v(" "),r("table",[r("thead",[r("tr",[r("th",[e._v("Term")]),e._v(" "),r("th",[e._v("Description")])])]),e._v(" "),r("tbody",[r("tr",[r("td",[r("strong",[e._v("OpenCore")])]),e._v(" "),r("td",[e._v("The new hotness on the scene, made with security in mind by the "),r("a",{attrs:{href:"https://github.com/acidanthera",target:"_blank",rel:"noopener noreferrer"}},[e._v("Acidanthera team"),r("OutboundLink")],1),e._v(", has faster booting and lighter weight than previous boot managers. Supports many native Mac features such as SIP, FileVault, Secure Boot, etc")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("ACPI")])]),e._v(" "),r("td",[e._v("Tables defined in your firmware defining your hardware and different methods, tied directly to how IOKit/IOService handles device setup")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("NVRAM")])]),e._v(" "),r("td",[e._v("Non-volitile storage, where many variables are stored including default boot options, Hibernation keys, Secure Boot information, etc")])])])]),e._v(" "),r("hr"),e._v(" "),r("table",[r("thead",[r("tr",[r("th",[e._v("Term")]),e._v(" "),r("th",[e._v("Description")])])]),e._v(" "),r("tbody",[r("tr",[r("td",[r("strong",[e._v("XNU")])]),e._v(" "),r("td",[e._v("Also known as "),r("strong",[e._v("X")]),e._v(" is "),r("strong",[e._v("N")]),e._v("ot "),r("strong",[e._v("U")]),e._v('nix, XNU is referred to as macOS\'s "kernel" and the heart of what makes macOS tick')])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("Kexts")])]),e._v(" "),r("td",[e._v("Also known as "),r("strong",[e._v("K")]),e._v("ernel "),r("strong",[e._v("Ext")]),e._v("ensions, are macOS's drivers. They're used to perform different tasks like device drivers or for a different purpose (in this patcher) like patching the OS, injecting information or running tasks.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("KernelCollection")])]),e._v(" "),r("td",[e._v("Also known as the ImmutableKernel and PrelinkedKernel, this is a bundle of the kernel(XNU) and kernel extensions(Kexts) that we use to boot macOS. This is also what OpenCore patches in memory to allow us to have a seamless experience "),r("br"),e._v("- PrelinkedKernel: Default caching system since 10.7 "),r("br"),e._v("- ImmutableKernel: Secure Boot based caching system since 10.13 "),r("br"),e._v("- KernelCollection: Merge of both Prelinked and ImmutableKernel's since macOS 11, Big Sur")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("IOKit")])]),e._v(" "),r("td",[e._v("Backbone of how Kernel Extentions (Kexts) probe and attach onto hardware, starts quickly after kernel initates")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("WindowServer")])]),e._v(" "),r("td",[e._v("Backbone of the GUI interface in macOS, one of the first userfacing userspace programs to kick-in")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("OTA")])]),e._v(" "),r("td",[e._v("Short for "),r("strong",[e._v("O")]),e._v("ver "),r("strong",[e._v("T")]),e._v("he "),r("strong",[e._v("A")]),e._v("ir, refers to native OS updates via System Preferences like a supported Mac")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("DELTA")])]),e._v(" "),r("td",[e._v("Often used with OTA, refers to OS updates that much smaller than full installers (generally ~3GB), note Deltas require the root volume to be unmotified otherwise ~12GB updates will occur.")])])])]),e._v(" "),r("hr"),e._v(" "),r("table",[r("thead",[r("tr",[r("th",[e._v("Term")]),e._v(" "),r("th",[e._v("Description")])])]),e._v(" "),r("tbody",[r("tr",[r("td",[r("strong",[e._v("EFI")])]),e._v(" "),r("td",[e._v("It can denote two things: "),r("br"),e._v('- Mac\'s firmware, which is the same as UEFI, but pretty modified for Macs only, so not so "Universal" '),r("br"),e._v("- The partition on your hard drive that stores software read by the UEFI to load OSes (like the Windows bootloader) or UEFI Applications (like OpenCore), it's FAT32 formatted and has an ID type of EF00 (in hex). It can be named ESP or SYSTEM, and it's usually from 100MB to 400MB in size but the size doesn't reflect upon anything.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("HFS+")])]),e._v(" "),r("td",[e._v("Also known as MacOS Journaled, this was the default macOS drive format up until macOS 10.13, format was designed around spinning disks")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("APFS")])]),e._v(" "),r("td",[e._v("This was the default macOS drive from macOS 10.13 and onwards for SSDs, and standard for all drives in Mojave. Format was designed around SSDs primarily.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("32 and 64-Bit CPU")])]),e._v(" "),r("td",[e._v("The bit number of a CPU determines how much data a CPU can address. "),r("br"),e._v("- 32-Bit CPUs were only supported up-to Mac OS X 10.6, Snow Leopard.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("32-Bit Firmware")])]),e._v(" "),r("td",[e._v("The bit number of a Firmware determines how much data the firmware can address. In some older Macs, it's common to have a 64-Bit CPU can have a 32-Bit firmware"),r("br"),e._v("- 32-Bit Firmwares were only supported up-to Mac OS X 10.7, Lion.")])]),e._v(" "),r("tr",[r("td",[r("strong",[e._v("SSE Instructions")])]),e._v(" "),r("td",[e._v("Also known as "),r("strong",[e._v("S")]),e._v("IMD "),r("strong",[e._v("S")]),e._v("ingle-Precision Floating-Point "),r("strong",[e._v("I")]),e._v("nstructions, these are defined as instruction sets supported by your CPU. In macOS, there are a certain number of instruction sets required for normal operation: "),r("br"),e._v("- SSE3: Required for all Intel CPUs since Mac OS X 10.4, Tiger "),r("br"),e._v("- SSSE3: Required for all Intel 64-Bit CPUs since Mac OS X 10.6, Snow Leopard "),r("br"),e._v("- SSE4.1: Required for all Intel CPUs since macOS 10.12, Sierra")])])])]),e._v(" "),r("hr")])}),[],!1,null,null,null);t.default=a.exports}}]); \ No newline at end of file diff --git a/assets/js/3.687eb7d5.js b/assets/js/3.20a56ab6.js similarity index 89% rename from assets/js/3.687eb7d5.js rename to assets/js/3.20a56ab6.js index 5c955c853..8f65631f3 100644 --- a/assets/js/3.687eb7d5.js +++ b/assets/js/3.20a56ab6.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[3],{319:function(e,o,t){e.exports=t.p+"assets/img/mountefi.f1bedccd.png"},373:function(e,o,t){e.exports=t.p+"assets/img/icnspack-folder.6cad9bdf.png"},374:function(e,o,t){e.exports=t.p+"assets/img/icnspack-done.9f84140f.png"},375:function(e,o,t){e.exports=t.p+"assets/img/graphics-download.905b7fd4.png"},376:function(e,o,t){e.exports=t.p+"assets/img/graphics-open.a92a70e2.png"},377:function(e,o,t){e.exports=t.p+"assets/img/icon-SL.e5bfa343.png"},378:function(e,o,t){e.exports=t.p+"assets/img/background-moved.bbb8b0fd.png"},379:function(e,o,t){e.exports=t.p+"assets/img/mac-icns-drive.4aaed978.png"},401:function(e,o,t){"use strict";t.r(o);var n=t(25),a=Object(n.a)({},(function(){var e=this,o=e.$createElement,n=e._self._c||o;return n("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[n("h1",{attrs:{id:"creating-custom-icons-for-opencore-and-mac-boot-picker"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#creating-custom-icons-for-opencore-and-mac-boot-picker"}},[e._v("#")]),e._v(" Creating custom icons for OpenCore and Mac Boot Picker")]),e._v(" "),n("p",[e._v("For users who want to customize your setup to be more personal, OpenCore does allow for custom icons and images in the boot picker.")]),e._v(" "),n("ul",[n("li",[n("a",{attrs:{href:"#custom-opencore-icons"}},[e._v("Custom OpenCore icons")])]),e._v(" "),n("li",[n("a",{attrs:{href:"#custom-mac-boot-picker-icons"}},[e._v("Custom Mac Boot Picker icons")])]),e._v(" "),n("li",[n("a",{attrs:{href:"#installing-updated-icons"}},[e._v("Installing updated icons")])])]),e._v(" "),n("h1",{attrs:{id:"custom-opencore-icons"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#custom-opencore-icons"}},[e._v("#")]),e._v(" Custom OpenCore icons")]),e._v(" "),n("p",[e._v("To generate custom OpenCore icons, you'll need the following:")]),e._v(" "),n("ul",[n("li",[e._v("Images in PNG format")]),e._v(" "),n("li",[e._v("Each image, with the following res:\n"),n("ul",[n("li",[e._v("Cursor — Mouse cursor (mandatory, up to 144x144).")]),e._v(" "),n("li",[e._v("Selected — Selected item (mandatory, 144x144).")]),e._v(" "),n("li",[e._v("Selector — Selecting item (mandatory, up to 144x40).")]),e._v(" "),n("li",[e._v("Left — Scrolling left (mandatory, 40x40).")]),e._v(" "),n("li",[e._v("Right — Scrolling right (mandatory, 40x40).")]),e._v(" "),n("li",[e._v("HardDrive — Generic OS (mandatory, 128x128).")]),e._v(" "),n("li",[e._v("Background — Centred background image. (Recommended max size 1920x1080)")]),e._v(" "),n("li",[e._v("Apple — Apple OS (128x128).")]),e._v(" "),n("li",[e._v("AppleRecv — Apple Recovery OS (128x128).")]),e._v(" "),n("li",[e._v("AppleTM — Apple Time Machine (128x128).")]),e._v(" "),n("li",[e._v("Windows — Windows (128x128).")]),e._v(" "),n("li",[e._v("Other — Custom entry (see "),n("a",{attrs:{href:"https://dortania.github.io/docs/latest/Configuration.html",target:"_blank",rel:"noopener noreferrer"}},[e._v("Entries"),n("OutboundLink")],1),e._v(", 128x128).")]),e._v(" "),n("li",[e._v("ResetNVRAM — Reset NVRAM system action or tool (128x128).")]),e._v(" "),n("li",[e._v("Shell — Entry with UEFI Shell name for e.g. OpenShell (128x128).")]),e._v(" "),n("li",[e._v("Tool — Any other tool (128x128).")])])])]),e._v(" "),n("p",[e._v("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.")]),e._v(" "),n("p",[e._v("Once you have a custom image you want to use(for example, as a background), download the "),n("a",{attrs:{href:"https://github.com/acidanthera/OpenCorePkg/releases",target:"_blank",rel:"noopener noreferrer"}},[e._v("latest release of OpenCorePkg"),n("OutboundLink")],1),e._v(" and enter the "),n("code",[e._v("Utilities/icnspack/")]),e._v(" folder:")]),e._v(" "),n("p",[n("img",{attrs:{src:t(373),alt:""}})]),e._v(" "),n("p",[e._v("Now "),n("code",[e._v("cd")]),e._v(" this folder in terminal and run the following:")]),e._v(" "),n("div",{staticClass:"language-sh extra-class"},[n("pre",{pre:!0,attrs:{class:"language-sh"}},[n("code",[e._v("./icnspack Background.icns "),n("span",{pre:!0,attrs:{class:"token operator"}},[e._v("<")]),e._v("insert_x1_image"),n("span",{pre:!0,attrs:{class:"token operator"}},[e._v(">")]),e._v(" "),n("span",{pre:!0,attrs:{class:"token operator"}},[e._v("<")]),e._v("insert_x2_image"),n("span",{pre:!0,attrs:{class:"token operator"}},[e._v(">")]),e._v("\n")])])]),n("p",[e._v("Once done, you'll see your custom icon generated in "),n("code",[e._v("icnspack")]),e._v("'s folder:")]),e._v(" "),n("p",[n("img",{attrs:{src:t(374),alt:""}})]),e._v(" "),n("h1",{attrs:{id:"custom-mac-boot-picker-icons"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#custom-mac-boot-picker-icons"}},[e._v("#")]),e._v(" Custom Mac Boot Picker icons")]),e._v(" "),n("p",[e._v("Custom boot picker icons is much more complicated on Legacy Macs, on late 2013+ Macs the "),n("a",{attrs:{href:"#custom-opencore-icons"}},[e._v("Custom OpenCore icons")]),e._v(" method will work just fine. However on many 2012 and older Macs, the icons generated will be incompatible with the firmware.")]),e._v(" "),n("p",[e._v("To generate legacy icons, you'll need the following:")]),e._v(" "),n("ul",[n("li",[e._v("A machine running macOS 10.4 through 10.11")]),e._v(" "),n("li",[e._v("Icon Composer.app (Requires Apple Developer Account for official download)\n"),n("ul",[n("li",[e._v("Users without the developer account can find a mirrors here:\n"),n("ul",[n("li",[n("a",{attrs:{href:"https://github.com/dortania/OpenCore-Legacy-Patcher/blob/main/docs/Icon-Composer-10.6.zip",target:"_blank",rel:"noopener noreferrer"}},[e._v("Icon Composer 10.6"),n("OutboundLink")],1)]),e._v(" "),n("li",[n("a",{attrs:{href:"https://github.com/dortania/OpenCore-Legacy-Patcher/blob/main/docs/Icon-Composer-10.11.zip",target:"_blank",rel:"noopener noreferrer"}},[e._v("Icon Composer 10.11"),n("OutboundLink")],1)])])])])]),e._v(" "),n("li",[e._v("PNG Image you wish to convert")])]),e._v(" "),n("p",[e._v("Head to "),n("a",{attrs:{href:"https://developer.apple.com/download/more/",target:"_blank",rel:"noopener noreferrer"}},[e._v("developer.apple's More Downloads page"),n("OutboundLink")],1),e._v(" and search for "),n("code",[e._v("Graphics Tools")]),e._v(" that is supported by your OS(note for 10.6 and older, the app is hidden inside "),n("code",[e._v("Developer Tools")]),e._v("):")]),e._v(" "),n("p",[n("img",{attrs:{src:t(375),alt:""}})]),e._v(" "),n("p",[e._v("Once downloaded, open the disk image and you'll find Icon Composer.app:")]),e._v(" "),n("p",[n("img",{attrs:{src:t(376),alt:"Graphics Open"}})]),e._v(" "),n("p",[e._v("Now run the app and simply drag the images to each section as so:")]),e._v(" "),n("p",[n("img",{attrs:{src:t(377),alt:""}})]),e._v(" "),n("p",[e._v("Now save and export the new icns")]),e._v(" "),n("h1",{attrs:{id:"installing-updated-icons"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#installing-updated-icons"}},[e._v("#")]),e._v(" Installing updated icons")]),e._v(" "),n("p",[e._v('To install, please ensure that Vault is disabled when you built OpenCore. If you\'re unsure, simply rebuild OpenCore with the Patcher setting "Vault" set to false.')]),e._v(" "),n("ul",[n("li",[n("span",{staticStyle:{color:"red"}},[e._v(" Warning")]),e._v(": Editing your OpenCore EFI incorrectly can result in a bricked install. Please ensure you have a natively supported version of macOS installed to boot into in case of issues.")])]),e._v(" "),n("p",[e._v("Now that you've verified you can edit OpenCore safely, you'll need to mount the drive that OpenCore is stored on. To do this, download "),n("a",{attrs:{href:"https://github.com/corpnewt/MountEFI",target:"_blank",rel:"noopener noreferrer"}},[e._v("MountEFI"),n("OutboundLink")],1),e._v(" and run it:")]),e._v(" "),n("p",[n("img",{attrs:{src:t(319),alt:""}})]),e._v(" "),n("p",[e._v("Select the drive you installed OpenCore to and mount it.")]),e._v(" "),n("ul",[n("li",[n("a",{attrs:{href:"#updating-opencore-icons"}},[e._v("Updating OpenCore icons")])]),e._v(" "),n("li",[n("a",{attrs:{href:"#updating-mac-boot-picker-icons"}},[e._v("Updating Mac Boot Picker icons")])])]),e._v(" "),n("h3",{attrs:{id:"updating-opencore-icons"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#updating-opencore-icons"}},[e._v("#")]),e._v(" Updating OpenCore icons")]),e._v(" "),n("p",[e._v("Head to "),n("code",[e._v("EFI/OC/Resources/Image/")]),e._v(" on your drive and you'll see all the custom icons. For Background.icns, we need to ensure the file matches the theme OpenCore has set so we add the prefix "),n("code",[e._v("Modern")]),e._v(" to it:")]),e._v(" "),n("p",[n("img",{attrs:{src:t(378),alt:""}})]),e._v(" "),n("p",[e._v("Now reboot and you should see your updated icon(s)!")]),e._v(" "),n("h3",{attrs:{id:"updating-mac-boot-picker-icons"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#updating-mac-boot-picker-icons"}},[e._v("#")]),e._v(" Updating Mac Boot Picker icons")]),e._v(" "),n("p",[e._v("To update the Mac Boot Picker icons is actually quite simple, on the root of your drive simply drop the icon onto the root of the drive with the name "),n("code",[e._v(".VolumeIcon.icns")])]),e._v(" "),n("p",[n("img",{attrs:{src:t(379),alt:""}})]),e._v(" "),n("p",[e._v("Now reboot and you'll see the new icon!")])])}),[],!1,null,null,null);o.default=a.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[3],{319:function(e,o,t){e.exports=t.p+"assets/img/mountefi.f1bedccd.png"},372:function(e,o,t){e.exports=t.p+"assets/img/icnspack-folder.6cad9bdf.png"},373:function(e,o,t){e.exports=t.p+"assets/img/icnspack-done.9f84140f.png"},374:function(e,o,t){e.exports=t.p+"assets/img/graphics-download.905b7fd4.png"},375:function(e,o,t){e.exports=t.p+"assets/img/graphics-open.a92a70e2.png"},376:function(e,o,t){e.exports=t.p+"assets/img/icon-SL.e5bfa343.png"},377:function(e,o,t){e.exports=t.p+"assets/img/background-moved.bbb8b0fd.png"},378:function(e,o,t){e.exports=t.p+"assets/img/mac-icns-drive.4aaed978.png"},400:function(e,o,t){"use strict";t.r(o);var n=t(25),a=Object(n.a)({},(function(){var e=this,o=e.$createElement,n=e._self._c||o;return n("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[n("h1",{attrs:{id:"creating-custom-icons-for-opencore-and-mac-boot-picker"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#creating-custom-icons-for-opencore-and-mac-boot-picker"}},[e._v("#")]),e._v(" Creating custom icons for OpenCore and Mac Boot Picker")]),e._v(" "),n("p",[e._v("For users who want to customize your setup to be more personal, OpenCore does allow for custom icons and images in the boot picker.")]),e._v(" "),n("ul",[n("li",[n("a",{attrs:{href:"#custom-opencore-icons"}},[e._v("Custom OpenCore icons")])]),e._v(" "),n("li",[n("a",{attrs:{href:"#custom-mac-boot-picker-icons"}},[e._v("Custom Mac Boot Picker icons")])]),e._v(" "),n("li",[n("a",{attrs:{href:"#installing-updated-icons"}},[e._v("Installing updated icons")])])]),e._v(" "),n("h1",{attrs:{id:"custom-opencore-icons"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#custom-opencore-icons"}},[e._v("#")]),e._v(" Custom OpenCore icons")]),e._v(" "),n("p",[e._v("To generate custom OpenCore icons, you'll need the following:")]),e._v(" "),n("ul",[n("li",[e._v("Images in PNG format")]),e._v(" "),n("li",[e._v("Each image, with the following res:\n"),n("ul",[n("li",[e._v("Cursor — Mouse cursor (mandatory, up to 144x144).")]),e._v(" "),n("li",[e._v("Selected — Selected item (mandatory, 144x144).")]),e._v(" "),n("li",[e._v("Selector — Selecting item (mandatory, up to 144x40).")]),e._v(" "),n("li",[e._v("Left — Scrolling left (mandatory, 40x40).")]),e._v(" "),n("li",[e._v("Right — Scrolling right (mandatory, 40x40).")]),e._v(" "),n("li",[e._v("HardDrive — Generic OS (mandatory, 128x128).")]),e._v(" "),n("li",[e._v("Background — Centred background image. (Recommended max size 1920x1080)")]),e._v(" "),n("li",[e._v("Apple — Apple OS (128x128).")]),e._v(" "),n("li",[e._v("AppleRecv — Apple Recovery OS (128x128).")]),e._v(" "),n("li",[e._v("AppleTM — Apple Time Machine (128x128).")]),e._v(" "),n("li",[e._v("Windows — Windows (128x128).")]),e._v(" "),n("li",[e._v("Other — Custom entry (see "),n("a",{attrs:{href:"https://dortania.github.io/docs/latest/Configuration.html",target:"_blank",rel:"noopener noreferrer"}},[e._v("Entries"),n("OutboundLink")],1),e._v(", 128x128).")]),e._v(" "),n("li",[e._v("ResetNVRAM — Reset NVRAM system action or tool (128x128).")]),e._v(" "),n("li",[e._v("Shell — Entry with UEFI Shell name for e.g. OpenShell (128x128).")]),e._v(" "),n("li",[e._v("Tool — Any other tool (128x128).")])])])]),e._v(" "),n("p",[e._v("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.")]),e._v(" "),n("p",[e._v("Once you have a custom image you want to use(for example, as a background), download the "),n("a",{attrs:{href:"https://github.com/acidanthera/OpenCorePkg/releases",target:"_blank",rel:"noopener noreferrer"}},[e._v("latest release of OpenCorePkg"),n("OutboundLink")],1),e._v(" and enter the "),n("code",[e._v("Utilities/icnspack/")]),e._v(" folder:")]),e._v(" "),n("p",[n("img",{attrs:{src:t(372),alt:""}})]),e._v(" "),n("p",[e._v("Now "),n("code",[e._v("cd")]),e._v(" this folder in terminal and run the following:")]),e._v(" "),n("div",{staticClass:"language-sh extra-class"},[n("pre",{pre:!0,attrs:{class:"language-sh"}},[n("code",[e._v("./icnspack Background.icns "),n("span",{pre:!0,attrs:{class:"token operator"}},[e._v("<")]),e._v("insert_x1_image"),n("span",{pre:!0,attrs:{class:"token operator"}},[e._v(">")]),e._v(" "),n("span",{pre:!0,attrs:{class:"token operator"}},[e._v("<")]),e._v("insert_x2_image"),n("span",{pre:!0,attrs:{class:"token operator"}},[e._v(">")]),e._v("\n")])])]),n("p",[e._v("Once done, you'll see your custom icon generated in "),n("code",[e._v("icnspack")]),e._v("'s folder:")]),e._v(" "),n("p",[n("img",{attrs:{src:t(373),alt:""}})]),e._v(" "),n("h1",{attrs:{id:"custom-mac-boot-picker-icons"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#custom-mac-boot-picker-icons"}},[e._v("#")]),e._v(" Custom Mac Boot Picker icons")]),e._v(" "),n("p",[e._v("Custom boot picker icons is much more complicated on Legacy Macs, on late 2013+ Macs the "),n("a",{attrs:{href:"#custom-opencore-icons"}},[e._v("Custom OpenCore icons")]),e._v(" method will work just fine. However on many 2012 and older Macs, the icons generated will be incompatible with the firmware.")]),e._v(" "),n("p",[e._v("To generate legacy icons, you'll need the following:")]),e._v(" "),n("ul",[n("li",[e._v("A machine running macOS 10.4 through 10.11")]),e._v(" "),n("li",[e._v("Icon Composer.app (Requires Apple Developer Account for official download)\n"),n("ul",[n("li",[e._v("Users without the developer account can find a mirrors here:\n"),n("ul",[n("li",[n("a",{attrs:{href:"https://github.com/dortania/OpenCore-Legacy-Patcher/blob/main/docs/Icon-Composer-10.6.zip",target:"_blank",rel:"noopener noreferrer"}},[e._v("Icon Composer 10.6"),n("OutboundLink")],1)]),e._v(" "),n("li",[n("a",{attrs:{href:"https://github.com/dortania/OpenCore-Legacy-Patcher/blob/main/docs/Icon-Composer-10.11.zip",target:"_blank",rel:"noopener noreferrer"}},[e._v("Icon Composer 10.11"),n("OutboundLink")],1)])])])])]),e._v(" "),n("li",[e._v("PNG Image you wish to convert")])]),e._v(" "),n("p",[e._v("Head to "),n("a",{attrs:{href:"https://developer.apple.com/download/more/",target:"_blank",rel:"noopener noreferrer"}},[e._v("developer.apple's More Downloads page"),n("OutboundLink")],1),e._v(" and search for "),n("code",[e._v("Graphics Tools")]),e._v(" that is supported by your OS(note for 10.6 and older, the app is hidden inside "),n("code",[e._v("Developer Tools")]),e._v("):")]),e._v(" "),n("p",[n("img",{attrs:{src:t(374),alt:""}})]),e._v(" "),n("p",[e._v("Once downloaded, open the disk image and you'll find Icon Composer.app:")]),e._v(" "),n("p",[n("img",{attrs:{src:t(375),alt:"Graphics Open"}})]),e._v(" "),n("p",[e._v("Now run the app and simply drag the images to each section as so:")]),e._v(" "),n("p",[n("img",{attrs:{src:t(376),alt:""}})]),e._v(" "),n("p",[e._v("Now save and export the new icns")]),e._v(" "),n("h1",{attrs:{id:"installing-updated-icons"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#installing-updated-icons"}},[e._v("#")]),e._v(" Installing updated icons")]),e._v(" "),n("p",[e._v('To install, please ensure that Vault is disabled when you built OpenCore. If you\'re unsure, simply rebuild OpenCore with the Patcher setting "Vault" set to false.')]),e._v(" "),n("ul",[n("li",[n("span",{staticStyle:{color:"red"}},[e._v(" Warning")]),e._v(": Editing your OpenCore EFI incorrectly can result in a bricked install. Please ensure you have a natively supported version of macOS installed to boot into in case of issues.")])]),e._v(" "),n("p",[e._v("Now that you've verified you can edit OpenCore safely, you'll need to mount the drive that OpenCore is stored on. To do this, download "),n("a",{attrs:{href:"https://github.com/corpnewt/MountEFI",target:"_blank",rel:"noopener noreferrer"}},[e._v("MountEFI"),n("OutboundLink")],1),e._v(" and run it:")]),e._v(" "),n("p",[n("img",{attrs:{src:t(319),alt:""}})]),e._v(" "),n("p",[e._v("Select the drive you installed OpenCore to and mount it.")]),e._v(" "),n("ul",[n("li",[n("a",{attrs:{href:"#updating-opencore-icons"}},[e._v("Updating OpenCore icons")])]),e._v(" "),n("li",[n("a",{attrs:{href:"#updating-mac-boot-picker-icons"}},[e._v("Updating Mac Boot Picker icons")])])]),e._v(" "),n("h3",{attrs:{id:"updating-opencore-icons"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#updating-opencore-icons"}},[e._v("#")]),e._v(" Updating OpenCore icons")]),e._v(" "),n("p",[e._v("Head to "),n("code",[e._v("EFI/OC/Resources/Image/")]),e._v(" on your drive and you'll see all the custom icons. For Background.icns, we need to ensure the file matches the theme OpenCore has set so we add the prefix "),n("code",[e._v("Modern")]),e._v(" to it:")]),e._v(" "),n("p",[n("img",{attrs:{src:t(377),alt:""}})]),e._v(" "),n("p",[e._v("Now reboot and you should see your updated icon(s)!")]),e._v(" "),n("h3",{attrs:{id:"updating-mac-boot-picker-icons"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#updating-mac-boot-picker-icons"}},[e._v("#")]),e._v(" Updating Mac Boot Picker icons")]),e._v(" "),n("p",[e._v("To update the Mac Boot Picker icons is actually quite simple, on the root of your drive simply drop the icon onto the root of the drive with the name "),n("code",[e._v(".VolumeIcon.icns")])]),e._v(" "),n("p",[n("img",{attrs:{src:t(378),alt:""}})]),e._v(" "),n("p",[e._v("Now reboot and you'll see the new icon!")])])}),[],!1,null,null,null);o.default=a.exports}}]); \ No newline at end of file diff --git a/assets/js/5.455ab867.js b/assets/js/5.2a6b8475.js similarity index 81% rename from assets/js/5.455ab867.js rename to assets/js/5.2a6b8475.js index 9490fe0cc..e0991777b 100644 --- a/assets/js/5.455ab867.js +++ b/assets/js/5.2a6b8475.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[5],{367:function(e,t,n){e.exports=n.p+"assets/img/first-run.898738d5.png"},368:function(e,t,n){e.exports=n.p+"assets/img/build-efi.b7e95d18.png"},369:function(e,t,n){e.exports=n.p+"assets/img/disk-start.b78fd552.png"},370:function(e,t,n){e.exports=n.p+"assets/img/disk-efi.fea58692.png"},397:function(e,t,n){"use strict";n.r(t);var a=n(25),i=Object(a.a)({},(function(){var e=this,t=e.$createElement,a=e._self._c||t;return a("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[a("h1",{attrs:{id:"building-and-installing-opencore"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#building-and-installing-opencore"}},[e._v("#")]),e._v(" Building and installing OpenCore")]),e._v(" "),a("p",[e._v("Now that we have a macOS installer, lets now build our OpenCore configuration!")]),e._v(" "),a("p",[e._v("First Download the latest release:")]),e._v(" "),a("ul",[a("li",[a("a",{attrs:{href:"https://github.com/dortania/Opencore-Legacy-Patcher/releases",target:"_blank",rel:"noopener noreferrer"}},[e._v("OpenCore Legacy Patcher Releases"),a("OutboundLink")],1)])]),e._v(" "),a("p",[e._v("Next, run the "),a("code",[e._v("OpenCore-Patcher.app")]),e._v(":")]),e._v(" "),a("p",[a("img",{attrs:{src:n(367),alt:""}})]),e._v(" "),a("p",[e._v("From here you have a couple important options:")]),e._v(" "),a("ul",[a("li",[e._v("Build OpenCore")]),e._v(" "),a("li",[e._v("Install OpenCore to USB/internal drive")]),e._v(" "),a("li",[e._v("Change Model")]),e._v(" "),a("li",[e._v("Patcher Settings")])]),e._v(" "),a("p",[e._v('If you\'re patching for a different machine than you\'re running, please select "Change Model" and enter the updated SMBIOS. For more advanced users, you may also tweak the patcher\'s build settings via "Patcher Settings"')]),e._v(" "),a("p",[e._v('Now lets enter "Build OpenCore":')]),e._v(" "),a("p",[a("img",{attrs:{src:n(368),alt:""}})]),e._v(" "),a("p",[e._v("The process should be quite quick to build, once finished you'll be plopped back to the main menu.")]),e._v(" "),a("p",[e._v("Next lets run "),a("code",[e._v("Install OpenCore to USB/internal drive")]),e._v(":")]),e._v(" "),a("table",[a("thead",[a("tr",[a("th",{staticStyle:{"text-align":"left"}},[e._v("Select Drive")]),e._v(" "),a("th",{staticStyle:{"text-align":"left"}},[e._v("Select EFI/FAT32 Partition")])])]),e._v(" "),a("tbody",[a("tr",[a("td",{staticStyle:{"text-align":"left"}},[a("img",{attrs:{src:n(369),alt:""}})]),e._v(" "),a("td",{staticStyle:{"text-align":"left"}},[a("img",{attrs:{src:n(370),alt:""}})])])])]),e._v(" "),a("ul",[a("li",[e._v("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")])]),e._v(" "),a("h1",{attrs:{id:"once-finished-head-to-booting-opencore-and-macos"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#once-finished-head-to-booting-opencore-and-macos"}},[e._v("#")]),e._v(" Once finished, head to "),a("RouterLink",{attrs:{to:"/BOOT.html"}},[e._v("Booting OpenCore and macOS")])],1)])}),[],!1,null,null,null);t.default=i.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[5],{368:function(e,t,n){e.exports=n.p+"assets/img/first-run.898738d5.png"},369:function(e,t,n){e.exports=n.p+"assets/img/build-efi.b7e95d18.png"},370:function(e,t,n){e.exports=n.p+"assets/img/disk-start.b78fd552.png"},371:function(e,t,n){e.exports=n.p+"assets/img/disk-efi.fea58692.png"},399:function(e,t,n){"use strict";n.r(t);var a=n(25),i=Object(a.a)({},(function(){var e=this,t=e.$createElement,a=e._self._c||t;return a("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[a("h1",{attrs:{id:"building-and-installing-opencore"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#building-and-installing-opencore"}},[e._v("#")]),e._v(" Building and installing OpenCore")]),e._v(" "),a("p",[e._v("Now that we have a macOS installer, lets now build our OpenCore configuration!")]),e._v(" "),a("p",[e._v("First Download the latest release:")]),e._v(" "),a("ul",[a("li",[a("a",{attrs:{href:"https://github.com/dortania/Opencore-Legacy-Patcher/releases",target:"_blank",rel:"noopener noreferrer"}},[e._v("OpenCore Legacy Patcher Releases"),a("OutboundLink")],1)])]),e._v(" "),a("p",[e._v("Next, run the "),a("code",[e._v("OpenCore-Patcher.app")]),e._v(":")]),e._v(" "),a("p",[a("img",{attrs:{src:n(368),alt:""}})]),e._v(" "),a("p",[e._v("From here you have a couple important options:")]),e._v(" "),a("ul",[a("li",[e._v("Build OpenCore")]),e._v(" "),a("li",[e._v("Install OpenCore to USB/internal drive")]),e._v(" "),a("li",[e._v("Change Model")]),e._v(" "),a("li",[e._v("Patcher Settings")])]),e._v(" "),a("p",[e._v('If you\'re patching for a different machine than you\'re running, please select "Change Model" and enter the updated SMBIOS. For more advanced users, you may also tweak the patcher\'s build settings via "Patcher Settings"')]),e._v(" "),a("p",[e._v('Now lets enter "Build OpenCore":')]),e._v(" "),a("p",[a("img",{attrs:{src:n(369),alt:""}})]),e._v(" "),a("p",[e._v("The process should be quite quick to build, once finished you'll be plopped back to the main menu.")]),e._v(" "),a("p",[e._v("Next lets run "),a("code",[e._v("Install OpenCore to USB/internal drive")]),e._v(":")]),e._v(" "),a("table",[a("thead",[a("tr",[a("th",{staticStyle:{"text-align":"left"}},[e._v("Select Drive")]),e._v(" "),a("th",{staticStyle:{"text-align":"left"}},[e._v("Select EFI/FAT32 Partition")])])]),e._v(" "),a("tbody",[a("tr",[a("td",{staticStyle:{"text-align":"left"}},[a("img",{attrs:{src:n(370),alt:""}})]),e._v(" "),a("td",{staticStyle:{"text-align":"left"}},[a("img",{attrs:{src:n(371),alt:""}})])])])]),e._v(" "),a("ul",[a("li",[e._v("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")])]),e._v(" "),a("h1",{attrs:{id:"once-finished-head-to-booting-opencore-and-macos"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#once-finished-head-to-booting-opencore-and-macos"}},[e._v("#")]),e._v(" Once finished, head to "),a("RouterLink",{attrs:{to:"/BOOT.html"}},[e._v("Booting OpenCore and macOS")])],1)])}),[],!1,null,null,null);t.default=i.exports}}]); \ No newline at end of file diff --git a/assets/js/app.839c8b9c.js b/assets/js/app.16a074a0.js similarity index 93% rename from assets/js/app.839c8b9c.js rename to assets/js/app.16a074a0.js index ebaec08b8..eb15e425f 100644 --- a/assets/js/app.839c8b9c.js +++ b/assets/js/app.16a074a0.js @@ -1,9 +1,9 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[0],[]]);!function(t){function e(e){for(var r,a,c=e[0],u=e[1],s=e[2],f=0,p=[];f0?o(r(t),9007199254740991):0}},function(t,e){var n=Array.isArray;t.exports=n},function(t,e,n){var r=n(33),o=n(19);t.exports=function(t){return r(o(t))}},function(t,e,n){var r=n(142),o="object"==typeof self&&self&&self.Object===Object&&self,i=r||o||Function("return this")();t.exports=i},function(t,e,n){var r=n(6),o=n(1),i=n(7),a=Object.defineProperty,c={},u=function(t){throw t};t.exports=function(t,e){if(i(c,t))return c[t];e||(e={});var n=[][t],s=!!i(e,"ACCESSORS")&&e.ACCESSORS,l=i(e,0)?e[0]:u,f=i(e,1)?e[1]:void 0;return c[t]=!!n&&!o((function(){if(s&&!r)return!0;var t={length:-1};s?a(t,1,{enumerable:!0,get:u}):t[1]=1,n.call(t,l,f)}))}},function(t,e,n){var r=n(114),o=n(2),i=function(t){return"function"==typeof t?t:void 0};t.exports=function(t,e){return arguments.length<2?i(r[t])||i(o[t]):r[t]&&r[t][e]||o[t]&&o[t][e]}},function(t,e){t.exports=function(t){if(null==t)throw TypeError("Can't call method on "+t);return t}},function(t,e){t.exports=!1},function(t,e,n){var r=n(6),o=n(80),i=n(35),a=n(15),c=n(34),u=n(7),s=n(109),l=Object.getOwnPropertyDescriptor;e.f=r?l:function(t,e){if(t=a(t),e=c(e,!0),s)try{return l(t,e)}catch(t){}if(u(t,e))return i(!o.f.call(t,e),t[e])}},function(t,e){var n={}.toString;t.exports=function(t){return n.call(t).slice(8,-1)}},function(t,e){t.exports=function(t){if("function"!=typeof t)throw TypeError(String(t)+" is not a function");return t}},function(t,e,n){var r=n(231),o=n(234);t.exports=function(t,e){var n=o(t,e);return r(n)?n:void 0}},function(t,e,n){"use strict";function r(t,e,n,r,o,i,a,c){var u,s="function"==typeof t?t.options:t;if(e&&(s.render=e,s.staticRenderFns=n,s._compiled=!0),r&&(s.functional=!0),i&&(s._scopeId="data-v-"+i),a?(u=function(t){(t=t||this.$vnode&&this.$vnode.ssrContext||this.parent&&this.parent.$vnode&&this.parent.$vnode.ssrContext)||"undefined"==typeof __VUE_SSR_CONTEXT__||(t=__VUE_SSR_CONTEXT__),o&&o.call(this,t),t&&t._registeredComponents&&t._registeredComponents.add(a)},s._ssrRegister=u):o&&(u=c?function(){o.call(this,(s.functional?this.parent:this).$root.$options.shadowRoot)}:o),u)if(s.functional){s._injectStyles=u;var l=s.render;s.render=function(t,e){return u.call(e),l(t,e)}}else{var f=s.beforeCreate;s.beforeCreate=f?[].concat(f,u):[u]}return{exports:t,options:s}}n.d(e,"a",(function(){return r}))},function(t,e,n){"use strict";var r=n(0),o=n(31).filter,i=n(54),a=n(17),c=i("filter"),u=a("filter");r({target:"Array",proto:!0,forced:!c||!u},{filter:function(t){return o(this,t,arguments.length>1?arguments[1]:void 0)}})},function(t,e){t.exports=function(t){return null!=t&&"object"==typeof t}},function(t,e,n){var r,o=n(5),i=n(189),a=n(78),c=n(36),u=n(113),s=n(75),l=n(49),f=l("IE_PROTO"),p=function(){},d=function(t){return" +