You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* This allows booting MacOS v11.x (Big Sur) or later from single named volumes on the main screen.
37
+
* This allows booting MacOS 11.x (Big Sur) or later from single named volumes on the main screen.
37
38
- As opposed to generic and difficult to distinguish 'PreBoot' volumes.
38
39
- Avoids potentially compromising system integrity by otherwise requiring SIP to be disabled.
39
40
* This also allows booting FileVault encrypted volumes from signle named volumes on the main screen.
40
41
- As opposed to generic and difficult to distinguish 'PreBoot' volumes.
41
42
42
43
## Installation
43
-
[MyBootMgr](https://www.dakanji.com/creations/index.html), an automated implementation of a RefindPlus/OpenCore chain-loading arrangement is recommended for implementation on MacPro3,1 to MacPro5,1 as well as on XServe2,1 and XServe3,1. However, the RefindPlus efi file can function as a drop-in replacement for the rEFInd efi file. Hence, you can install the [rEFInd package](https://www.rodsbooks.com/refind/installing.html) first and replace the rEFInd efi file with the RefindPlus efi file. (Ensure you rename the RefindPlus efi file to match). This permits implementing RefindPlus on other types of Mac as well as on other operating systems.
44
+
[MyBootMgr](https://www.dakanji.com/creations/index.html), an automated implementation of a RefindPlus/OpenCore chain-loading arrangement is recommended for implementation on MacPro3,1 to MacPro5,1 as well as on XServe2,1 and XServe3,1. However, the RefindPlus efi file can function as a drop-in replacement for the upstream efi file. Hence, you can install the [rEFInd package](https://www.rodsbooks.com/refind/installing.html) first and replace the efi file with the RefindPlus efi file. (Ensure you rename the RefindPlus efi file to match). This permits implementing RefindPlus on other types of Mac as well as on other operating systems.
44
45
45
46
Users may also want to replace filesystem drivers with those packaged with RefindPlus as these are always either exactly the same as upstream versions or have had fixes applied.
46
47
47
-
RefindPlus will function with the rEFInd configuration file, `refind.conf`, but users may wish to replace this with the RefindPlus configuration file, `config.conf`, to configure the additonal options provided by RefindPlus. A sample RefindPlus configuration file is available here: [config.conf-sample](https://github.com/dakanji/RefindPlus/blob/GOPFix/config.conf-sample). RefindPlus-Specific options can also be added to a refind.conf file and used that way if preferred.
48
+
RefindPlus will function with the upstream configuration file, `refind.conf`, but users may wish to replace this with the RefindPlus configuration file, `config.conf`, to configure the additonal options provided by RefindPlus. A sample RefindPlus configuration file is available here: [config.conf-sample](https://github.com/dakanji/RefindPlus/blob/GOPFix/config.conf-sample). RefindPlus-Specific options can also be added to a refind.conf file and used that way if preferred.
48
49
49
-
Note that if you run RefindPlus without activating the additonal options, as will be the case if using an unmodified rEFInd configuration file, a RefindPlus run will be equivalent to running the rEFInd version it is based on, currently v0.13.2. That is, the additonal options provided in RefindPlus must be actively enabled if they are required. This equivalence is subject to a few divergent items in RefindPlus as outlined under the `Divergence` section below.
50
+
Note that if you run RefindPlus without activating the additonal options, as will be the case if using an unmodified upstream configuration file, a RefindPlus run will be equivalent to running the upstream version it is based on, currently v0.13.2. That is, the additonal options provided in RefindPlus must be actively enabled if they are required. This equivalence is subject to a few divergent items in RefindPlus as outlined under the `Divergence` section below. NB: Upstream post-release code updates are typically ported to RefindPlus as they happen and as such, RefindPlus releases are actually at the state of the upstream release version plus any such updates.
50
51
51
52
## Additional Functionality
52
-
RefindPlus-Specific funtionality can be configured by adding the tokens below to a rEFInd configuration file.
53
+
RefindPlus-Specific funtionality can be configured by adding the tokens below to the upstream configuration file. Additional information is provided in the sample RefindPlus configuration file.
53
54
54
55
Token | Functionality
55
56
----- | -----
56
-
active_csr |Actively enables or disables the SIP Policy on Macs
57
57
continue_on_warning |Proceeds as if a key is pressed after screen warnings (unattended boot)
58
+
csr_dynamic |Actively enables or disables the SIP Policy on Macs
59
+
csr_normalise |Removes the `APPLE_INTERNAL` bit, when present, to permit OTA updates
58
60
decline_apfsload |Disables built in provision of APFS filesystem capability
59
61
decline_apfsmute |Disables supressesion of verbose APFS text on boot
60
62
decline_apfssync |Disables feature allowing direct APFS/FileVault boot (Without "PreBoot")
63
+
decline_applefb |Disables provision under some circumstances of missing AppleFramebuffers
61
64
decline_espfilter |Allows other ESPs other than the RefindPlus ESP to be scanned for loaders
62
65
decline_nvmeload |Disables the built in NvmExpress Driver
63
66
decline_nvramprotect |Disables feature that blocks UEFI Windows certificates on Apple NVRAM
67
+
decline_panicfilter |Disables feature that blocks kernel panic information on Apple NVRAM
64
68
decline_reloadgop |Disables reinstallation of UEFI 2.x GOP drivers on EFI 1.x units
65
69
decline_tagshelp |Disables feature that ensures hidden tags can always be unhidden
70
+
decline_texthelp |Disables complementary text colours if not required
66
71
decline_uefiemulate |Disables feature that emulates UEFI 2.x support on EFI 1.x units
67
-
direct_gop_renderer |Provides a potentially improved GOP instance for certain GPUs
68
72
disable_amfi |Disables AMFI Checks on MacOS if required
69
73
disable_compat_check |Disables Mac version compatibility checks if required
70
-
external_hidden_icons |Allows scanning for `.VolumeIcon` icons on external volumes
74
+
disable_rescan_dxe |Disables scanning for newly revealed DXE drivers when connecting handles
71
75
force_trim |Forces `TRIM` on non-Apple SSDs on Macs if required
72
-
ignore_hidden_icons |Disables scanning for `.VolumeIcon` image icons if not required
73
-
normalise_csr |Removes the `APPLE_INTERNAL` bit, when present, to permit OTA updates
74
-
prefer_hidden_icons |Prioritises `.VolumeIcon` image icons when available
76
+
hidden_icons_external |Allows scanning for `.VolumeIcon` icons on external volumes
77
+
hidden_icons_ignore |Disables scanning for `.VolumeIcon` image icons if not required
78
+
hidden_icons_prefer |Prioritises `.VolumeIcon` image icons when available
79
+
icon_row_move |Adjusts the main screen icon row positions (vertically)
80
+
icon_row_tune |Finetunes the main screen icon row positions
81
+
pass_uga_through |Provides UGA instance on GOP to permit EfiBoot with modern GPUs
75
82
provide_console_gop |Fixes issues with GOP on some legacy units
83
+
ransom_drives |Frees partitions locked by how certain firmware load inbuilt drivers
84
+
renderer_direct_gop |Provides a potentially improved GOP instance for certain GPUs
85
+
renderer_text |Provides a text renderer for text output when otherwise unavailable
text_renderer |Provides a text renderer for text output when otherwise unavailable
80
89
transient_boot |Disables saving the last booted loader if not required
81
-
uga_pass_through|Provides UGA instance on GOP to permit EfiBoot with modern GPUs
90
+
unicode_collation |Provides finetuned support for languages that use unicode text
82
91
83
92
## Extended Functionality
84
93
In addition to the new functionality listed above, the following upsteam tokens have been extended:
85
94
-**"use_graphics_for" Token:** OpenCore and Clover added as options that can be set to boot in graphics mode.
86
-
-**"showtools" Token:** Additional tools added:
95
+
-**"showtools" Token:** Additional tool added:
87
96
-`clean_nvram` : Allows resetting nvram directly from RefindPlus.
88
-
-`show_bootscreen` : Allows compatible GPUs to load the Apple Pre Boot Configuration screen.
89
-
-**"csr_values" Token:** A value of `0` can be set as the `Enabled` value to ensure `Over The Air` (OTA) updates from Apple when running MacOS v11.x (Big Sur), or later, with SIP enabled.
90
-
- This is equivalent to activating the `normalise_csr` token.
97
+
-**"csr_values" Token:** A value of `0` can be set as the `Enabled` value to ensure `Over The Air` (OTA) updates from Apple when running MacOS 11.x (Big Sur), or later, with SIP enabled.
98
+
- This is equivalent to activating the `csr_normalise` token.
91
99
-**"timeout" Token:** The default is no timeout unless explicitly set.
92
100
-**"screensaver" Token:** The RefindPlus screensaver cycles through a set of colours as opposed to a single grey colour.
93
101
-**"use_nvram" Token:** RefindPlus variables are written to the file system and not the motherboard's NVRAM unless explicitly set to do so by activating this configuration token.
@@ -106,16 +114,17 @@ In addition to the new functionality listed above, the following upsteam tokens
106
114
## Divergence
107
115
Implementation differences with the upstream base version v0.13.2 are:
108
116
-**Screenshots:** These are saved in the PNG format with a significantly smaller file size. Additionally, the file naming is slightly different and the files are always saved to the same ESP as the RefindPlus efi file.
109
-
-**UI Scaling:** WQHD monitors are correctly determined not to be HiDPI monitors and UI elements are not scaled up on such monitors when the RefindPlus-Specific `scale_ui` configuration token is set to automatically detect the screen resolution. RefindPlus also takes vertically orientation screens into account.
117
+
-**UI Scaling:** WQHD monitors are correctly determined not to be HiDPI monitors and UI elements are not scaled up on such monitors when the RefindPlus-Specific `scale_ui` configuration token is set to automatically detect the screen resolution. RefindPlus also takes vertically orientated screens into account.
110
118
-**Hidden Tags:** RefindPlus always makes the "hidden_tags" tool available (even when the tool is not specified in the "showtools" list). This is done to ensure that when users hide items (always possible), such items can also be unhidden (only possible when the "hidden_tags" tool is available). Users that prefer not to have this feature can activate the RefindPlus-Specific `decline_tagshelp` configuration token to switch it off.
111
119
-**GOP Driver Provision:** RefindPlus attempts to ensure that UEFI 2.x GOP drivers are available on EFI 1.x units by attempting to reload such drivers when it detects an absence of GOP on such units to permit the use of modern GPUs on legacy units. Users that prefer not to have this feature can activate the RefindPlus-Specific `decline_reloadgop` configuration token to switch it off.
112
120
-**NVMe Driver Provision:** RefindPlus installs a built in NvmExpressDxe driver when it detects an absence of NvmExpress capability on units with PCIe slots. Users that prefer not to have this feature can activate the RefindPlus-Specific `decline_nvmeload` configuration token to switch it off.
121
+
-**AppleFramebuffer Provision:** RefindPlus defaults to always providing AppleFramebuffer on Macs, when not available under certain circumstances. This is done using a built in `SupplyAppleFB` feature. Users that prefer not to have this feature can activate the RefindPlus-Specific `decline_applefb` configuration token to switch it off.
113
122
-**APFS Filesystem Provision:** RefindPlus defaults to always providing APFS Filesystem capability, when not available but is required, without a need to load an APFS driver. This is done using a built in `SupplyAPFS` feature. Users that prefer not to have this feature can activate the RefindPlus-Specific `decline_apfsload` configuration token to switch it off.
114
123
-**APFS Verbose Text Suppression:** RefindPlus defaults to always suppressesing verbose text output associated with loading APFS functionality by the built in `SupplyAPFS` feature. Users that prefer not to have this feature can activate the RefindPlus-Specific `decline_apfsmute` configuration token to switch it off.
115
124
-**APFS PreBoot Volumes:** RefindPlus always synchronises APFS System and PreBoot partitions transparently such that the Preboot partitions of APFS volumes are always used to boot APFS formatted MacOS. Hence, a single option for booting MacOS on APFS volumes is presented in RefindPlus to provide maximum APFS compatibility, consistent with Apple's implementation. Users that prefer not to have this feature can activate the RefindPlus-Specific `decline_apfssync` configuration token to switch it off.
116
-
-**Apple NVRAM Protection:** RefindPlus always prevents UEFI Windows Secure Boot from saving certificates to Apple NVRAM as this can result in damage and an inability to boot. Blocking these certificates does not impact the operation of UEFI Windows on Apple Macs. This filtering only happens when Apple firmware is detected and is not applied to other types of firmware. Users that prefer not to have this feature can activate the RefindPlus-Specific `decline_nvramprotect` configuration token to switch it off.
125
+
-**Apple NVRAM Protection:** RefindPlus always prevents UEFI Windows Secure Boot from saving certificates to Apple NVRAM as this can result in damage and an inability to boot. Blocking these certificates does not impact the operation of UEFI Windows on Apple Macs. This filtering only happens when Apple firmware is detected and is not applied to other types of firmware. Users that prefer not to have this feature can activate the RefindPlus-Specific `decline_nvramprotect` configuration token to switch it off. Additionally, RefindPlus always prevents MacOS kernel panic information writes to the NVRAM as this can also result in damage and an inability to boot. This filtering similarly only happens when Apple firmware is detected and is not applied to other types of firmware. Users that prefer not to have this feature can activate the RefindPlus-Specific `decline_panicfilter` configuration token to switch it off.
117
126
-**UEFI 2.x Emulation:** RefindPlus always emulates the `CreateEventEx` feature from UEFI 2.x on EFI 1.x units and additionally modifies the EFI Revision value to `UEFI 2.3`. This often allows running UEFI 2.x utilities on legacy units since several such utilities only require CreateEventEx to function. Users that prefer not to have this feature can activate the RefindPlus-Specific `decline_uefiemulate` configuration token to switch it off.
118
-
-**ESP Scanning:** Other ESPs separate from that containing the active efi file are now also scanned for loaders by rEFInd. The earlier behaviour, where all other ESPs were treated as duplicates and ignored, has been considered an error and changed. This earlier behaviour is preferred and maintained in RefindPlus. However, users are provided an option to override this behaviour, in favour of the new rEFInd behaviour, by activating the RefindPlus-Specific `decline_espfilter` configuration token to switch it off.
127
+
-**ESP Scanning:** Other ESPs separate from that containing the active efi file are now also scanned for loaders by rEFInd. The earlier behaviour, where all other ESPs were treated as duplicates and ignored, has been considered an error and changed. This earlier behaviour is preferred and maintained in RefindPlus. However, users are provided an option to override this behaviour, in favour of the new upstream behaviour, by activating the RefindPlus-Specific `decline_espfilter` configuration token to switch it off.
119
128
-**Disabled Manual Stanzas:** The processing of a user configured boot stanza is halted once a `Disabled` setting is encountered and the `Entry` object returned 'as is'. The outcome is the same between rEFInd, which always proceeds to create and return a fully built object (subsequently discarded), and RefindPlus, which may return a partial object (similarly discarded). However, the approach adopted in RefindPlus allows for an optimised loading process particularly when `Disabled` tokens are placed immediately after the `menuentry` line (see examples in the [config.conf-sample](https://github.com/dakanji/RefindPlus/blob/4d066b03423e0b4d34b11fc5e17faa7db511c551/config.conf-sample#L890) file). This also applies to `submenuentry` items which can be enabled or disabled separately.
0 commit comments