From 47d22f7fadb58eb8449d8c29c93a43998e28818c Mon Sep 17 00:00:00 2001 From: khronokernel <48863253+khronokernel@users.noreply.github.com> Date: Sun, 11 Apr 2021 14:48:06 +0000 Subject: [PATCH] =?UTF-8?q?Deploying=20to=20gh-pages=20from=20=20@=2070b53?= =?UTF-8?q?99126ab223ea38189f78c3138ab0db2cdf0=20=F0=9F=9A=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 404.html | 6 +++--- BENIFITS.html | 4 ++-- BOOT.html | 4 ++-- BUILD.html | 4 ++-- DEBUG.html | 4 ++-- DONATE.html | 6 +++--- 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 | 4 ++-- TESTED.html | 4 ++-- TROUBLESHOOTING.html | 4 ++-- UNINSTALL.html | 4 ++-- UPDATE.html | 4 ++-- assets/js/{11.0731b695.js => 11.537df9fd.js} | 2 +- assets/js/{12.29a07bcd.js => 12.5f8193a1.js} | 2 +- assets/js/18.2637571b.js | 1 + assets/js/18.98dc5412.js | 1 - assets/js/{23.26513c36.js => 23.4f34cdf8.js} | 2 +- assets/js/{24.db2ab1b4.js => 24.0f75769d.js} | 2 +- assets/js/{3.49012f09.js => 3.a1fa9b19.js} | 2 +- assets/js/{5.12814ad4.js => 5.12e117c7.js} | 2 +- assets/js/{app.1f66b3e4.js => app.8ad07129.js} | 6 +++--- index.html | 4 ++-- 29 files changed, 52 insertions(+), 52 deletions(-) rename assets/js/{11.0731b695.js => 11.537df9fd.js} (92%) rename assets/js/{12.29a07bcd.js => 12.5f8193a1.js} (93%) create mode 100644 assets/js/18.2637571b.js delete mode 100644 assets/js/18.98dc5412.js rename assets/js/{23.26513c36.js => 23.4f34cdf8.js} (97%) rename assets/js/{24.db2ab1b4.js => 24.0f75769d.js} (99%) rename assets/js/{3.49012f09.js => 3.a1fa9b19.js} (98%) rename assets/js/{5.12814ad4.js => 5.12e117c7.js} (81%) rename assets/js/{app.1f66b3e4.js => app.8ad07129.js} (98%) diff --git a/404.html b/404.html index d29c569b2..c4264d774 100644 --- a/404.html +++ b/404.html @@ -11,13 +11,13 @@ - + -

404

Looks like we've got some broken links.
+ - + diff --git a/BENIFITS.html b/BENIFITS.html index 4c0266646..4f87ab15b 100644 --- a/BENIFITS.html +++ b/BENIFITS.html @@ -11,7 +11,7 @@ - + @@ -28,6 +28,6 @@ ⟶

- + diff --git a/BOOT.html b/BOOT.html index 503755722..e73b7773e 100644 --- a/BOOT.html +++ b/BOOT.html @@ -11,7 +11,7 @@ - + @@ -28,6 +28,6 @@ ⟶

- + diff --git a/BUILD.html b/BUILD.html index 0f9db931c..81b520058 100644 --- a/BUILD.html +++ b/BUILD.html @@ -11,7 +11,7 @@ - + @@ -28,6 +28,6 @@ ⟶

- + diff --git a/DEBUG.html b/DEBUG.html index 088120c7c..ee090c2d2 100644 --- a/DEBUG.html +++ b/DEBUG.html @@ -11,7 +11,7 @@ - + @@ -29,6 +29,6 @@ ⟶

- + diff --git a/DONATE.html b/DONATE.html index e05a6a5de..f7574e6ee 100644 --- a/DONATE.html +++ b/DONATE.html @@ -11,7 +11,7 @@ - + @@ -20,7 +20,7 @@ (opens new window)

# Supporting the patcher

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.

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.

Main hardware we'd appreciate:

If you have any legacy hardware you're willing to donate, please contact us at the following email:

Current hardware we own:

Model CPU GPU Owner Notes
MacBook7,1 Penryn GT320M Dhinak N/A
MacBook7,1 Penryn GT320M Mykola N/A
iMac11,2 Clarksdale HD4670 Mykola N/A

+

Additionally, hardware info dumps are greatly beneficial for us to determine what patches a machine might need:

If you have any legacy hardware you're willing to donate, please contact us at the following email:

Current hardware we own:

Model CPU GPU Owner Notes
MacBook7,1 Penryn GT320M Dhinak N/A
MacBook7,1 Penryn GT320M Mykola N/A
iMac11,2 Clarksdale HD4670 Mykola N/A

⟵ ⟶

- + diff --git a/HOW.html b/HOW.html index d815859cd..94539aad2 100644 --- a/HOW.html +++ b/HOW.html @@ -11,7 +11,7 @@ - + @@ -28,6 +28,6 @@ ⟶

- + diff --git a/ICNS.html b/ICNS.html index 1454ca70e..85049dff2 100644 --- a/ICNS.html +++ b/ICNS.html @@ -11,7 +11,7 @@ - + @@ -32,6 +32,6 @@ ⟶

- + diff --git a/INSTALLER.html b/INSTALLER.html index 9bc877c30..7369c0827 100644 --- a/INSTALLER.html +++ b/INSTALLER.html @@ -11,7 +11,7 @@ - + @@ -30,6 +30,6 @@ ⟶

- + diff --git a/LICENSE.html b/LICENSE.html index 1c3e21a6a..5e00b0aeb 100644 --- a/LICENSE.html +++ b/LICENSE.html @@ -11,7 +11,7 @@ - + @@ -30,6 +30,6 @@ ⟶

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

- + diff --git a/PATCHEXPLAIN.html b/PATCHEXPLAIN.html index 1e7b9a316..6646f1da5 100644 --- a/PATCHEXPLAIN.html +++ b/PATCHEXPLAIN.html @@ -11,7 +11,7 @@ - + @@ -61,6 +61,6 @@

- + diff --git a/POST-INSTALL.html b/POST-INSTALL.html index f711d7c78..23231c58e 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 654cdcdab..42ae6c027 100644 --- a/START.html +++ b/START.html @@ -11,7 +11,7 @@ - + @@ -24,6 +24,6 @@ ⟶

- + diff --git a/TERMS.html b/TERMS.html index 6bb158652..e1a1bc4ad 100644 --- a/TERMS.html +++ b/TERMS.html @@ -11,7 +11,7 @@ - + @@ -28,6 +28,6 @@ ⟶

- + diff --git a/TESTED.html b/TESTED.html index 08da457e8..f47243c3e 100644 --- a/TESTED.html +++ b/TESTED.html @@ -11,7 +11,7 @@ - + @@ -28,6 +28,6 @@ ⟶

- + diff --git a/TROUBLESHOOTING.html b/TROUBLESHOOTING.html index 7b4ea2885..3364da5c5 100644 --- a/TROUBLESHOOTING.html +++ b/TROUBLESHOOTING.html @@ -11,7 +11,7 @@ - + @@ -30,6 +30,6 @@ ⟶

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

- + diff --git a/UPDATE.html b/UPDATE.html index 1fda52394..fa2bb18b3 100644 --- a/UPDATE.html +++ b/UPDATE.html @@ -11,7 +11,7 @@ - + @@ -32,6 +32,6 @@ nvram 4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:OCLP-Version ⟶

- + diff --git a/assets/js/11.0731b695.js b/assets/js/11.537df9fd.js similarity index 92% rename from assets/js/11.0731b695.js rename to assets/js/11.537df9fd.js index 3e57b3421..4b6d9336c 100644 --- a/assets/js/11.0731b695.js +++ b/assets/js/11.537df9fd.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[11],{320: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"},400: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(320),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"},368:function(e,t,o){e.exports=o.p+"assets/img/logs-efi.c416d33f.png"},399: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(368),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.29a07bcd.js b/assets/js/12.5f8193a1.js similarity index 93% rename from assets/js/12.29a07bcd.js rename to assets/js/12.5f8193a1.js index 62db08fd4..3a4222f0f 100644 --- a/assets/js/12.29a07bcd.js +++ b/assets/js/12.5f8193a1.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[12],{319:function(e,n,t){e.exports=t.p+"assets/img/first-run.898738d5.png"},387:function(e,n,t){e.exports=t.p+"assets/img/oclp-version.98f68848.png"},415:function(e,n,t){"use strict";t.r(n);var r=t(25),a=Object(r.a)({},(function(){var e=this,n=e.$createElement,r=e._self._c||n;return r("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[r("h1",{attrs:{id:"updating-opencore-and-co"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#updating-opencore-and-co"}},[e._v("#")]),e._v(" Updating OpenCore and Co.")]),e._v(" "),r("p",[e._v("With OpenCore Legacy Patcher, generally there's very little reason for users to update the OpenCore installed on their machine unless you feel there's a benefit with new versions for your setup.")]),e._v(" "),r("p",[e._v("For those who do wish to update, it's actually quite easy. Simply "),r("a",{attrs:{href:"https://github.com/dortania/OpenCore-Legacy-Patcher/releases",target:"_blank",rel:"noopener noreferrer"}},[e._v("download the latest release"),r("OutboundLink")],1),e._v(" and rerun the patcher:")]),e._v(" "),r("p",[r("img",{attrs:{src:t(319),alt:""}})]),e._v(" "),r("p",[e._v("Then simply rebuild your OpenCore build and install again. Then voila, OpenCore is updated!")]),e._v(" "),r("p",[e._v("To check what version of OpenCore and Patcher version you're currently running, you can run the following in terminal:")]),e._v(" "),r("div",{staticClass:"language-bash extra-class"},[r("pre",{pre:!0,attrs:{class:"language-bash"}},[r("code",[r("span",{pre:!0,attrs:{class:"token comment"}},[e._v("# OpenCore Version")]),e._v("\nnvram 4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:opencore-version\n"),r("span",{pre:!0,attrs:{class:"token comment"}},[e._v("# Patcher Version")]),e._v("\nnvram 4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:OCLP-Version\n")])])]),r("p",[r("img",{attrs:{src:t(387),alt:""}})]),e._v(" "),r("p",[e._v("From this, we can see we're running a RELEASE version of OpenCore 0.6.8 built on March 27th, 2021 with Patcher Version 0.0.20!")])])}),[],!1,null,null,null);n.default=a.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[12],{320:function(e,n,t){e.exports=t.p+"assets/img/first-run.898738d5.png"},387:function(e,n,t){e.exports=t.p+"assets/img/oclp-version.98f68848.png"},415:function(e,n,t){"use strict";t.r(n);var r=t(25),a=Object(r.a)({},(function(){var e=this,n=e.$createElement,r=e._self._c||n;return r("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[r("h1",{attrs:{id:"updating-opencore-and-co"}},[r("a",{staticClass:"header-anchor",attrs:{href:"#updating-opencore-and-co"}},[e._v("#")]),e._v(" Updating OpenCore and Co.")]),e._v(" "),r("p",[e._v("With OpenCore Legacy Patcher, generally there's very little reason for users to update the OpenCore installed on their machine unless you feel there's a benefit with new versions for your setup.")]),e._v(" "),r("p",[e._v("For those who do wish to update, it's actually quite easy. Simply "),r("a",{attrs:{href:"https://github.com/dortania/OpenCore-Legacy-Patcher/releases",target:"_blank",rel:"noopener noreferrer"}},[e._v("download the latest release"),r("OutboundLink")],1),e._v(" and rerun the patcher:")]),e._v(" "),r("p",[r("img",{attrs:{src:t(320),alt:""}})]),e._v(" "),r("p",[e._v("Then simply rebuild your OpenCore build and install again. Then voila, OpenCore is updated!")]),e._v(" "),r("p",[e._v("To check what version of OpenCore and Patcher version you're currently running, you can run the following in terminal:")]),e._v(" "),r("div",{staticClass:"language-bash extra-class"},[r("pre",{pre:!0,attrs:{class:"language-bash"}},[r("code",[r("span",{pre:!0,attrs:{class:"token comment"}},[e._v("# OpenCore Version")]),e._v("\nnvram 4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:opencore-version\n"),r("span",{pre:!0,attrs:{class:"token comment"}},[e._v("# Patcher Version")]),e._v("\nnvram 4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:OCLP-Version\n")])])]),r("p",[r("img",{attrs:{src:t(387),alt:""}})]),e._v(" "),r("p",[e._v("From this, we can see we're running a RELEASE version of OpenCore 0.6.8 built on March 27th, 2021 with Patcher Version 0.0.20!")])])}),[],!1,null,null,null);n.default=a.exports}}]); \ No newline at end of file diff --git a/assets/js/18.2637571b.js b/assets/js/18.2637571b.js new file mode 100644 index 000000000..07cdcec21 --- /dev/null +++ b/assets/js/18.2637571b.js @@ -0,0 +1 @@ +(window.webpackJsonp=window.webpackJsonp||[]).push([[18],{400:function(t,e,a){"use strict";a.r(e);var l=a(25),n=Object(l.a)({},(function(){var t=this,e=t.$createElement,a=t._self._c||e;return a("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[a("h1",{attrs:{id:"supporting-the-patcher"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#supporting-the-patcher"}},[t._v("#")]),t._v(" Supporting the patcher")]),t._v(" "),a("p",[t._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.")]),t._v(" "),a("p",[t._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.")]),t._v(" "),a("p",[t._v("Main hardware we'd appreciate:")]),t._v(" "),a("ul",[a("li",[t._v("Any Mac you own\n"),a("ul",[a("li",[t._v("Does require SSE4,1 CPU to test on Sierra and newer however")])])])]),t._v(" "),a("p",[t._v("Additionally, hardware info dumps are greatly beneficial for us to determine what patches a machine might need:")]),t._v(" "),a("ul",[a("li",[a("a",{attrs:{href:"https://github.com/khronokernel/IORegistryClone/blob/master/ioreg-210.zip?raw=true",target:"_blank",rel:"noopener noreferrer"}},[t._v("IORegistryExplorer"),a("OutboundLink")],1),t._v(" "),a("ul",[a("li",[a("code",[t._v("File -> SaveAs")]),t._v(" and open an issue on Github")]),t._v(" "),a("li",[t._v("Note: We want IOReg dumps of hardware not running on OpenCore, instead running a clean, supported OS")])])])]),t._v(" "),a("p",[t._v("If you have any legacy hardware you're willing to donate, please contact us at the following email:")]),t._v(" "),a("ul",[a("li",[t._v("khronokernel@icloud.com")])]),t._v(" "),a("p",[t._v("Current hardware we own:")]),t._v(" "),a("table",[a("thead",[a("tr",[a("th",{staticStyle:{"text-align":"left"}},[t._v("Model")]),t._v(" "),a("th",{staticStyle:{"text-align":"left"}},[t._v("CPU")]),t._v(" "),a("th",{staticStyle:{"text-align":"left"}},[t._v("GPU")]),t._v(" "),a("th",{staticStyle:{"text-align":"left"}},[t._v("Owner")]),t._v(" "),a("th",{staticStyle:{"text-align":"left"}},[t._v("Notes")])])]),t._v(" "),a("tbody",[a("tr",[a("td",{staticStyle:{"text-align":"left"}},[t._v("MacBook7,1")]),t._v(" "),a("td",{staticStyle:{"text-align":"left"}},[t._v("Penryn")]),t._v(" "),a("td",{staticStyle:{"text-align":"left"}},[t._v("GT320M")]),t._v(" "),a("td",{staticStyle:{"text-align":"left"}},[t._v("Dhinak")]),t._v(" "),a("td",{staticStyle:{"text-align":"left"}},[t._v("N/A")])]),t._v(" "),a("tr",[a("td",{staticStyle:{"text-align":"left"}},[t._v("MacBook7,1")]),t._v(" "),a("td",{staticStyle:{"text-align":"left"}},[t._v("Penryn")]),t._v(" "),a("td",{staticStyle:{"text-align":"left"}},[t._v("GT320M")]),t._v(" "),a("td",{staticStyle:{"text-align":"left"}},[t._v("Mykola")]),t._v(" "),a("td",{staticStyle:{"text-align":"left"}},[t._v("N/A")])]),t._v(" "),a("tr",[a("td",{staticStyle:{"text-align":"left"}},[t._v("iMac11,2")]),t._v(" "),a("td",{staticStyle:{"text-align":"left"}},[t._v("Clarksdale")]),t._v(" "),a("td",{staticStyle:{"text-align":"left"}},[t._v("HD4670")]),t._v(" "),a("td",{staticStyle:{"text-align":"left"}},[t._v("Mykola")]),t._v(" "),a("td",{staticStyle:{"text-align":"left"}},[t._v("N/A")])])])])])}),[],!1,null,null,null);e.default=n.exports}}]); \ No newline at end of file diff --git a/assets/js/18.98dc5412.js b/assets/js/18.98dc5412.js deleted file mode 100644 index 7ac0f78b7..000000000 --- a/assets/js/18.98dc5412.js +++ /dev/null @@ -1 +0,0 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[18],{401:function(t,e,a){"use strict";a.r(e);var l=a(25),i=Object(l.a)({},(function(){var t=this,e=t.$createElement,a=t._self._c||e;return a("ContentSlotsDistributor",{attrs:{"slot-key":t.$parent.slotKey}},[a("h1",{attrs:{id:"supporting-the-patcher"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#supporting-the-patcher"}},[t._v("#")]),t._v(" Supporting the patcher")]),t._v(" "),a("p",[t._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.")]),t._v(" "),a("p",[t._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.")]),t._v(" "),a("p",[t._v("Main hardware we'd appreciate:")]),t._v(" "),a("ul",[a("li",[t._v("Any Mac you own\n"),a("ul",[a("li",[t._v("Does require SSE4,1 CPU to test on Sierra and newer however")])])])]),t._v(" "),a("p",[t._v("If you have any legacy hardware you're willing to donate, please contact us at the following email:")]),t._v(" "),a("ul",[a("li",[t._v("khronokernel@icloud.com")])]),t._v(" "),a("p",[t._v("Current hardware we own:")]),t._v(" "),a("table",[a("thead",[a("tr",[a("th",{staticStyle:{"text-align":"left"}},[t._v("Model")]),t._v(" "),a("th",{staticStyle:{"text-align":"left"}},[t._v("CPU")]),t._v(" "),a("th",{staticStyle:{"text-align":"left"}},[t._v("GPU")]),t._v(" "),a("th",{staticStyle:{"text-align":"left"}},[t._v("Owner")]),t._v(" "),a("th",{staticStyle:{"text-align":"left"}},[t._v("Notes")])])]),t._v(" "),a("tbody",[a("tr",[a("td",{staticStyle:{"text-align":"left"}},[t._v("MacBook7,1")]),t._v(" "),a("td",{staticStyle:{"text-align":"left"}},[t._v("Penryn")]),t._v(" "),a("td",{staticStyle:{"text-align":"left"}},[t._v("GT320M")]),t._v(" "),a("td",{staticStyle:{"text-align":"left"}},[t._v("Dhinak")]),t._v(" "),a("td",{staticStyle:{"text-align":"left"}},[t._v("N/A")])]),t._v(" "),a("tr",[a("td",{staticStyle:{"text-align":"left"}},[t._v("MacBook7,1")]),t._v(" "),a("td",{staticStyle:{"text-align":"left"}},[t._v("Penryn")]),t._v(" "),a("td",{staticStyle:{"text-align":"left"}},[t._v("GT320M")]),t._v(" "),a("td",{staticStyle:{"text-align":"left"}},[t._v("Mykola")]),t._v(" "),a("td",{staticStyle:{"text-align":"left"}},[t._v("N/A")])]),t._v(" "),a("tr",[a("td",{staticStyle:{"text-align":"left"}},[t._v("iMac11,2")]),t._v(" "),a("td",{staticStyle:{"text-align":"left"}},[t._v("Clarksdale")]),t._v(" "),a("td",{staticStyle:{"text-align":"left"}},[t._v("HD4670")]),t._v(" "),a("td",{staticStyle:{"text-align":"left"}},[t._v("Mykola")]),t._v(" "),a("td",{staticStyle:{"text-align":"left"}},[t._v("N/A")])])])])])}),[],!1,null,null,null);e.default=i.exports}}]); \ No newline at end of file diff --git a/assets/js/23.26513c36.js b/assets/js/23.4f34cdf8.js similarity index 97% rename from assets/js/23.26513c36.js rename to assets/js/23.4f34cdf8.js index 4bc9fa77e..c521c4384 100644 --- a/assets/js/23.26513c36.js +++ b/assets/js/23.4f34cdf8.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[23],{410:function(e,t,o){"use strict";o.r(t);var a=o(25),r=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:"what-is-opencore"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#what-is-opencore"}},[e._v("#")]),e._v(" What is OpenCore?")]),e._v(" "),o("p",[e._v("This is a sophisticated boot loader used to inject and patch data in memory, instead of on disk. This means we're able to get near-native experience on many unsupported Macs with Metal GPUs. This includes many of the long desired features of other patchers such as:")]),e._v(" "),o("ul",[o("li",[e._v("System Integrity Protection, FileVault 2, .im4m Secure Boot and Vaulting")]),e._v(" "),o("li",[e._v("Native OTA OS DELTA updates on all Macs")]),e._v(" "),o("li",[e._v("Recovery OS, Safe Mode and Single-user Mode booting")])]),e._v(" "),o("p",[e._v("While many PC users from the Hackintosh community are familiar with OpenCore, OpenCore was designed as Mac and PC agnostic ensuring both platforms can use it easily. And with OpenCore Legacy Patcher, we help automate the process making running with OpenCore that much easier.")]),e._v(" "),o("p",[e._v("For advanced troubleshooting, we highly recommend users check out the "),o("a",{attrs:{href:"https://discord.gg/XbbWAsE",target:"_blank",rel:"noopener noreferrer"}},[e._v("Unsupported Mac Discord Server"),o("OutboundLink")],1),e._v(" as this is generally the quickest way to get a hold of us developers and get help from the community.")]),e._v(" "),o("p",[e._v("For those who wish to support this patcher, please see the "),o("RouterLink",{attrs:{to:"/DONATE.html"}},[e._v("Supporting the Patcher page")])],1),e._v(" "),o("h2",{attrs:{id:"how-do-i-get-started"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#how-do-i-get-started"}},[e._v("#")]),e._v(" How do I get started?")]),e._v(" "),o("ol",[o("li",[e._v("The first step of ensuring whether your model is support is checking here:")])]),e._v(" "),o("ul",[o("li",[o("RouterLink",{attrs:{to:"/MODELS.html"}},[e._v("Supported Models")])],1)]),e._v(" "),o("ol",{attrs:{start:"2"}},[o("li",[o("RouterLink",{attrs:{to:"/INSTALLER.html"}},[e._v("Download and build macOS Installer")])],1),e._v(" "),o("li",[o("RouterLink",{attrs:{to:"/BUILD.html"}},[e._v("Run the "),o("code",[e._v("OpenCore-Patcher.app")])])],1),e._v(" "),o("li",[o("RouterLink",{attrs:{to:"/BOOT.html"}},[e._v("Reboot and boot OpenCore")])],1)])])}),[],!1,null,null,null);t.default=r.exports}}]); \ No newline at end of file +(window.webpackJsonp=window.webpackJsonp||[]).push([[23],{411:function(e,t,o){"use strict";o.r(t);var a=o(25),r=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:"what-is-opencore"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#what-is-opencore"}},[e._v("#")]),e._v(" What is OpenCore?")]),e._v(" "),o("p",[e._v("This is a sophisticated boot loader used to inject and patch data in memory, instead of on disk. This means we're able to get near-native experience on many unsupported Macs with Metal GPUs. This includes many of the long desired features of other patchers such as:")]),e._v(" "),o("ul",[o("li",[e._v("System Integrity Protection, FileVault 2, .im4m Secure Boot and Vaulting")]),e._v(" "),o("li",[e._v("Native OTA OS DELTA updates on all Macs")]),e._v(" "),o("li",[e._v("Recovery OS, Safe Mode and Single-user Mode booting")])]),e._v(" "),o("p",[e._v("While many PC users from the Hackintosh community are familiar with OpenCore, OpenCore was designed as Mac and PC agnostic ensuring both platforms can use it easily. And with OpenCore Legacy Patcher, we help automate the process making running with OpenCore that much easier.")]),e._v(" "),o("p",[e._v("For advanced troubleshooting, we highly recommend users check out the "),o("a",{attrs:{href:"https://discord.gg/XbbWAsE",target:"_blank",rel:"noopener noreferrer"}},[e._v("Unsupported Mac Discord Server"),o("OutboundLink")],1),e._v(" as this is generally the quickest way to get a hold of us developers and get help from the community.")]),e._v(" "),o("p",[e._v("For those who wish to support this patcher, please see the "),o("RouterLink",{attrs:{to:"/DONATE.html"}},[e._v("Supporting the Patcher page")])],1),e._v(" "),o("h2",{attrs:{id:"how-do-i-get-started"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#how-do-i-get-started"}},[e._v("#")]),e._v(" How do I get started?")]),e._v(" "),o("ol",[o("li",[e._v("The first step of ensuring whether your model is support is checking here:")])]),e._v(" "),o("ul",[o("li",[o("RouterLink",{attrs:{to:"/MODELS.html"}},[e._v("Supported Models")])],1)]),e._v(" "),o("ol",{attrs:{start:"2"}},[o("li",[o("RouterLink",{attrs:{to:"/INSTALLER.html"}},[e._v("Download and build macOS Installer")])],1),e._v(" "),o("li",[o("RouterLink",{attrs:{to:"/BUILD.html"}},[e._v("Run the "),o("code",[e._v("OpenCore-Patcher.app")])])],1),e._v(" "),o("li",[o("RouterLink",{attrs:{to:"/BOOT.html"}},[e._v("Reboot and boot OpenCore")])],1)])])}),[],!1,null,null,null);t.default=r.exports}}]); \ No newline at end of file diff --git a/assets/js/24.db2ab1b4.js b/assets/js/24.0f75769d.js similarity index 99% rename from assets/js/24.db2ab1b4.js rename to assets/js/24.0f75769d.js index e5ec44f36..6a81e7aa9 100644 --- a/assets/js/24.db2ab1b4.js +++ b/assets/js/24.0f75769d.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[24],{411: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 +(window.webpackJsonp=window.webpackJsonp||[]).push([[24],{410: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.49012f09.js b/assets/js/3.a1fa9b19.js similarity index 98% rename from assets/js/3.49012f09.js rename to assets/js/3.a1fa9b19.js index 5a222303f..e8d64b1d4 100644 --- a/assets/js/3.49012f09.js +++ b/assets/js/3.a1fa9b19.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[3],{320: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"},403: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(320),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"},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"},403: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 diff --git a/assets/js/5.12814ad4.js b/assets/js/5.12e117c7.js similarity index 81% rename from assets/js/5.12814ad4.js rename to assets/js/5.12e117c7.js index a2740f096..0428c4db0 100644 --- a/assets/js/5.12814ad4.js +++ b/assets/js/5.12e117c7.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[5],{319: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"},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(319),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],{320: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"},401: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(320),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.1f66b3e4.js b/assets/js/app.8ad07129.js similarity index 98% rename from assets/js/app.1f66b3e4.js rename to assets/js/app.8ad07129.js index bff605ffe..a045404ab 100644 --- a/assets/js/app.1f66b3e4.js +++ b/assets/js/app.8ad07129.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" +