From 61e82fa5797019299fac9fdf70e1472de4a870a1 Mon Sep 17 00:00:00 2001 From: khronokernel <48863253+khronokernel@users.noreply.github.com> Date: Thu, 27 May 2021 16:14:46 +0000 Subject: [PATCH] =?UTF-8?q?Deploying=20to=20gh-pages=20from=20=20@=203e5ad?= =?UTF-8?q?e8047c652978d5eedfa9c7befa352ecf160=20=F0=9F=9A=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 404.html | 6 +++--- ACCEL.html | 8 ++++---- BENIFITS.html | 6 +++--- BOOT.html | 6 +++--- BUILD.html | 6 +++--- CLI.html | 8 ++++---- DEBUG.html | 10 +++++----- DONATE.html | 6 +++--- HOW.html | 6 +++--- ICNS.html | 8 ++++---- INSTALLER.html | 8 ++++---- LICENSE.html | 8 ++++---- MODELS.html | 8 ++++---- PATCHEXPLAIN.html | 8 ++++---- POST-INSTALL.html | 6 +++--- START.html | 8 ++++---- TERMS.html | 6 +++--- TESTED.html | 6 +++--- TROUBLESHOOTING.html | 8 ++++---- UNINSTALL.html | 10 +++++----- UPDATE.html | 10 +++++----- WINDOWS.html | 8 ++++---- assets/js/14.1e7135f7.js | 1 + assets/js/14.2d88c26a.js | 1 - assets/js/{26.c88f1bf6.js => 26.8fb73cee.js} | 2 +- assets/js/{app.95c3b23f.js => app.c3ea73c1.js} | 4 ++-- index.html | 6 +++--- 27 files changed, 89 insertions(+), 89 deletions(-) create mode 100644 assets/js/14.1e7135f7.js delete mode 100644 assets/js/14.2d88c26a.js rename assets/js/{26.c88f1bf6.js => 26.8fb73cee.js} (68%) rename assets/js/{app.95c3b23f.js => app.c3ea73c1.js} (93%) diff --git a/404.html b/404.html index 10b8c2519..b8db61d35 100644 --- a/404.html +++ b/404.html @@ -11,13 +11,13 @@ - + -

404

Looks like we've got some broken links.
+ - + diff --git a/ACCEL.html b/ACCEL.html index 52ac896bb..c5d3f9419 100644 --- a/ACCEL.html +++ b/ACCEL.html @@ -11,7 +11,7 @@ - + @@ -19,8 +19,8 @@ GitHub (opens new window)

# Working Around Legacy Acceleration Issues

The below page is for users experiencing issues with their overall usage of macOS Big Sur and the Legacy Graphics Acceleration patches. Note that the following GPUs currently do not have acceleration support in Big Sur:

  • AMD/ATI TeraScale 2 - HD5/6000 series
  • Intel 3rd and 4th Gen - GMA series

# Downloading older non-Metal Apps

Many Apple apps now have direct reliance on Metal for proper functioning, however legacy builds of these apps still do work in Big Sur. See below for archive of many apps such as Pages, iMovie, GarageBand.

Note: This archive assumes that you own these copies of these apps through the Mac App Store, Dortania does not condone piracy

# Unable to run Zoom

Currently Zoom relies partially on Metal and so needs a small binary patch. Dosdude1 has provided a nice script for this:

# Unable to grant special permissions to apps (ie. Camera Access to Zoom)

Due to the usage of amfi_get_out_of_my_way=1, macOS will fail to prompt users for special permissions upon application start as well as omit the entires in System Preferences. To work around this, we recommend users install tccplus (opens new window) to manage permissions.

# Keyboard Backlight broken

Due to forcing hidd into spinning up with the fallback mode enabled, this can break the OS's recognition of backlight keyboards. Thankfully the drivers themselves still do operate so applications such as LabTick (opens new window) are able to set the brightness manually.

# Photos and Maps Apps Heavily Distorted

Due to the Metal Backend, the enhanced color output of these apps seems to heavily break overall UI usage. To work around this, users reported (opens new window) forcing the color output of their monitor from Billions to Millions of colors helped greatly. Apps easily allowing this customization are SwitchResX (opens new window), ResXreme (opens new window) and EasyRes (opens new window).

# Cannot press "Done" when editing a Sidebar Widget

To work around this, simply press Tab to hover over and press spacebar to simulate a click.

# Wake from sleep heavily distorted on AMD/ATI in macOS 11.3 and newer

Unfortunately a very well known issue the community is investigating, current known solution is to simply downgrade to 11.2.3 or older until a proper fix can be found.

In the event Apple removes 11.2.3 from their catalogue, we've provided a mirror below:

# Unable to achieve GPU Acceleration on 2011 15" and 17" MacBook Pros

Currently OpenCore Legacy Patcher doesn't have support for the TeraScale 2 series dGPUs found in the 15" and 17" models. Currently the best way to achieve graphics acceleration is to simply disable the dGPU and force the iGPU always.

The best way to achieve this is to boot Recovery (or Single User Mode if the dGPU refuses to function at all) and run the following command:

nvram fa4ce28d-b62f-4c99-9cc3-6815686e30f9:gpu-power-prefs=%01%00%00%00
-

This will disable the dGPU and allow graphics acceleration in Big Sur. Note that external display outputs are directly routed to the dGPU and therefore can no longer be used. Solutions such as a DisplayLink Adapters (opens new window) can work around this limitation.

+ (opens new window)

# Working Around Legacy Acceleration Issues

The below page is for users experiencing issues with their overall usage of macOS Big Sur and the Legacy Graphics Acceleration patches. Note that the following GPUs currently do not have acceleration support in Big Sur:

  • AMD/ATI TeraScale 2 - HD5/6000 series
  • Intel 3rd and 4th Gen - GMA series

# Downloading older non-Metal Apps

Many Apple apps now have direct reliance on Metal for proper functioning, however legacy builds of these apps still do work in Big Sur. See below for archive of many apps such as Pages, iMovie, GarageBand.

Note: This archive assumes that you own these copies of these apps through the Mac App Store, Dortania does not condone piracy

# Unable to run Zoom

Currently Zoom relies partially on Metal and so needs a small binary patch. Dosdude1 has provided a nice script for this:

# Unable to grant special permissions to apps (ie. Camera Access to Zoom)

Due to the usage of amfi_get_out_of_my_way=1, macOS will fail to prompt users for special permissions upon application start as well as omit the entires in System Preferences. To work around this, we recommend users install tccplus (opens new window) to manage permissions.

# Keyboard Backlight broken

Due to forcing hidd into spinning up with the fallback mode enabled, this can break the OS's recognition of backlight keyboards. Thankfully the drivers themselves still do operate so applications such as LabTick (opens new window) are able to set the brightness manually.

# Photos and Maps Apps Heavily Distorted

Due to the Metal Backend, the enhanced color output of these apps seems to heavily break overall UI usage. To work around this, users reported (opens new window) forcing the color output of their monitor from Billions to Millions of colors helped greatly. Apps easily allowing this customization are SwitchResX (opens new window), ResXreme (opens new window) and EasyRes (opens new window).

# Cannot press "Done" when editing a Sidebar Widget

To work around this, simply press Tab to hover over and press spacebar to simulate a click.

# Wake from sleep heavily distorted on AMD/ATI in macOS 11.3 and newer

Unfortunately a very well known issue the community is investigating, current known solution is to simply downgrade to 11.2.3 or older until a proper fix can be found.

In the event Apple removes 11.2.3 from their catalogue, we've provided a mirror below:

# Unable to achieve GPU Acceleration on 2011 15" and 17" MacBook Pros

Currently OpenCore Legacy Patcher doesn't have support for the TeraScale 2 series dGPUs found in the 15" and 17" models. Currently the best way to achieve graphics acceleration is to simply disable the dGPU and force the iGPU always.

The best way to achieve this is to boot Recovery (or Single User Mode if the dGPU refuses to function at all) and run the following command:

nvram fa4ce28d-b62f-4c99-9cc3-6815686e30f9:gpu-power-prefs=%01%00%00%00
+

This will disable the dGPU and allow graphics acceleration in Big Sur. Note that external display outputs are directly routed to the dGPU and therefore can no longer be used. Solutions such as a DisplayLink Adapters (opens new window) can work around this limitation.

⟵ ⟶

- + diff --git a/BENIFITS.html b/BENIFITS.html index de0b0e006..486740e20 100644 --- a/BENIFITS.html +++ b/BENIFITS.html @@ -11,7 +11,7 @@ - + @@ -19,7 +19,7 @@ GitHub (opens new window)

# Benefits and Drawbacks between OpenCore Legacy Patcher and other patchers

With OpenCore Legacy Patcher we recommend users go through the below table to understand what the benefits and drawbacks are compared to other patchers. There are positive and negatives to each and we feel transparency is most important when patching another users machine. There should be no grey areas where users may be mislead.

Features OpenCore Legacy Patcher (opens new window) Patched Sur (opens new window)
Over The Air Updates Native System Preferences, additionally supports Deltas (~2GB) for Metal GPUs Inside Patcher Sur app (~12GB), only available when InstallAssistants release. InstallAssistants generally available same day as System Preference updates, however developer betas will lag behind by 1 day compared to OTAs
FileVault Supported on Metal GPUs Not supported
System Integrity Protection Fully enabled on Metal GPUs Disabled for early 2013 and older during the patching process and first boot afterwards, otherwise enabled
APFS Snapshots Fully enabled Disabled
User facing TUI interface SwiftUI interface, more user friendly
Supported OSes 10.7-11 10.15-11
Firmware Patching None required Required for models without native APFS support
BootCamp Switching Requires EFI Conversion for Start Disk support, otherwise still supported Native
Legacy GPU Acceleration In active development, see Acceleration Progress Tracker: Link (opens new window) Currently not researching
El Capitan-era Wifi cards Supported Not supported
WPA Wireless Support Supported Minority may experience issues on early 2013 and older Models
Personal Hotspot Support Native Often requires extra steps to achieve on early 2013 and older Models
HEVC/H.265 Support for Mac Pros and iMacs with Polaris+ GPUs Supported Not supported
Big Sur-styled Boot Picker Available, though as a shim to the original boot picker Not available
Hibernation Support Supports 3rd party SATA SSDs on 2011 and older models in addition to stock drives Only supports stock drives on 2011 and older models
Sidecar Support Supports any Mac with Metal Intel iGPU, artifacting way exhibited on high movement screen content Not supported at all

+ (opens new window)

# Benefits and Drawbacks between OpenCore Legacy Patcher and other patchers

With OpenCore Legacy Patcher we recommend users go through the below table to understand what the benefits and drawbacks are compared to other patchers. There are positive and negatives to each and we feel transparency is most important when patching another users machine. There should be no grey areas where users may be mislead.

Features OpenCore Legacy Patcher (opens new window) Patched Sur (opens new window)
Over The Air Updates Native System Preferences, additionally supports Deltas (~2GB) for Metal GPUs Inside Patcher Sur app (~12GB), only available when InstallAssistants release. InstallAssistants generally available same day as System Preference updates, however developer betas will lag behind by 1 day compared to OTAs
FileVault Supported on Metal GPUs Not supported
System Integrity Protection Fully enabled on Metal GPUs Disabled for early 2013 and older during the patching process and first boot afterwards, otherwise enabled
APFS Snapshots Fully enabled Disabled
User facing TUI interface SwiftUI interface, more user friendly
Supported OSes 10.7-11 10.15-11
Firmware Patching None required Required for models without native APFS support
BootCamp Switching Requires EFI Conversion for Start Disk support, otherwise still supported Native
Legacy GPU Acceleration In active development, see Acceleration Progress Tracker: Link (opens new window) Currently not researching
El Capitan-era Wifi cards Supported Not supported
WPA Wireless Support Supported Minority may experience issues on early 2013 and older Models
Personal Hotspot Support Native Often requires extra steps to achieve on early 2013 and older Models
HEVC/H.265 Support for Mac Pros and iMacs with Polaris+ GPUs Supported Not supported
Big Sur-styled Boot Picker Available, though as a shim to the original boot picker Not available
Hibernation Support Supports 3rd party SATA SSDs on 2011 and older models in addition to stock drives Only supports stock drives on 2011 and older models
Sidecar Support Supports any Mac with Metal Intel iGPU, artifacting way exhibited on high movement screen content Not supported at all

⟵ ⟶

- + diff --git a/BOOT.html b/BOOT.html index 30694fea9..3a0f7c8f5 100644 --- a/BOOT.html +++ b/BOOT.html @@ -11,7 +11,7 @@ - + @@ -19,7 +19,7 @@ GitHub (opens new window)

# Booting OpenCore and macOS

Now we finally get to boot OpenCore!

Reboot machine while holding Option to select the EFI Boot entry with the OpenCore icon (holding the Control key will make this the default boot entry):

  • This will be the Mac Boot Picker

Now that you've loaded OpenCore, now select Install macOS!:

  • This will be the OpenCore Picker

After plenty of verbose booting, you will reach the installer screen! From there it's just like any normal macOS install. For an example of how the boot process looks, see the following video:

# Once installed and booting, head to Post-Installation

+ (opens new window)

# Booting OpenCore and macOS

Now we finally get to boot OpenCore!

Reboot machine while holding Option to select the EFI Boot entry with the OpenCore icon (holding the Control key will make this the default boot entry):

  • This will be the Mac Boot Picker

Now that you've loaded OpenCore, now select Install macOS!:

  • This will be the OpenCore Picker

After plenty of verbose booting, you will reach the installer screen! From there it's just like any normal macOS install. For an example of how the boot process looks, see the following video:

# Once installed and booting, head to Post-Installation

⟵ ⟶

- + diff --git a/BUILD.html b/BUILD.html index fe43e3648..33911ff05 100644 --- a/BUILD.html +++ b/BUILD.html @@ -11,7 +11,7 @@ - + @@ -19,7 +19,7 @@ GitHub (opens new window)

# Building and installing OpenCore

Now that we have a macOS installer, lets now build our OpenCore configuration!

First Download the latest release:

Next, run the OpenCore-Patcher.app:

From here you have a couple important options:

  • Build OpenCore
  • Install OpenCore to USB/internal drive
  • Change Model
  • Patcher Settings

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"

Now lets enter "Build OpenCore":

The process should be quite quick to build, once finished you'll be plopped back to the main menu.

Next lets run Install OpenCore to USB/internal drive:

Select Drive Select EFI/FAT32 Partition
  • 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

# Once finished, head to Booting OpenCore and macOS

+ (opens new window)

# Building and installing OpenCore

Now that we have a macOS installer, lets now build our OpenCore configuration!

First Download the latest release:

Next, run the OpenCore-Patcher.app:

From here you have a couple important options:

  • Build OpenCore
  • Install OpenCore to USB/internal drive
  • Change Model
  • Patcher Settings

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"

Now lets enter "Build OpenCore":

The process should be quite quick to build, once finished you'll be plopped back to the main menu.

Next lets run Install OpenCore to USB/internal drive:

Select Drive Select EFI/FAT32 Partition
  • 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

# Once finished, head to Booting OpenCore and macOS

⟵ ⟶

- + diff --git a/CLI.html b/CLI.html index a917ec497..7160ca492 100644 --- a/CLI.html +++ b/CLI.html @@ -11,7 +11,7 @@ - + @@ -19,17 +19,17 @@ GitHub (opens new window)

# Command Line Args

With OpenCore Legacy Patcher, we include an extra binary called OCLP-CLI (opens new window). The purpose of this binary is to easily run our OpenCore build process for other programs to hook onto. Below is documentation on currently supported arguments.

# Build Arguments

⟵

- + diff --git a/DEBUG.html b/DEBUG.html index 67c0c682b..000d121a4 100644 --- a/DEBUG.html +++ b/DEBUG.html @@ -11,7 +11,7 @@ - + @@ -19,16 +19,16 @@ GitHub (opens new window)

# How to debug with OpenCore

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 file issues with us (opens new window)

# Debugging yourself

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:

  • "Enable Verbose Mode"
  • "Enable OpenCore DEBUG"
  • "Enable Kext DEBUG"

When you've enabled these 3 options, rebuild OpenCore and install to your drive. This will provide much greater debug information as well as write logs to the EFI Partition.

# Obtaining OpenCore logs from disk

With "Enable OpenCore DEBUG" set, every boot there will be a .txt file generated in your disk. To grab these logs, download and run MountEFI (opens new window):

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

# Obtaining Kernel logs from macOS

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:

sudo dmesg > ~/Desktop/DMESG.txt
-

From there, you'll have a log on your desktop.

# Filing an issue with us

Now that you have proper logs, you can now file issues with us (opens new window). Reminder we want the following info:

  • Model patching for (ie. MacBookPro10,1)
  • Target OS (ie. macOS 11.2.3)
  • Host OS (ie. macOS 10.15.7)
  • Upload of your OpenCore Build Folder
  • Upload of your OpenCore log (if applicable)
  • Upload of your Kernel log (if applicable)

Additionally, please search whether the issue has been reported before. This avoids having duplicate issues.

+ (opens new window)

# How to debug with OpenCore

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 file issues with us (opens new window)

# Debugging yourself

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:

  • "Enable Verbose Mode"
  • "Enable OpenCore DEBUG"
  • "Enable Kext DEBUG"

When you've enabled these 3 options, rebuild OpenCore and install to your drive. This will provide much greater debug information as well as write logs to the EFI Partition.

# Obtaining OpenCore logs from disk

With "Enable OpenCore DEBUG" set, every boot there will be a .txt file generated in your disk. To grab these logs, download and run MountEFI (opens new window):

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

# Obtaining Kernel logs from macOS

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:

sudo dmesg > ~/Desktop/DMESG.txt
+

From there, you'll have a log on your desktop.

# Filing an issue with us

Now that you have proper logs, you can now file issues with us (opens new window). Reminder we want the following info:

  • Model patching for (ie. MacBookPro10,1)
  • Target OS (ie. macOS 11.2.3)
  • Host OS (ie. macOS 10.15.7)
  • Upload of your OpenCore Build Folder
  • Upload of your OpenCore log (if applicable)
  • Upload of your Kernel log (if applicable)

Additionally, please search whether the issue has been reported before. This avoids having duplicate issues.

⟵ - Updating OpenCore and Co. + Updating OpenCore and Co ⟶

- + diff --git a/DONATE.html b/DONATE.html index 2044d2eeb..7a8c5fd63 100644 --- a/DONATE.html +++ b/DONATE.html @@ -11,7 +11,7 @@ - + @@ -19,7 +19,7 @@ GitHub (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 sections of help we'd appreciate:

- + diff --git a/HOW.html b/HOW.html index b11b1bdaa..217b787a0 100644 --- a/HOW.html +++ b/HOW.html @@ -11,7 +11,7 @@ - + @@ -19,7 +19,7 @@ GitHub (opens new window)

# Boot Process with OpenCore Legacy Patcher

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 OpenCorePkg (opens new window), our back-end and what makes this patcher so powerful.

# Boot Process with OpenCore

To understand a bit more of how OpenCore is able revive older Macs in such a native-like way, we need to go over how OpenCore works with your Mac:

+ (opens new window)

# Boot Process with OpenCore Legacy Patcher

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 OpenCorePkg (opens new window), our back-end and what makes this patcher so powerful.

# Boot Process with OpenCore

To understand a bit more of how OpenCore is able revive older Macs in such a native-like way, we need to go over how OpenCore works with your Mac:

⟵ ⟶

- + diff --git a/ICNS.html b/ICNS.html index 2b28c287a..a9dfda741 100644 --- a/ICNS.html +++ b/ICNS.html @@ -11,7 +11,7 @@ - + @@ -19,11 +19,11 @@ GitHub (opens new window)

# Creating custom icons for OpenCore and Mac Boot Picker

For users who want to customize your setup to be more personal, OpenCore does allow for custom icons and images in the boot picker.

# Custom OpenCore icons

To generate custom OpenCore icons, you'll need the following:

  • PNG Image you wish to convert

    • Head to developer.apple's More Downloads page (opens new window) and search for Graphics Tools that is supported by your OS(note for 10.6 and older, the app is hidden inside Developer Tools):

    Once downloaded, open the disk image and you'll find Icon Composer.app:

    Graphics Open

    Now run the app and simply drag the images to each section as so:

    Now save and export the new icns

    # Installing updated icons

    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.

    • Warning: 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.

    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 MountEFI (opens new window) and run it:

    Select the drive you installed OpenCore to and mount it.

    # Updating OpenCore icons

    Head to EFI/OC/Resources/Image/ 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 Modern to it:

    Now reboot and you should see your updated icon(s)!

    # Updating Mac Boot Picker icons

    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 .VolumeIcon.icns

    Now reboot and you'll see the new icon!

    ⟵ ⟶

    - + diff --git a/INSTALLER.html b/INSTALLER.html index 112edd5df..0e4cf35f0 100644 --- a/INSTALLER.html +++ b/INSTALLER.html @@ -11,7 +11,7 @@ - + @@ -19,10 +19,10 @@ GitHub (opens new window)

    # Download and build macOS Installers

    This doc is centered around downloading and writing the macOS installer to a USB. If you're already familiar with how to do this, you can skip.

    • Note: 16GB+ USB will be required for the installer

    # Downloading

    The simplest way to download macOS installs would be to use installinstallmacos:

    [ ! -d ~/macOS-installer/ ] && mkdir ~/macOS-installer; cd ~/macOS-installer; [ ! -f ~/macOS-installer/installinstallmacos.py ] && curl -O https://raw.githubusercontent.com/munki/macadmin-scripts/main/installinstallmacos.py; sudo python installinstallmacos.py
+     (opens new window)    
     
    # Download and build macOS Installers
      
    This doc is centered around downloading and writing the macOS installer to a USB. If you're already familiar with how to do this, you can skip.
     
    • Note: 16GB+ USB will be required for the installer
     
    # Downloading
     
    The simplest way to download macOS installs would be to use installinstallmacos:
     
    [ ! -d ~/macOS-installer/ ] && mkdir ~/macOS-installer; cd ~/macOS-installer; [ ! -f ~/macOS-installer/installinstallmacos.py ] && curl -O https://raw.githubusercontent.com/munki/macadmin-scripts/main/installinstallmacos.py; sudo python installinstallmacos.py
 
    • Note: On El Capitan (10.11) and older, you'll need to specify a catalog at the end of the command:
     
    --catalogurl https://swscan.apple.com/content/catalogs/others/index-11-10.15-10.14-10.13-10.12-10.11-10.10-10.9-mountainlion-lion-snowleopard-leopard.merged-1.sucatalog
 
     
    As you can see, we get a nice list of macOS installers. If you need a particular versions of macOS, you can select it by typing the number next to it. For this example we'll choose 10:
     
     
    This is going to take a while as we're downloading the entire 12GB+ macOS installer.
     
    Once finished, you'll find in your ~/macOS-Installer/ folder a DMG containing the macOS Installer, called Install_macOS_11.1-20C69.dmg for example. Mount it and you'll find the installer application.
     
    • Note: We recommend to move the Install macOS.app into the /Applications folder, as we'll be executing commands from there.
      •  
    • Note 2: Running Cmd+Shift+G in Finder will allow you to easily jump to ~/macOS-installer
     
     
     
    # Building
     
    Now we'll be formatting the USB to prep for both the macOS installer and OpenCore. We'll want to use macOS Extended (HFS+) with a GUID partition map(Using GUID is important for the patcher). This will create two partitions: the main MyVolume and a second called EFI which is used as a boot partition where your Mac's firmware will check for boot files. EFI partitions will be hidden by default, so don't worry if you don't immediately see them.
     
    • Note: By default, Disk Utility only shows partitions – press Cmd/Win+2 to show all devices (alternatively you can press the View button)
     
    Formatting the USB
     
    Next run the createinstallmedia command provided by Apple (opens new window). Note that the command is made for USB's formatted with the name MyVolume:
     
    sudo /Applications/Install\ macOS\ Big\ Sur.app/Contents/Resources/createinstallmedia --volume /Volumes/MyVolume
-
    • Note: You can also replace the createinstallmedia path with that of where your installer's located (same idea with the drive name).
     
     
    # Once finished, head to Building and installing OpenCore
      
    
+
    • Note: You can also replace the createinstallmedia path with that of where your installer's located (same idea with the drive name).

    # Once finished, head to Building and installing OpenCore

    ⟵ ⟶

    - + diff --git a/LICENSE.html b/LICENSE.html index a832dd33c..8238f8bec 100644 --- a/LICENSE.html +++ b/LICENSE.html @@ -11,7 +11,7 @@ - + @@ -19,10 +19,10 @@ GitHub (opens new window)

    # OpenCore Legacy Patcher Licence

    This patcher is made of multiple external applications from different people and organizations. See each program for their licensing:

    Remaining files within OpenCore Legacy Patcher are copyrighted 2020-2021 Mykola Grymalyuk & Dhinak G. For integration into other projects, please request written permission.

    ⟵ ⟶

    - + diff --git a/MODELS.html b/MODELS.html index e1b8713e1..2b84ccaf2 100644 --- a/MODELS.html +++ b/MODELS.html @@ -11,7 +11,7 @@ - + @@ -19,8 +19,8 @@ GitHub (opens new window)

    # Supported Models

    Any hardware supporting SSE4.1 CPU and 64-Bit firmware work on this patcher. To check your hardware model, run the below command on the applicable machine in terminal:

    system_profiler SPHardwareDataType | grep 'Model Identifier'
-

    The below table will list all supported and unsupported functions of the patcher currently:

    Regarding OS support, see below:

    Support Entry Supported OSes Description Comment
    HostOS macOS 10.9 - macOS 11 Refers to OSes where running OpenCore-Patcher.app are supported Supports 10.7+ if Python 3.9 or higher (opens new window) is manually installed, simply run the OpenCore-Patcher.command located in the repo
    TargetOS macOS 11 Refers to OSes that can be patched to run with OpenCore May support 10.4 and newer (in a potentially broken state). No support provided.

    # MacBook

    SMBIOS Year Supported Comment
    MacBook1,1 Mid-2006 NO 32-Bit CPU limitation
    MacBook2,1 Late 2006 32-Bit Firmware limitation
    MacBook3,1 Late 2007
    MacBook4,1 Early 2008 YES - No GPU Acceleration in Mavericks and newer
    - No Keyboard and Trackpad
    - No USB
    MacBook5,1 Late 2008 - GPU Acceleration in Public Beta, see current issues (#108 (opens new window))
    MacBook5,2 Early 2009 - GPU Acceleration in Public Beta, see current issues (#108 (opens new window))
    - Trackpad is recognized as mouse
    - Brightness control partially supported
    MacBook6,1 Late 2009 - GPU Acceleration in Public Beta, see current issues (#108 (opens new window))
    MacBook7,1 Mid-2010

    # MacBook Air

    SMBIOS Year Supported Comment
    MacBookAir1,1 Early 2008 NO Requires SSE4.1 CPU
    MacBookAir2,1 Late 2008 YES GPU Acceleration in Public Beta, see current issues (#108 (opens new window))
    MacBookAir3,1 Late 2010
    MacBookAir3,2
    MacBookAir4,1 Mid-2011
    MacBookAir4,2
    MacBookAir5,1 Mid-2012 Everything is supported
    MacBookAir5,2

    # MacBook Pro

    SMBIOS Year Supported Comment
    MacBookPro1,1 Early 2006 NO 32-Bit CPU limitation
    MacBookPro1,2
    MacBookPro2,1 Late 2006 32-Bit Firmware limitation
    MacBookPro2,2 Late 2006
    MacBookPro3,1 Mid-2007 Requires SSE4.1 CPU
    MacBookPro4,1 Early 2008 YES GPU Acceleration in Public Beta, see current issues (#108 (opens new window))
    MacBookPro5,1 Late 2008
    MacBookPro5,2 Early 2009
    MacBookPro5,3 Mid-2009
    MacBookPro5,4
    MacBookPro5,5
    MacBookPro6,1 Mid-2010
    MacBookPro6,2
    MacBookPro7,1
    MacBookPro8,1 Early 2011
    MacBookPro8,2
    MacBookPro8,3
    MacBookPro9,1 Mid-2012 Everything is supported
    MacBookPro9,2
    MacBookPro10,1 Mid-2012, Early 2013
    MacBookPro10,2 Late 2012, Early 2013

    # Mac mini

    SMBIOS Year Supported Comment
    Macmini1,1 Early 2006 NO 32-Bit CPU limitation
    Macmini2,1 Mid-2007 32-Bit Firmware limitation
    Macmini3,1 Early 2009 YES GPU Acceleration in Public Beta, see current issues (#108 (opens new window))
    Macmini4,1 Mid-2010
    Macmini5,1 Mid-2011
    Macmini5,2
    Macmini5,3
    Macmini6,1 Late 2012 Everything is supported
    Macmini6,2

    # iMac

    SMBIOS Year Supported Comment
    iMac4,1 Early 2006 NO 32-Bit CPU limitation
    iMac4,2 Mid-2006
    iMac5,1 Late 2006 32-Bit Firmware limitation
    iMac5,2
    iMac6,1
    iMac7,1 Mid-2007 YES - Requires an SSE4.1 CPU Upgrade (opens new window)
    - GPU Acceleration in Public Beta, see current issues (#108 (opens new window))
    - Brightness control partially supported on Nvidia GPUs, AMD unsupported
    - Stock Bluetooth 2.0 card non-functional
    iMac8,1 Early 2008 - GPU Acceleration in Public Beta, see current issues (#108 (opens new window)))
    - Brightness control partially supported on Nvidia GPUs, AMD unsupported
    iMac9,1 Early 2009
    iMac10,1 Late 2009 - GPU is socketed, recommend upgrading to Metal GPU (opens new window)
    - GPU Acceleration in Public Beta, see current issues (#108 (opens new window))
    iMac11,1
    iMac11,2 Mid-2010
    iMac11,3
    iMac12,1 Mid-2011
    iMac12,2
    iMac13,1 Late 2012 Everything is supported
    iMac13,2
    iMac13,3
    iMac14,1 Late 2013
    iMac14,2
    iMac14,3

    # Mac Pro

    SMBIOS Year Supported Comment
    MacPro1,1 Mid-2006 NO 32-Bit Firmware limitation
    MacPro2,1 Mid-2007
    MacPro3,1 Early 2008 YES - Potential boot issues with built-in USB 1.1 ports (recommend using a USB 2.0 hub or dedicated USB PCIe controller)
    - Potential boot issues with stock Bluetooth card, recommend removing to avoid kernel panics
    MacPro4,1 Early 2009 Everything is supported as long as GPU is Metal capable
    MacPro5,1 Mid-2010, Mid-2012

    # Xserve

    SMBIOS Year Supported Comment
    Xserve1,1 Mid-2006 NO 32-Bit Firmware limitation
    Xserve2,1 Early 2008 YES Everything is supported as long as GPU is Metal capable
    Xserve3,1 Early 2009

    # Once you've verified your hardware is supported, head to Download and build macOS Installers

    + (opens new window)

    # Supported Models

    Any hardware supporting SSE4.1 CPU and 64-Bit firmware work on this patcher. To check your hardware model, run the below command on the applicable machine in terminal:

    system_profiler SPHardwareDataType | grep 'Model Identifier'
+

    The below table will list all supported and unsupported functions of the patcher currently:

    Regarding OS support, see below:

    Support Entry Supported OSes Description Comment
    HostOS macOS 10.9 - macOS 11 Refers to OSes where running OpenCore-Patcher.app are supported Supports 10.7+ if Python 3.9 or higher (opens new window) is manually installed, simply run the OpenCore-Patcher.command located in the repo
    TargetOS macOS 11 Refers to OSes that can be patched to run with OpenCore May support 10.4 and newer (in a potentially broken state). No support provided.

    # MacBook

    SMBIOS Year Supported Comment
    MacBook1,1 Mid-2006 NO 32-Bit CPU limitation
    MacBook2,1 Late 2006 32-Bit Firmware limitation
    MacBook3,1 Late 2007
    MacBook4,1 Early 2008 YES - No GPU Acceleration in Mavericks and newer
    - No Keyboard and Trackpad
    - No USB
    MacBook5,1 Late 2008 - GPU Acceleration in Public Beta, see current issues (#108 (opens new window))
    MacBook5,2 Early 2009 - GPU Acceleration in Public Beta, see current issues (#108 (opens new window))
    - Trackpad is recognized as mouse
    - Brightness control partially supported
    MacBook6,1 Late 2009 - GPU Acceleration in Public Beta, see current issues (#108 (opens new window))
    MacBook7,1 Mid-2010

    # MacBook Air

    SMBIOS Year Supported Comment
    MacBookAir1,1 Early 2008 NO Requires SSE4.1 CPU
    MacBookAir2,1 Late 2008 YES GPU Acceleration in Public Beta, see current issues (#108 (opens new window))
    MacBookAir3,1 Late 2010
    MacBookAir3,2
    MacBookAir4,1 Mid-2011
    MacBookAir4,2
    MacBookAir5,1 Mid-2012 Everything is supported
    MacBookAir5,2

    # MacBook Pro

    SMBIOS Year Supported Comment
    MacBookPro1,1 Early 2006 NO 32-Bit CPU limitation
    MacBookPro1,2
    MacBookPro2,1 Late 2006 32-Bit Firmware limitation
    MacBookPro2,2 Late 2006
    MacBookPro3,1 Mid-2007 Requires SSE4.1 CPU
    MacBookPro4,1 Early 2008 YES GPU Acceleration in Public Beta, see current issues (#108 (opens new window))
    MacBookPro5,1 Late 2008
    MacBookPro5,2 Early 2009
    MacBookPro5,3 Mid-2009
    MacBookPro5,4
    MacBookPro5,5
    MacBookPro6,1 Mid-2010
    MacBookPro6,2
    MacBookPro7,1
    MacBookPro8,1 Early 2011
    MacBookPro8,2
    MacBookPro8,3
    MacBookPro9,1 Mid-2012 Everything is supported
    MacBookPro9,2
    MacBookPro10,1 Mid-2012, Early 2013
    MacBookPro10,2 Late 2012, Early 2013

    # Mac mini

    SMBIOS Year Supported Comment
    Macmini1,1 Early 2006 NO 32-Bit CPU limitation
    Macmini2,1 Mid-2007 32-Bit Firmware limitation
    Macmini3,1 Early 2009 YES GPU Acceleration in Public Beta, see current issues (#108 (opens new window))
    Macmini4,1 Mid-2010
    Macmini5,1 Mid-2011
    Macmini5,2
    Macmini5,3
    Macmini6,1 Late 2012 Everything is supported
    Macmini6,2

    # iMac

    SMBIOS Year Supported Comment
    iMac4,1 Early 2006 NO 32-Bit CPU limitation
    iMac4,2 Mid-2006
    iMac5,1 Late 2006 32-Bit Firmware limitation
    iMac5,2
    iMac6,1
    iMac7,1 Mid-2007 YES - Requires an SSE4.1 CPU Upgrade (opens new window)
    - GPU Acceleration in Public Beta, see current issues (#108 (opens new window))
    - Brightness control partially supported on Nvidia GPUs, AMD unsupported
    - Stock Bluetooth 2.0 card non-functional
    iMac8,1 Early 2008 - GPU Acceleration in Public Beta, see current issues (#108 (opens new window)))
    - Brightness control partially supported on Nvidia GPUs, AMD unsupported
    iMac9,1 Early 2009
    iMac10,1 Late 2009 - GPU is socketed, recommend upgrading to Metal GPU (opens new window)
    - GPU Acceleration in Public Beta, see current issues (#108 (opens new window))
    iMac11,1
    iMac11,2 Mid-2010
    iMac11,3
    iMac12,1 Mid-2011
    iMac12,2
    iMac13,1 Late 2012 Everything is supported
    iMac13,2
    iMac13,3
    iMac14,1 Late 2013
    iMac14,2
    iMac14,3

    # Mac Pro

    SMBIOS Year Supported Comment
    MacPro1,1 Mid-2006 NO 32-Bit Firmware limitation
    MacPro2,1 Mid-2007
    MacPro3,1 Early 2008 YES - Potential boot issues with built-in USB 1.1 ports (recommend using a USB 2.0 hub or dedicated USB PCIe controller)
    - Potential boot issues with stock Bluetooth card, recommend removing to avoid kernel panics
    MacPro4,1 Early 2009 Everything is supported as long as GPU is Metal capable
    MacPro5,1 Mid-2010, Mid-2012

    # Xserve

    SMBIOS Year Supported Comment
    Xserve1,1 Mid-2006 NO 32-Bit Firmware limitation
    Xserve2,1 Early 2008 YES Everything is supported as long as GPU is Metal capable
    Xserve3,1 Early 2009

    # Once you've verified your hardware is supported, head to Download and build macOS Installers

    ⟵ ⟶

    - + diff --git a/PATCHEXPLAIN.html b/PATCHEXPLAIN.html index 19c651f36..377a47a82 100644 --- a/PATCHEXPLAIN.html +++ b/PATCHEXPLAIN.html @@ -11,7 +11,7 @@ - + @@ -19,7 +19,7 @@ GitHub (opens new window)

    # Explaining the patches in OpenCore Legacy Patcher

    In our patcher, there are numerous patches used to ensure a stable system. Here we're going to go over what patches are used and why we recommend or even require them.

    # OpenCore Settings

    Below is a run down of the main logic OpenCore Legacy Patcher uses to gain native support in macOS. Note OpenCore's configuration is documented within OpenCorePkg (opens new window) as well as an online version provided by us:

    Configuration Explanation

    # ACPI -> Patch

    ⟵ ⟶

    - + diff --git a/POST-INSTALL.html b/POST-INSTALL.html index ba9d5c155..3bce6b57b 100644 --- a/POST-INSTALL.html +++ b/POST-INSTALL.html @@ -11,7 +11,7 @@ - + @@ -19,7 +19,7 @@ GitHub (opens new window)

    # Post-Installation

    # Booting without USB drive

    Once you've installed macOS through OpenCore, you can boot up and go through the regular install process. To boot without the USB drive plugged in is quite simple:

    • Download OpenCore Legacy Patcher
    • Change Patcher settings as you'd like
    • Build OpenCore again
    • Install OpenCore to internal drive
    • Reboot holding Option, and select the internal EFI

    And voila! No more USB drive required

    # Booting seamlessly without Verbose or OpenCore Picker

    To do this, run the OpenCore Patcher and head to Patcher Settings:

    Here you can change different patcher settings, however the main interest is:

    • Set ShowPicker Mode

    Once you've toggled them both off, build your OpenCore EFI once again and install to your desired drive. Now to show the OpenCore selector, you can simply hold down the "ESC" key while clicking on EFI boot, then you can release the "ESC" key when you see the cursor arrow at the top left.

    # Applying Post Install Volume Patches

    Note: For users who need Post-Install Volume patches for legacy video acceleration support, you must disable the following settings in "Patcher Settings" when building and installing your new OpenCore:

    • SIP: Disabled
    • SecureBootModel: Disabled

    Once set, rebuild OpenCore, install to drive and reboot. Then, Post-Install Volume patches will run just fine

    To apply the Post-Install Volume patches to test out the Beta Graphics Acceleration Patches system (opens new window), select option #3 as shown below:

    And go ahead to option #1 and let the OCLP patcher apply the needed legacy video patches.

    Reboot your system and check out the now working graphics acceleration on your legacy system. This is still Beta software.

    + (opens new window)

    # Post-Installation

    # Booting without USB drive

    Once you've installed macOS through OpenCore, you can boot up and go through the regular install process. To boot without the USB drive plugged in is quite simple:

    • Download OpenCore Legacy Patcher
    • Change Patcher settings as you'd like
    • Build OpenCore again
    • Install OpenCore to internal drive
    • Reboot holding Option, and select the internal EFI

    And voila! No more USB drive required

    # Booting seamlessly without Verbose or OpenCore Picker

    To do this, run the OpenCore Patcher and head to Patcher Settings:

    Here you can change different patcher settings, however the main interest is:

    • Set ShowPicker Mode

    Once you've toggled them both off, build your OpenCore EFI once again and install to your desired drive. Now to show the OpenCore selector, you can simply hold down the "ESC" key while clicking on EFI boot, then you can release the "ESC" key when you see the cursor arrow at the top left.

    # Applying Post Install Volume Patches

    Note: For users who need Post-Install Volume patches for legacy video acceleration support, you must disable the following settings in "Patcher Settings" when building and installing your new OpenCore:

    • SIP: Disabled
    • SecureBootModel: Disabled

    Once set, rebuild OpenCore, install to drive and reboot. Then, Post-Install Volume patches will run just fine

    To apply the Post-Install Volume patches to test out the Beta Graphics Acceleration Patches system (opens new window), select option #3 as shown below:

    And go ahead to option #1 and let the OCLP patcher apply the needed legacy video patches.

    Reboot your system and check out the now working graphics acceleration on your legacy system. This is still Beta software.

    ⟵ ⟶

    - + diff --git a/START.html b/START.html index ef6d3fec3..14fd24c05 100644 --- a/START.html +++ b/START.html @@ -11,7 +11,7 @@ - + @@ -19,12 +19,12 @@ GitHub (opens new window)

    # What is OpenCore?

    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:

    • System Integrity Protection, FileVault 2, .im4m Secure Boot and Vaulting
    • Native OTA OS DELTA updates on all Macs
    • Recovery OS, Safe Mode and Single-user Mode booting
    • WPA Wifi and Personal Hotspot support

    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.

    For advanced troubleshooting, we highly recommend users check out the OpenCore Patcher Paradise Discord Server (opens new window) as this is generally the quickest way to get a hold of us developers and get help from the community.

    For those who wish to support this patcher, please see the Supporting the Patcher page

    # Patcher Warnings

    Since this patcher tricks macOS into thinking you're running a newer Mac, certain functionality may be broken:

    # How do I get started?

    1. The first step of ensuring whether your model is support is checking here:
    1. Download and build macOS Installer
    2. Run the OpenCore-Patcher.app
    3. Reboot and boot OpenCore

    + (opens new window)

    # What is OpenCore?

    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:

    • System Integrity Protection, FileVault 2, .im4m Secure Boot and Vaulting
    • Native OTA OS DELTA updates on all Macs
    • Recovery OS, Safe Mode and Single-user Mode booting
    • WPA Wifi and Personal Hotspot support

    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.

    For advanced troubleshooting, we highly recommend users check out the OpenCore Patcher Paradise Discord Server (opens new window) as this is generally the quickest way to get a hold of us developers and get help from the community.

    For those who wish to support this patcher, please see the Supporting the Patcher page

    # Patcher Warnings

    Since this patcher tricks macOS into thinking you're running a newer Mac, certain functionality may be broken:

    # How do I get started?

    1. The first step of ensuring whether your model is support is checking here:
    1. Download and build macOS Installer
    2. Run the OpenCore-Patcher.app
    3. Reboot and boot OpenCore

    Supported Models ⟶

    - + diff --git a/TERMS.html b/TERMS.html index 63bda0e7d..2cff7b3f9 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
    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

    + (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
    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/TESTED.html b/TESTED.html index 446b81c93..e4dd30bc8 100644 --- a/TESTED.html +++ b/TESTED.html @@ -11,7 +11,7 @@ - + @@ -19,7 +19,7 @@ GitHub (opens new window)

    # Tested Models on OpenCore Legacy Patcher

    To aid users in troubleshooting, we've compiled a list of users who've reported success with OpenCore Legacy patcher as well as the version used. This should aid users in verifying whether issues with the patcher are regression-related with newer versions.

    # MacBook

    SMBIOS Tested Tester Comment
    MacBook4,1 YES Mami - Stock Model
    - Couldn't install due to broke USB support
    MacBook5,1 air.man - Stock Model
    - Patcher version 0.0.19
    MacBook5,2 Finder352
    MacBook6,1 Finder352
    MacBook7,1 MykolaG
    Jazzzny
    AlexSakha67 - Stock Model
    - Patcher version 0.0.20

    # MacBook Air

    SMBIOS Tested Tester Comment
    MacBookAir2,1 No reports N/A N/A
    MacBookAir3,1
    MacBookAir3,2
    MacBookAir4,1
    MacBookAir4,2
    MacBookAir5,1 YES Ausdauersportler - Stock Model
    - Patcher version 0.0.9
    webg3 Stock Model
    MacBookAir5,2 Bab-droid - Stock Model
    - Patcher version 0.0.19
    K-Hobert - Stock model
    - Patcher version unknown
    cboukouv - Stock model
    - Patcher version 0.0.21

    # MacBook Pro

    SMBIOS Tested Tester Comment
    MacBookPro4,1 YES cboukouv - Stock model
    - Patcher version 0.0.19
    MacBookPro5,1 GURU_Jasho#5736 - Stock model
    - Patcher version 0.0.21
    MacBookPro5,2 hvds
    MacBookPro5,3 kommtzeitkonrad - Stock model
    - Patcher version 0.0.22
    MacBookPro5,4 No reports N/A N/A
    MacBookPro5,5
    MacBookPro6,1
    MacBookPro6,2 YES Jakeluke - Stock model, dGPU broken
    - Patcher version unknown
    MacBookPro7,1 fussel132 - Stock model
    -Patcher version v0.1.2
    MacBookPro8,1 AvaQueen - Stock model
    - Patcher version 0.0.19
    MacBookPro8,2 air.man - Stock model, dGPU disabled
    - Patcher version 0.0.22
    cboukouv - Stock model
    - Patcher version 0.0.19
    MacBookPro8,3 lulujyc - Stock model, dGPU disabled
    - Patcher version 0.1.4
    MacBookPro9,1 YES jbdamiano - Stock model
    - Patcher version 0.0.19
    dennes544
    cgrazy
    LIPA85
    MacBookPro9,2 alexx17xx - Stock model
    - Patcher version 0.0.19
    Arvxistanx
    CyberDroid1 - Stock model
    - Patcher version 0.0.16
    woefi - BCM94331CAX upgrade
    - Patcher version 0.0.13
    whgmkeller - Stock model
    - Patcher version 0.0.11
    vinaypundith - Patcher version 0.0.7
    MacBookPro10,1 traviswparker - Stock model
    - Patcher version 0.0.14
    il-rollino - Upgraded BCM94360CSAX
    - Patcher version 0.0.21
    MacBookPro10,2 No reports N/A N/A

    # Mac mini

    SMBIOS Tested Tester Comment
    Macmini3,1 No reports N/A N/A
    Macmini4,1
    Macmini5,1
    Macmini5,2
    Macmini5,3
    Macmini6,1 YES cicofz - Stock model
    - Patcher version 0.0.21
    Stig124 - Stock model
    - Patcher version 0.0.19
    mwidjaya - Stock model
    - Patcher version 0.0.18
    Macmini6,2 Shelbs - Stock model
    - Patcher version 0.0.16

    # iMac

    SMBIOS Tested Tester Comment
    iMac7,1 No reports N/A N/A
    iMac8,1 YES EduCovas - Stock Model
    - Patcher version 0.0.21
    iMac9,1 Allanrfox
    Jakeluke
    iMac10,1 Ausdauersportler - Upgraded with WX4150
    iMac11,1 internetzel - Upgraded with RX580 mobile
    iMac11,2 MykolaG - Stock Model
    - Patcher version 0.0.21
    iMac-iPad - Stock Model
    - Patcher version 0.0.21
    vinaypundith - Patcher version 0.0.19
    iMac11,3 Ausdauersportler - Upgraded with Polaris GPU
    - Upgraded BCM943602CDP
    - Patcher version 0.0.21
    iMac12,1 shnockdu - Upgraded with Kepler GPU
    - Patcher version 0.0.21
    StephN999 - Upgraded WX4150 GPU
    - Upgraded BCM94360CD
    - Patcher version 0.0.21
    iMac12,2 Ausdauersportler - Upgraded with Polaris GPU
    - Upgraded BCM943602CDP
    - Patcher version 0.0.21
    iMac13,1 alexx17xx - Stock Model
    - Patcher version 0.0.19
    iMac13,2 Alain13
    algernonpule - Stock Model
    - Patcher version 0.0.19
    iMac13,3 No reports N/A N/A
    iMac14,1 YES woefi - Upgraded NVMe
    - Patcher version 0.0.21
    mikeboss - Stock Model
    - Patcher version 0.0.19
    iMac14,2 OKonnel - Stock Model
    - Patcher version 0.0.22
    mibaxx - Stock Model
    - Patcher version 0.0.21
    iMac14,3 No reports N/A N/A

    # Mac Pro

    SMBIOS Tested Tester Comment
    MacPro3,1 YES MykolaG - Upgraded with RX 470 and BCM94360CD
    - Stock Bluetooth card removed
    - Patcher version 0.1.6
    christiann - Upgraded with RX 560 and BCM94322
    - Stock Bluetooth card removed
    - Patcher version 0.0.21
    gw463 - Upgraded GTX 680
    - Upgraded BCM94360
    - Patcher version 0.0.22
    AlexSakha67 - Upgraded R9 280
    - Patcher version 0.0.20
    nekton1 - Upgraded GTX 680
    - Patcher version 0.0.20
    Pri-est - Patcher version 0.0.9
    vinaypundith - Upgraded GTX 680
    - Upgraded BCM94360CD
    - Patcher version 0.0.6
    MacPro4,1 - Patcher version 0.0.9
    MacPro5,1 woefi - Upgraded with RX 580
    - Patcher version 0.0.21
    Mabrouk Oscar - Patcher version 0.0.21
    astuffedtiger - MacPro4,1 flashed to 5,1
    - Patcher version 0.0.18

    + (opens new window)

    # Tested Models on OpenCore Legacy Patcher

    To aid users in troubleshooting, we've compiled a list of users who've reported success with OpenCore Legacy patcher as well as the version used. This should aid users in verifying whether issues with the patcher are regression-related with newer versions.

    # MacBook

    SMBIOS Tested Tester Comment
    MacBook4,1 YES Mami - Stock Model
    - Couldn't install due to broke USB support
    MacBook5,1 air.man - Stock Model
    - Patcher version 0.0.19
    MacBook5,2 Finder352
    MacBook6,1 Finder352
    MacBook7,1 MykolaG
    Jazzzny
    AlexSakha67 - Stock Model
    - Patcher version 0.0.20

    # MacBook Air

    SMBIOS Tested Tester Comment
    MacBookAir2,1 No reports N/A N/A
    MacBookAir3,1
    MacBookAir3,2
    MacBookAir4,1
    MacBookAir4,2
    MacBookAir5,1 YES Ausdauersportler - Stock Model
    - Patcher version 0.0.9
    webg3 Stock Model
    MacBookAir5,2 Bab-droid - Stock Model
    - Patcher version 0.0.19
    K-Hobert - Stock model
    - Patcher version unknown
    cboukouv - Stock model
    - Patcher version 0.0.21

    # MacBook Pro

    SMBIOS Tested Tester Comment
    MacBookPro4,1 YES cboukouv - Stock model
    - Patcher version 0.0.19
    MacBookPro5,1 GURU_Jasho#5736 - Stock model
    - Patcher version 0.0.21
    MacBookPro5,2 hvds
    MacBookPro5,3 kommtzeitkonrad - Stock model
    - Patcher version 0.0.22
    MacBookPro5,4 No reports N/A N/A
    MacBookPro5,5
    MacBookPro6,1
    MacBookPro6,2 YES Jakeluke - Stock model, dGPU broken
    - Patcher version unknown
    MacBookPro7,1 fussel132 - Stock model
    -Patcher version v0.1.2
    MacBookPro8,1 AvaQueen - Stock model
    - Patcher version 0.0.19
    MacBookPro8,2 air.man - Stock model, dGPU disabled
    - Patcher version 0.0.22
    cboukouv - Stock model
    - Patcher version 0.0.19
    MacBookPro8,3 lulujyc - Stock model, dGPU disabled
    - Patcher version 0.1.4
    MacBookPro9,1 YES jbdamiano - Stock model
    - Patcher version 0.0.19
    dennes544
    cgrazy
    LIPA85
    MacBookPro9,2 alexx17xx - Stock model
    - Patcher version 0.0.19
    Arvxistanx
    CyberDroid1 - Stock model
    - Patcher version 0.0.16
    woefi - BCM94331CAX upgrade
    - Patcher version 0.0.13
    whgmkeller - Stock model
    - Patcher version 0.0.11
    vinaypundith - Patcher version 0.0.7
    MacBookPro10,1 traviswparker - Stock model
    - Patcher version 0.0.14
    il-rollino - Upgraded BCM94360CSAX
    - Patcher version 0.0.21
    MacBookPro10,2 No reports N/A N/A

    # Mac mini

    SMBIOS Tested Tester Comment
    Macmini3,1 No reports N/A N/A
    Macmini4,1
    Macmini5,1
    Macmini5,2
    Macmini5,3
    Macmini6,1 YES cicofz - Stock model
    - Patcher version 0.0.21
    Stig124 - Stock model
    - Patcher version 0.0.19
    mwidjaya - Stock model
    - Patcher version 0.0.18
    Macmini6,2 Shelbs - Stock model
    - Patcher version 0.0.16

    # iMac

    SMBIOS Tested Tester Comment
    iMac7,1 No reports N/A N/A
    iMac8,1 YES EduCovas - Stock Model
    - Patcher version 0.0.21
    iMac9,1 Allanrfox
    Jakeluke
    iMac10,1 Ausdauersportler - Upgraded with WX4150
    iMac11,1 internetzel - Upgraded with RX580 mobile
    iMac11,2 MykolaG - Stock Model
    - Patcher version 0.0.21
    iMac-iPad - Stock Model
    - Patcher version 0.0.21
    vinaypundith - Patcher version 0.0.19
    iMac11,3 Ausdauersportler - Upgraded with Polaris GPU
    - Upgraded BCM943602CDP
    - Patcher version 0.0.21
    iMac12,1 shnockdu - Upgraded with Kepler GPU
    - Patcher version 0.0.21
    StephN999 - Upgraded WX4150 GPU
    - Upgraded BCM94360CD
    - Patcher version 0.0.21
    iMac12,2 Ausdauersportler - Upgraded with Polaris GPU
    - Upgraded BCM943602CDP
    - Patcher version 0.0.21
    iMac13,1 alexx17xx - Stock Model
    - Patcher version 0.0.19
    iMac13,2 Alain13
    algernonpule - Stock Model
    - Patcher version 0.0.19
    iMac13,3 No reports N/A N/A
    iMac14,1 YES woefi - Upgraded NVMe
    - Patcher version 0.0.21
    mikeboss - Stock Model
    - Patcher version 0.0.19
    iMac14,2 OKonnel - Stock Model
    - Patcher version 0.0.22
    mibaxx - Stock Model
    - Patcher version 0.0.21
    iMac14,3 No reports N/A N/A

    # Mac Pro

    SMBIOS Tested Tester Comment
    MacPro3,1 YES MykolaG - Upgraded with RX 470 and BCM94360CD
    - Stock Bluetooth card removed
    - Patcher version 0.1.6
    christiann - Upgraded with RX 560 and BCM94322
    - Stock Bluetooth card removed
    - Patcher version 0.0.21
    gw463 - Upgraded GTX 680
    - Upgraded BCM94360
    - Patcher version 0.0.22
    AlexSakha67 - Upgraded R9 280
    - Patcher version 0.0.20
    nekton1 - Upgraded GTX 680
    - Patcher version 0.0.20
    Pri-est - Patcher version 0.0.9
    vinaypundith - Upgraded GTX 680
    - Upgraded BCM94360CD
    - Patcher version 0.0.6
    MacPro4,1 - Patcher version 0.0.9
    MacPro5,1 woefi - Upgraded with RX 580
    - Patcher version 0.0.21
    Mabrouk Oscar - Patcher version 0.0.21
    astuffedtiger - MacPro4,1 flashed to 5,1
    - Patcher version 0.0.18

    ⟵ ⟶

    - + diff --git a/TROUBLESHOOTING.html b/TROUBLESHOOTING.html index dfd40c963..db1aec1e8 100644 --- a/TROUBLESHOOTING.html +++ b/TROUBLESHOOTING.html @@ -11,7 +11,7 @@ - + @@ -19,9 +19,9 @@ GitHub (opens new window)

    # Troubleshooting

    Here are some common errors users may experience while using this patcher:

    # Stuck on This version of Mac OS X is not supported on this platform

    This means macOS has detected a SMBIOS it does not support, to resolve this ensure you're booting OpenCore before the macOS installer in the boot picker. Reminder the option will be called EFI Boot

    Once you've booted OpenCore at least once, your hardware should now auto boot it until either NVRAM reset or you remove the drive with OpenCore installed.

    # Cannot boot macOS without the USB

    By default, the OpenCore Patcher won't install OpenCore onto the internal drive itself during installs. Instead, you'll need to either manually transfer (opens new window) OpenCore to the internal drive's EFI or run this patcher's Option 2 again but select your internal drive.

    Reminder that once this is done, you'll need to select OpenCore in the boot picker again for your hardware to remember this entry and auto boot from then on.

    # Infinite Recovery OS Booting

    With OpenCore Legacy Patcher, we rely on Apple Secure Boot to ensure OS updates work correctly and reliably with Big Sur. However this installs NVRAM variables that will confuse your Mac if not running with OpenCore. To resolve, simply uninstall OpenCore and reset NVRAM (opens new window).

    • Note: Machines with modded root volumes will also result in infinite recovery until integrity is restored

    # Reboot when entering Hibernation (Sleep Wake Failure)

    Known issue on some models (opens new window), temporary fix is to disable Hibernation:

    sudo pmset -a hibernatemode 0
+     (opens new window)    
     
    # Troubleshooting
     
    Here are some common errors users may experience while using this patcher:
      
    # Stuck on This version of Mac OS X is not supported on this platform
     
    This means macOS has detected a SMBIOS it does not support, to resolve this ensure you're booting OpenCore before the macOS installer in the boot picker. Reminder the option will be called EFI Boot
     
    Once you've booted OpenCore at least once, your hardware should now auto boot it until either NVRAM reset or you remove the drive with OpenCore installed.
     
    # Cannot boot macOS without the USB
     
    By default, the OpenCore Patcher won't install OpenCore onto the internal drive itself during installs. Instead, you'll need to either manually transfer (opens new window) OpenCore to the internal drive's EFI or run this patcher's Option 2 again but select your internal drive.
     
    Reminder that once this is done, you'll need to select OpenCore in the boot picker again for your hardware to remember this entry and auto boot from then on.
     
    # Infinite Recovery OS Booting
     
    With OpenCore Legacy Patcher, we rely on Apple Secure Boot to ensure OS updates work correctly and reliably with Big Sur. However this installs NVRAM variables that will confuse your Mac if not running with OpenCore. To resolve, simply uninstall OpenCore and reset NVRAM (opens new window).
     
    • Note: Machines with modded root volumes will also result in infinite recovery until integrity is restored
     
    # Reboot when entering Hibernation (Sleep Wake Failure)
     
    Known issue on some models (opens new window), temporary fix is to disable Hibernation:
     
    sudo pmset -a hibernatemode 0
 
    # Booting with a non-flashed GPU
     
    For Mac Pro, Xserve and iMac users with non-flashed GPUs, you can still easily boot OpenCore and view the entire boot process. To do so, make sure SIP is disabled(to allow NVRAM write access) and run the following:
     
    sudo bless --verbose --file /Volumes/VOLNAME/EFI/OC/OpenCore.efi --folder /Volumes/VOLNAME/EFI/OC --setBoot
-
    • Note you will need to replace VOLNAME with the Volume name of your USB or hard drive with OpenCore
      •  
    • Note 2: Once done, you can re-enable SIP
      •  
    • Note 3: The EFI partition OpenCore was installed on must be mounted, if it's unmounted simply rerun "Install OpenCore to drive"
     
    Once you boot OpenCore for the first time, LauncherOption will install itself as the top boot priority making OpenCore always launch. Combined with RequestBootVar, all boot options must go through OpenCore ensuring seamless usage even with OS installation and updates.
     
    # How to Boot Big Sur Recovery
     
    By default, the patcher will try to hide extra boot options such as recovery from the user. To make them appear, simply press the "Spacebar" inside OpenCore's Picker to list all boot options.
     
    # Stuck on "Your Mac needs a firmware update"
     
    Full error: "Your Mac needs a firmware update in order to install to this Volume. Please select a Mac OS Extended (Journaled) volume instead."
     
    This error occurs when macOS determines the firmware to not have full APFS support. To resolve is quite simple, when building OpenCore head to "Patcher Settings" and enable "Moderate SMBIOS Patching" or higher. This will ensure that the firmware reported will show as supporting full APFS capabilities.
     
    # No Brightness Control
     
    With OCLP v0.0.22, we've added support for brightness control on many models. However some users may have noticed that their brightness keys do not work.
     
    To work-around, we recommend user try out the below app:
     
      
    
+
    • Note you will need to replace VOLNAME with the Volume name of your USB or hard drive with OpenCore
    • Note 2: Once done, you can re-enable SIP
    • Note 3: The EFI partition OpenCore was installed on must be mounted, if it's unmounted simply rerun "Install OpenCore to drive"

    Once you boot OpenCore for the first time, LauncherOption will install itself as the top boot priority making OpenCore always launch. Combined with RequestBootVar, all boot options must go through OpenCore ensuring seamless usage even with OS installation and updates.

    # How to Boot Big Sur Recovery

    By default, the patcher will try to hide extra boot options such as recovery from the user. To make them appear, simply press the "Spacebar" inside OpenCore's Picker to list all boot options.

    # Stuck on "Your Mac needs a firmware update"

    Full error: "Your Mac needs a firmware update in order to install to this Volume. Please select a Mac OS Extended (Journaled) volume instead."

    This error occurs when macOS determines the firmware to not have full APFS support. To resolve is quite simple, when building OpenCore head to "Patcher Settings" and enable "Moderate SMBIOS Patching" or higher. This will ensure that the firmware reported will show as supporting full APFS capabilities.

    # No Brightness Control

    With OCLP v0.0.22, we've added support for brightness control on many models. However some users may have noticed that their brightness keys do not work.

    To work-around, we recommend user try out the below app:

    ⟵ ⟶

    - + diff --git a/UNINSTALL.html b/UNINSTALL.html index c5067db6d..625c1de3d 100644 --- a/UNINSTALL.html +++ b/UNINSTALL.html @@ -11,7 +11,7 @@ - + @@ -19,16 +19,16 @@ GitHub (opens new window)

    # Uninstalling OpenCore

    To remove OpenCore is actually quite simply:

    1. Remove OpenCore either from the USB or internal drive
    • You'll need to mount the drive's EFI partition, and delete the EFI/OC folder as well as the System folder -
      • Note do not delete the entire EFI folder, this will likely break any existing Windows and Linux installations
    • See here for example how to mount (opens new window)
    1. Reset NVRAM

    Know that if you are on Big Sur when you remove the EFI folder, your Mac will no longer boot and show the prohibited symbol. Be ready to install an older version of macOS before you uninstall OpenCore.

    + (opens new window)

    # Uninstalling OpenCore

    To remove OpenCore is actually quite simply:

    1. Remove OpenCore either from the USB or internal drive
    • You'll need to mount the drive's EFI partition, and delete the EFI/OC folder as well as the System folder +
      • Note do not delete the entire EFI folder, this will likely break any existing Windows and Linux installations
    • See here for example how to mount (opens new window)
    1. Reset NVRAM

    Know that if you are on Big Sur when you remove the EFI folder, your Mac will no longer boot and show the prohibited symbol. Be ready to install an older version of macOS before you uninstall OpenCore.

    ⟵ Creating custom icons for OpenCore and Mac Boot Picker ⟶

    - + diff --git a/UPDATE.html b/UPDATE.html index dcb2fb218..03108ac88 100644 --- a/UPDATE.html +++ b/UPDATE.html @@ -3,7 +3,7 @@ - Updating OpenCore and Co. | OpenCore Legacy Patcher + Updating OpenCore and Co | OpenCore Legacy Patcher @@ -11,7 +11,7 @@ - + @@ -19,11 +19,11 @@ GitHub (opens new window)

    # Updating OpenCore and Co.

    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.

    For those who do wish to update, it's actually quite easy. Simply download the latest release (opens new window) and rerun the patcher:

    Then simply rebuild your OpenCore build and install again. Then voila, OpenCore is updated!

    To check what version of OpenCore and Patcher version you're currently running, you can run the following in terminal:

    # OpenCore Version
+     (opens new window)    
     
    # Updating OpenCore and Co
     
    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.
     
    For those who do wish to update, it's actually quite easy. Simply download the latest release (opens new window) and rerun the patcher:
     
     
    Then simply rebuild your OpenCore build and install again. Then voila, OpenCore is updated!
     
    To check what version of OpenCore and Patcher version you're currently running, you can run the following in terminal:
     
    # OpenCore Version
 nvram 4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:opencore-version
 # Patcher Version
 nvram 4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:OCLP-Version
-
     
    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!
      
    
+

    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!

    ⟵ ⟶

    - + diff --git a/WINDOWS.html b/WINDOWS.html index 1e66da1ab..a8370ac22 100644 --- a/WINDOWS.html +++ b/WINDOWS.html @@ -11,7 +11,7 @@ - + @@ -19,9 +19,9 @@ GitHub (opens new window)

    # Installing UEFI Windows 10

    To install UEFI is actually super simple! All it requires is to boot Windows' Installer through OpenCore to force a UEFI setup. Here we'll be going a bit more step by step in the process including partitioning and such.

    • Note: UEFI Windows is generally quite usable for Arrendale and newer models, however machines with Penryn CPUs may experience issues
    • Recommended Models: + (opens new window)

      # Installing UEFI Windows 10

      To install UEFI is actually super simple! All it requires is to boot Windows' Installer through OpenCore to force a UEFI setup. Here we'll be going a bit more step by step in the process including partitioning and such.

      • Note: UEFI Windows is generally quite usable for Arrendale and newer models, however machines with Penryn CPUs may experience issues
      • Recommended Models:
        • MacBookAir4,x and newer
        • MacBookPro8,x and newer
        • Macmini5,x and newer
        • iMac11,x and newer
        • MacPro4,1 and newer
        • Xserve3,1 and newer

      Once you know your model is supported, you're good to go with the rest of this guide

      # Disk Formatting

      To start off, we'll need the following:

      • An 8GB USB drive for the Windows Installer
      • Minimum of 30GB of free space on whatever drive you want to install Windows too

      First, lets format out drives as follows:

      # USB Drive Formatting

      Open Disk Utility in macOS and format the USB Drive as ExFat with MBR Scheme:

      # Disk Formatting

      Next, grab the drive you wish to install Windows on and partition it as ExFat (If formatting entire drive, ensure it's GUID Partition Table):

      If you plan to use the same hard drive for macOS and Windows, we recommend creating a dedicated partition just for OpenCore. This lets Windows have the ESP to itself and OpenCore can stay within it's own bubble.

      Recommended size is 200MB and the partition format must be FAT32 for OpenCore to operate correctly. You will next want to install OpenCore onto the new partition, either moving from the ESP with MountEFI (opens new window) or rerunning the OpenCore-Patcher.app

      • Note: For machines with dedicated drives for Windows, having different partitions for OpenCore is not required
      • Note 2: We recommend uninstalling OpenCore from the ESP/EFI Partition when you create this new OpenCore partition to avoid confusion when selecting OpenCore builds in the Mac's boot picker

      # Creating the Installer

      First up, lets grab Windows's Installer at the below link:

      Next, mount the Windows 10 ISO:

      The open terminal and run rsync on the USB drive (replace CCCOMA_X64 with the mounted ISO's name, as well as replacing W10USB with your USB drive's name):

      rsync -r -P /Volumes/CCCOMA_X64/ /Volumes/W10USB
-

      Command will take some time, so sit back and get some coffee. Once finished, the root of the USB drive should look as follows:

      • Ensure that these folders and files are on the root, otherwise the USB will not boot

      Once done, lets reboot into OpenCore's Menu and you'll see a new Windows' entry:

      • Note: Do not boot the installer outside of OpenCore as this will default back to the old MBR BIOS setup. Booting through OpenCore ensures Windows uses UEFI

      From there, install Windows as normal and you'll get a new BootCamp entry in OpenCore's picker when done!

      • Don't forget to run BootCamp's utilities installer as well to ensure Wifi and such are functioning correctly. This can be downloaded from the BootCamp Assistant app in macOS

      # Troubleshooting

      # iMac12,x Bluescreen after driver installation

      Currently Intel's iGPU drivers for the HD 3000 series do not support UEFI booting in Windows. Recommended solution is to simply disable: iMac 12,1 Windows 10 Boot Loop – Fix Intel Graphics issue (opens new window)

      +

      Command will take some time, so sit back and get some coffee. Once finished, the root of the USB drive should look as follows:

      • Ensure that these folders and files are on the root, otherwise the USB will not boot

      Once done, lets reboot into OpenCore's Menu and you'll see a new Windows' entry:

      • Note: Do not boot the installer outside of OpenCore as this will default back to the old MBR BIOS setup. Booting through OpenCore ensures Windows uses UEFI

      From there, install Windows as normal and you'll get a new BootCamp entry in OpenCore's picker when done!

      • Don't forget to run BootCamp's utilities installer as well to ensure Wifi and such are functioning correctly. This can be downloaded from the BootCamp Assistant app in macOS

      # Troubleshooting

      # iMac12,x Bluescreen after driver installation

      Currently Intel's iGPU drivers for the HD 3000 series do not support UEFI booting in Windows. Recommended solution is to simply disable: iMac 12,1 Windows 10 Boot Loop – Fix Intel Graphics issue (opens new window)

    ⟵ ⟶

    - + diff --git a/assets/js/14.1e7135f7.js b/assets/js/14.1e7135f7.js new file mode 100644 index 000000000..f65aef77c --- /dev/null +++ b/assets/js/14.1e7135f7.js @@ -0,0 +1 @@ +(window.webpackJsonp=window.webpackJsonp||[]).push([[14],{319:function(e,n,t){e.exports=t.p+"assets/img/first-run.898738d5.png"},389:function(e,n,t){e.exports=t.p+"assets/img/oclp-version.98f68848.png"},427: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(389),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/14.2d88c26a.js b/assets/js/14.2d88c26a.js deleted file mode 100644 index 65483e184..000000000 --- a/assets/js/14.2d88c26a.js +++ /dev/null @@ -1 +0,0 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[14],{319:function(e,n,t){e.exports=t.p+"assets/img/first-run.898738d5.png"},389:function(e,n,t){e.exports=t.p+"assets/img/oclp-version.98f68848.png"},427: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(389),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/26.c88f1bf6.js b/assets/js/26.8fb73cee.js similarity index 68% rename from assets/js/26.c88f1bf6.js rename to assets/js/26.8fb73cee.js index 8fe33f40e..4ef4b334f 100644 --- a/assets/js/26.c88f1bf6.js +++ b/assets/js/26.8fb73cee.js @@ -1 +1 @@ -(window.webpackJsonp=window.webpackJsonp||[]).push([[26],{422:function(e,t,a){"use strict";a.r(t);var o=a(25),r=Object(o.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:"what-is-opencore"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#what-is-opencore"}},[e._v("#")]),e._v(" What is OpenCore?")]),e._v(" "),a("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(" "),a("ul",[a("li",[e._v("System Integrity Protection, FileVault 2, .im4m Secure Boot and Vaulting")]),e._v(" "),a("li",[e._v("Native OTA OS DELTA updates on all Macs")]),e._v(" "),a("li",[e._v("Recovery OS, Safe Mode and Single-user Mode booting")]),e._v(" "),a("li",[e._v("WPA Wifi and Personal Hotspot support")])]),e._v(" "),a("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(" "),a("p",[e._v("For advanced troubleshooting, we highly recommend users check out the "),a("a",{attrs:{href:"https://discord.gg/rqdPgH8xSN",target:"_blank",rel:"noopener noreferrer"}},[e._v("OpenCore Patcher Paradise Discord Server"),a("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(" "),a("p",[e._v("For those who wish to support this patcher, please see the "),a("RouterLink",{attrs:{to:"/DONATE.html"}},[e._v("Supporting the Patcher page")])],1),e._v(" "),a("h2",{attrs:{id:"patcher-warnings"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#patcher-warnings"}},[e._v("#")]),e._v(" Patcher Warnings")]),e._v(" "),a("p",[e._v("Since this patcher tricks macOS into thinking you're running a newer Mac, certain functionality may be broken:")]),e._v(" "),a("ul",[a("li",[e._v("Boot Camp Assistant.app\n"),a("ul",[a("li",[e._v("We recommend following our "),a("a",{attrs:{href:""}},[e._v("guide on getting a UEFI Windows Install working")]),e._v(". Legacy MBR Based installs won't show up in OpenCore")])])])]),e._v(" "),a("h2",{attrs:{id:"how-do-i-get-started"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#how-do-i-get-started"}},[e._v("#")]),e._v(" How do I get started?")]),e._v(" "),a("ol",[a("li",[e._v("The first step of ensuring whether your model is support is checking here:")])]),e._v(" "),a("ul",[a("li",[a("RouterLink",{attrs:{to:"/MODELS.html"}},[e._v("Supported Models")])],1)]),e._v(" "),a("ol",{attrs:{start:"2"}},[a("li",[a("RouterLink",{attrs:{to:"/INSTALLER.html"}},[e._v("Download and build macOS Installer")])],1),e._v(" "),a("li",[a("RouterLink",{attrs:{to:"/BUILD.html"}},[e._v("Run the "),a("code",[e._v("OpenCore-Patcher.app")])])],1),e._v(" "),a("li",[a("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([[26],{422:function(e,t,a){"use strict";a.r(t);var o=a(25),r=Object(o.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:"what-is-opencore"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#what-is-opencore"}},[e._v("#")]),e._v(" What is OpenCore?")]),e._v(" "),a("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(" "),a("ul",[a("li",[e._v("System Integrity Protection, FileVault 2, .im4m Secure Boot and Vaulting")]),e._v(" "),a("li",[e._v("Native OTA OS DELTA updates on all Macs")]),e._v(" "),a("li",[e._v("Recovery OS, Safe Mode and Single-user Mode booting")]),e._v(" "),a("li",[e._v("WPA Wifi and Personal Hotspot support")])]),e._v(" "),a("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(" "),a("p",[e._v("For advanced troubleshooting, we highly recommend users check out the "),a("a",{attrs:{href:"https://discord.gg/rqdPgH8xSN",target:"_blank",rel:"noopener noreferrer"}},[e._v("OpenCore Patcher Paradise Discord Server"),a("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(" "),a("p",[e._v("For those who wish to support this patcher, please see the "),a("RouterLink",{attrs:{to:"/DONATE.html"}},[e._v("Supporting the Patcher page")])],1),e._v(" "),a("h2",{attrs:{id:"patcher-warnings"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#patcher-warnings"}},[e._v("#")]),e._v(" Patcher Warnings")]),e._v(" "),a("p",[e._v("Since this patcher tricks macOS into thinking you're running a newer Mac, certain functionality may be broken:")]),e._v(" "),a("ul",[a("li",[e._v("Boot Camp Assistant.app\n"),a("ul",[a("li",[e._v("We recommend following our "),a("RouterLink",{attrs:{to:"/WINDOWS.html"}},[e._v("guide on getting a UEFI Windows Install working")]),e._v(". Legacy MBR Based installs won't show up in OpenCore")],1)])])]),e._v(" "),a("h2",{attrs:{id:"how-do-i-get-started"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#how-do-i-get-started"}},[e._v("#")]),e._v(" How do I get started?")]),e._v(" "),a("ol",[a("li",[e._v("The first step of ensuring whether your model is support is checking here:")])]),e._v(" "),a("ul",[a("li",[a("RouterLink",{attrs:{to:"/MODELS.html"}},[e._v("Supported Models")])],1)]),e._v(" "),a("ol",{attrs:{start:"2"}},[a("li",[a("RouterLink",{attrs:{to:"/INSTALLER.html"}},[e._v("Download and build macOS Installer")])],1),e._v(" "),a("li",[a("RouterLink",{attrs:{to:"/BUILD.html"}},[e._v("Run the "),a("code",[e._v("OpenCore-Patcher.app")])])],1),e._v(" "),a("li",[a("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/app.95c3b23f.js b/assets/js/app.c3ea73c1.js similarity index 93% rename from assets/js/app.95c3b23f.js rename to assets/js/app.c3ea73c1.js index c9ef659f8..577928db8 100644 --- a/assets/js/app.95c3b23f.js +++ b/assets/js/app.c3ea73c1.js @@ -1,4 +1,4 @@ -(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" +