OpenCore-Legacy-Patcher/assets/js/16.cc8d6b95.js

(window.webpackJsonp=window.webpackJsonp||[]).push([[16],{282:function(e,o,t){e.exports=t.p+"assets/img/mountefi.f1bedccd.png"},327:function(e,o,t){e.exports=t.p+"assets/img/icnspack-folder.6cad9bdf.png"},328:function(e,o,t){e.exports=t.p+"assets/img/icnspack-done.9f84140f.png"},329:function(e,o,t){e.exports=t.p+"assets/img/graphics-download.7cc2642f.png"},330:function(e,o,t){e.exports=t.p+"assets/img/graphics-open.a92a70e2.png"},331:function(e,o,t){e.exports=t.p+"assets/img/icon-SL.e5bfa343.png"},332:function(e,o,t){e.exports=t.p+"assets/img/background-moved.bbb8b0fd.png"},333:function(e,o,t){e.exports=t.p+"assets/img/mac-icns-drive.4aaed978.png"},397:function(e,o,t){"use strict";t.r(o);var n=t(10),a=Object(n.a)({},(function(){var e=this,o=e._self._c;return o("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[o("h1",{attrs:{id:"creating-custom-icons-for-opencore-and-mac-boot-picker"}},[o("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(" "),o("p",[e._v("For users who want to customize their setup to be more personal, OpenCore does allow for custom icons and images in the boot picker.")]),e._v(" "),o("ul",[o("li",[o("a",{attrs:{href:"#custom-opencore-icons"}},[e._v("Custom OpenCore icons")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#custom-mac-boot-picker-icons"}},[e._v("Custom Mac Boot Picker icons")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#installing-updated-icons"}},[e._v("Installing updated icons")])])]),e._v(" "),o("h1",{attrs:{id:"custom-opencore-icons"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#custom-opencore-icons"}},[e._v("#")]),e._v(" Custom OpenCore icons")]),e._v(" "),o("p",[e._v("To generate custom OpenCore icons, you'll need the following:")]),e._v(" "),o("ul",[o("li",[e._v("Images in PNG format")]),e._v(" "),o("li",[e._v("Each image, with the following res:\n"),o("ul",[o("li",[e._v("Cursor — Mouse cursor (mandatory, up to 144x144).")]),e._v(" "),o("li",[e._v("Selected — Selected item (mandatory, 144x144).")]),e._v(" "),o("li",[e._v("Selector — Selecting item (mandatory, up to 144x40).")]),e._v(" "),o("li",[e._v("Left — Scrolling left (mandatory, 40x40).")]),e._v(" "),o("li",[e._v("Right — Scrolling right (mandatory, 40x40).")]),e._v(" "),o("li",[e._v("HardDrive — Generic OS (mandatory, 128x128).")]),e._v(" "),o("li",[e._v("Background — Centred background image. (Recommended max size 1920x1080)")]),e._v(" "),o("li",[e._v("Apple — Apple OS (128x128).")]),e._v(" "),o("li",[e._v("AppleRecv — Apple Recovery OS (128x128).")]),e._v(" "),o("li",[e._v("AppleTM — Apple Time Machine (128x128).")]),e._v(" "),o("li",[e._v("Windows — Windows (128x128).")]),e._v(" "),o("li",[e._v("Other — Custom entry (see "),o("a",{attrs:{href:"https://dortania.github.io/docs/latest/Configuration.html",target:"_blank",rel:"noopener noreferrer"}},[e._v("Entries"),o("OutboundLink")],1),e._v(", 128x128).")]),e._v(" "),o("li",[e._v("ResetNVRAM — Reset NVRAM system action or tool (128x128).")]),e._v(" "),o("li",[e._v("Shell — Entry with UEFI Shell name for e.g. OpenShell (128x128).")]),e._v(" "),o("li",[e._v("Tool — Any other tool (128x128).")])])])]),e._v(" "),o("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(" "),o("p",[e._v("Once you have a custom image you want to use(for example, as a background), download the "),o("a",{attrs:{href:"https://github.com/acidanthera/OpenCorePkg/releases",target:"_blank",rel:"noopener noreferrer"}},[e._v("latest release of OpenCorePkg"),o("OutboundLink")],1),e._v(" and enter the "),o("code",[e._v("Utilities/icnspack/")]),e._v(" folder:")]),e._v(" "),o("p",[o("img",{attrs:{src:t(327),alt:""}})]),e._v(" "),o("p",[e._v("Now "),o("code",[e._v("cd")]),e._v(" to this folder in terminal and run the following:")]),e._v(" "),o("div",{staticClass:"language-sh extra-class"},[o("pre",{pre:!0,attrs:{class:"language-sh"}},[o("code",[e._v("./icnspack Background.icns "),o("span",{pre:!0,attrs:{class:"token operator"}},[e._v("<")]),e._v("insert_x1_image"),o("span",{pre:!0,attrs:{class:"token operator"}},[e._v(">")]),e._v(" "),o("span",{pre:!0,attrs:{class:"token operator"}},[e._v("<")]),e._v("insert_x2_image"),o("span",{pre:!0,attrs:{class:"token operator"}},[e._v(">")]),e._v("\n")])])]),o("p",[e._v("Once done, you'll see your custom icon generated in "),o("code",[e._v("icnspack")]),e._v("'s folder:")]),e._v(" "),o("p",[o("img",{attrs:{src:t(328),alt:""}})]),e._v(" "),o("h1",{attrs:{id:"custom-mac-boot-picker-icons"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#custom-mac-boot-picker-icons"}},[e._v("#")]),e._v(" Custom Mac Boot Picker icons")]),e._v(" "),o("p",[e._v("Custom boot picker icons are much more complicated on Legacy Macs. On late 2013+ Macs, the "),o("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(" "),o("p",[e._v("To generate legacy icons, you'll need the following:")]),e._v(" "),o("ul",[o("li",[e._v("A machine running macOS 10.4 through 10.11")]),e._v(" "),o("li",[e._v("Icon Composer.app (Requires Apple Developer Account for official download)\n"),o("ul",[o("li",[e._v("Users without a developer account can find mirrors here:\n"),o("ul",[o("li",[o("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"),o("OutboundLink")],1)]),e._v(" "),o("li",[o("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"),o("OutboundLink")],1)])])])])]),e._v(" "),o("li",[e._v("PNG Image you wish to convert")])]),e._v(" "),o("p",[e._v("Head to "),o("a",{attrs:{href:"https://developer.apple.com/download/more/",target:"_blank",rel:"noopener noreferrer"}},[e._v("developer.apple's More Downloads page"),o("OutboundLink")],1),e._v(" and search for "),o("code",[e._v("Graphics Tools")]),e._v(" that is supported by your OS(note for 10.6 and older, the app is hidden inside "),o("code",[e._v("Developer Tools")]),e._v("):")]),e._v(" "),o("p",[o("img",{attrs:{src:t(329),alt:""}})]),e._v(" "),o("p",[e._v("Once downloaded, open the disk image and you'll find Icon Composer.app:")]),e._v(" "),o("p",[o("img",{attrs:{src:t(330),alt:"Graphics Open"}})]),e._v(" "),o("p",[e._v("Now run the app and simply drag the images to each section as so:")]),e._v(" "),o("p",[o("img",{attrs:{src:t(331),alt:""}})]),e._v(" "),o("p",[e._v("Now save and export the new icns file.")]),e._v(" "),o("h1",{attrs:{id:"installing-updated-icons"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#installing-updated-icons"}},[e._v("#")]),e._v(" Installing updated icons")]),e._v(" "),o("p",[e._v('To install, please ensure that Vault was disabled when you built OpenCore. If you\'re unsure, simply rebuild OpenCore with the Patcher setting "Vault" set to false.')]),e._v(" "),o("ul",[o("li",[o("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(" "),o("p",[e._v("Now that you've verified that you can edit OpenCore safely, you'll need to mount the drive that OpenCore is stored on. To do this, download "),o("a",{attrs:{href:"https://github.com/corpnewt/MountEFI",target:"_blank",rel:"noopener noreferrer"}},[e._v("MountEFI"),o("OutboundLink")],1),e._v(" and run it:")]),e._v(" "),o("p",[o("img",{attrs:{src:t(282),alt:""}})]),e._v(" "),o("p",[e._v("Select the drive you installed OpenCore to and mount it.")]),e._v(" "),o("ul",[o("li",[o("a",{attrs:{href:"#updating-opencore-icons"}},[e._v("Updating OpenCore icons")])]),e._v(" "),o("li",[o("a",{attrs:{href:"#updating-mac-boot-picker-icons"}},[e._v("Updating Mac Boot Picker icons")])])]),e._v(" "),o("h3",{attrs:{id:"updating-opencore-icons"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#updating-opencore-icons"}},[e._v("#")]),e._v(" Updating OpenCore icons")]),e._v(" "),o("p",[e._v("Head to "),o("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 "),o("code",[e._v("Modern")]),e._v(" to it:")]),e._v(" "),o("p",[o("img",{attrs:{src:t(332),alt:""}})]),e._v(" "),o("p",[e._v("Now reboot and you should see your updated icon(s)!")]),e._v(" "),o("h3",{attrs:{id:"updating-mac-boot-picker-icons"}},[o("a",{staticClass:"header-anchor",attrs:{href:"#updating-mac-boot-picker-icons"}},[e._v("#")]),e._v(" Updating Mac Boot Picker icons")]),e._v(" "),o("p",[e._v("Updating the Mac Boot Picker icons is actually quite simple. On the root of your drive, simply drop the icon into the root of the drive with the name "),o("code",[e._v(".VolumeIcon.icns")])]),e._v(" "),o("p",[o("img",{attrs:{src:t(333),alt:""}})]),e._v(" "),o("p",[e._v("Now reboot and you'll see the new icon!")])])}),[],!1,null,null,null);o.default=a.exports}}]);