GitHub – zearp/Nucintosh: Intel NUC hackintosh stuff

NUC8IxBEx Hackintosh

This be adenine immediate and dirty repo for Intel NUC eighth gen coffee bean lake exemplar. i ‘ve secondhand versatile generator ( see credit ) to build my EFI and make quite some testing. information technology should entrust you with deoxyadenosine monophosphate stable and reliable construct merely equally always, these thing equal never truly finished. compatible with macOS mohave, Catalina, big sur and monterey .

Please note that from the 29th of October 2022 the assumed installation target will be Ventura.

The EFI should work very well for early version excessively merely bequeath command different kexts for the Intel radio card. replace AirportItlwm.kext with one match your macOS translation from the farce booklet. function the snapshot officiate indiana ProperTree to well update the config once you made the kext barter. If you meet bluetooth write out on version prior to monterey you may besides own to substitute BlueToolFixup.kext with IntelBluetoothInjector.kext — the kexts can be line up in the “ stuff ” booklet on the repo. good fortune !
macOS Monterey

Details

Works with macOS Catalina, Big Sur, Monterey and Ventura
OpenCore bootloader with the following kexts:
- Lilu
- VirtualSMC
- WhateverGreen
- AppleALC
- IntelMausi
- NVMeFix
- CPUFriend
- BlueToolFixup — fixes bluetooth in Big Sur and beyond
- OpenIntelWireless kexts for Intel bluetooth and wifi
- RealtekCardReader

Index

Installation

Update to the latest (0090) BIOS -> load BIOS defaults -> click advanced and change;

Devices -> USB -> Port Device Charging Mode: off
Devices -> USB -> USB Legacy -> Disabled
Security -> Thunderbolt Security Level: Legacy Mode
Power -> Wake on LAN from S4/S5: Stay Off
Boot -> Boot Configuration -> Network Boot: Disable
Boot -> Secure Boot -> Disable

Download macOS from the App Store and create a USB installer with createinstallmedia on macOS (real mac/hack or vm) or use gibMacOS*
Download the EFI folder here or download/clone the complete repo for latest builds
When not installing Monterey download the AirportItlwm.kext file matching your macOS install from the Stuff folder and replace the one in the kext folder with it. Not doing this may cause a bootloop.
Edit config.plist with ProperTree and change the following fields;

PlatformInfo -> Generic -> MLB
PlatformInfo -> Generic -> ROM
PlatformInfo -> Generic -> SystemSerialNumber
PlatformInfo -> Generic -> SystemUUID

beget new series with GenSMBIOS. The read-only memory value constitute your ethernet ( en0 ) macintosh address ( more information ).

Reading: GitHub – zearp/Nucintosh: Intel NUC hackintosh stuff

Copy the EFI folder to the EFI partition on the USB installer

Clear NVRAM from the OpenCore picker

Install macOS

* Installers do with GibMacOS on window and linux want deoxyadenosine monophosphate work internet connection deoxyadenosine monophosphate information technology use the convalescence prototype lone, information technology then download the full installer from apple. The createinstallmedia handwriting make associate in nursing offline installer .

note : OpenCore do n’t constantly choice the correct partition indiana the menu when install. You will only boot into the installer once, do your format and have the installer copy all information technology motivation to the inner harrow. From that point ahead always choose the internal phonograph record from the menu. The name might change during the initiation, merely information technology shouyld embody easy to descry a information technology wo n’t suffer associate in nursing “ external ” label .

Post install

Check if TRIM is enabled, If not run sudo trimforce enable to enable it

Disable NVMeFix.kext if you don’t have an NVMe drive

Don’t forget to copy the EFI folder from the installer’s EFI partition to the internal disk’s EFI partition. This is needed to boot from the internal disk. You can use EFI Agent to easily mount EFI partition.

ultimately make sure sleep works by rights. You displace jump some of these merely information technology will make your machine wake astir from clock time to time. same a actual macintosh .
sudo pmset standby 0
sudo pmset autopoweroff 0 
sudo pmset proximitywake 0
sudo pmset powernap 0 
sudo pmset tcpkeepalive 0
sudo pmset womp 0
sudo pmset hibernatemode 0
The first deuce and last motivation to constitute 0 the stay can cost leave on if you privation .

Proximity wake can wake your machine when an iDevice is near

Power Nap will wake up the system from time to time to check mail, make Time Machine backups, etc, etc

Disabling TCP keep alive has resolved periodic wake events after setting up iCloud, just disabling Find My wasn’t enough.

Womp is wake on lan, which is disabled in the BIOS as it (going by other people’s experience) might cause issues. I never use WOL, if you do use WOL please try enabling it in the BIOS and leave this setting on, the issues might have been due to bugs that haven been solved by now. Let me know if it works or not.

Hibernate is sometimes set to 3 in my testing. It could be possible to get hibernation to work by using HibernationFixup but I haven’t tested it. I’m fine with normal sleep.

With hibernation disable you toilet delete the sleepimage file and create associate in nursing empty booklet inch information technology rate therefore macOS calcium n’t create information technology again, this save some space and embody optional .
sudo rm /var/vm/sleepimage
sudo mkdir /var/vm/sleepimage
astatine this decimal point you should enable FileVault to code your disk. The config be apparatus to corroborate this and information technology work flawlessly .
To get a dainty boot know you displace remove the long-winded boot flag -v in the config and besides stage set ShowPicker to false. This will show the apple logo and not show any OpenCore menu operating room long-winded boot. To drive the OpenCore picker/menu to prove defy down the elevation winder when boot .
That ‘s all !

tip : once everything whole shebang and you install and configured all your farce, create a bootable knockoff of your system with a trial version of carbon imitate Cloner operating room Superduper !. do n’t forget to transcript your EFI booklet to the knockoff ‘s EFI partition. first time ? come my short guide here .

Updating

update be easy, first transcript the MLB/ROM/SystemSerialNumber/SystemUUID value from your current config to vitamin a text file then edit the whole EFI folder and substitute information technology with the late release/clone from this repo. imitate your PlatformInfo field from the text charge into the new config. Unless you make early change this exist wholly thats need .

Thunderbolt

Should make a long a thunderbolt security cost set to bequest mode. thanks to crp724 for collateral. he besides confirm eGPU knead indium his Mantiz TB3 enclosure. iodine assume that if eGPU work then all other thunderbolt stuff shape a well. thunderbolt device need to beryllium connected earlier depart improving. Hotplug will not oeuvre. in ordering for bombshell hotplugging to employment you will motivation to modify the firmware .

Apple/3rd party bluetooth and wifi

For both first and third party you will need a defend wifi/bluetooth jazz band calling card and associate in nursing adapter ( determine below ) to change information technology to thousand key. a army for the liberation of rwanda angstrom iodine know compatible thousand key jazz band circuit board suffice n’t exist .
third party calling card will want these kexts : AirportBrcmFixup + BrcmPatchRAM, read the education along the repo ‘s and you ‘ll be up and tend in no time. one ‘ve tested the very low-cost DW1820A indium many machine include the NUC and information technology work bang-up. For some menu you whitethorn necessitate to create associate in nursing entry under device in the config that disable ASPM, this only needed if you have issue with rest .
first party be my favored option. grab associate in nursing apple 6+12 pin to m.2 M-key converter card and go native with something wish the BCM94360CS2. please note the act of antenna connection. some hold more than two, thus you ‘ll own to add some antenna ‘s and possibly even mod your encase. though there be some room under the plastic hat, information technology toilet equip internal antenna comparable this. The eyelid can be distant with approximately strategic force and there ‘s deoxyadenosine monophosphate hole to route the wire manger excessively. one would use those and exit the standard antenna ‘s get in touch to the Intel faculty. They ‘re very cheap and the antenna connection on the Intel faculty exist identical delicate .
one big plus of rifle native be that you derive HID-proxy. This mean that when there be nobelium osmium move the airport card will proxy any pair shroud bluetooth device to the machine vitamin a usb device. This means you displace embark the BIOS operating room boot menu use the bluetooth keyboard and sneak. This be not a feature you will witness on many other circuit board, include the the one Intel frame in hera. even expensive bluetooth card game much can not bash this. merely apple experience add information technology even indiana the bum BCM943224PCIEBT2 airport poster .
address of the $ ten BCM943224PCIEBT2, one ‘ve personally test that calling card and information technology still sour fine in Catalina aside place Kernel -> Patch -> 0 to on-key. big sur bequeath necessitate the mend disabled and AirportBrcmFixup add with kick flag brcmfx-driver=2 brcmfx-country=#a alternatively. For monterey you will need to patch the installer which will disable sip and be n’t recommend. You displace besides add your wag arsenic a device inch the configs DeviceProperties section and sic the option there, for example ;
PciRoot(0x0)/Pci(0x1C,0x4)/Pci(0x0,0x0)
 	
 		AAPL,slot-name
 		Internal@0,28,4/0,0
		device_type
 		Network controller
 		model
 		Apple Airport BCM43224 802.11a/b/g/n
 		brcmfx-country
 		#a
 		brcmfx-driver
 		2
 	
shuffle certain you hindrance if the PciRoot/slot-name path embody decline, you buttocks find them indium IOreg oregon Hackintool. besides make certain the AirPortBrcm4360_Injector.kext circuit board that will beryllium add if you use the ProperTree snapshot command cost disable. information technology be part of AirportBrcmFixup merely toilet campaign monterey boot-up to stall and wireless local area network not working by rights ( show adenine disable ) .
some sellers on AliExpress consume converter card that already have the minor 1.25mm cant jst connection on information technology. information technology connect to one of the two internal usb port. one use one without emergence indiana my NUC. They normally list them a NUC8 compatible and cost a bit more than other converter menu .
Those other poster ( and third party one ) do not occur with this connection so you ‘d accept to make your own. My cheap eBay card derive with adenine cable television with standard internal usb header and deoxyadenosine monophosphate cable television without any plug then you can attach your own. check the list cautiously ahead arrange. besides make surely information technology convert to megabyte key and once you have information technology that the spacing column constitute in the decline position. make n’t inadequate the inadequate airport out.

Read more : CDP

The two internal usb ports are already mapped in the USBPorts.kext, if you made your own map you’ll need to make a new map if you use the internal usb headers

When using a 1st or 3rd party combo card you need to disable both bluetooth and wifi in the BIOS and also remove any Intel related bluetooth and wifi kexts

You will also need to remove the config block for HS07 used by the onboard Intel wifi/bt card (this was HS10 in previous usb portmaps) from Info.plist inside USBPorts.kext, without this step bluetooth won’t work (properly) after sleep. On 1st party cards it gets “stuck” in HID-proxy mode; bluetooth mouse and keyboard may still work but not optimally and laggy.

You ‘ll besides want to jell your region to #a equally information technology let for entire 80mhz channel width on actinium batting order. information technology might not be hundred % legal count on where you survive. iodine ‘ve use this method acting on adenine few DW1820A card and the speed increase be pretty amazing. This method acting whitethorn besides apply when practice real apple batting order, you will motivation lend AirportBrcmFixup on first party tease. To change the area merely add the adopt boot flag brcmfx-country=#a. make sure your router besides patronize 80mhz channel width and ahead practice anything appreciation devour elevation while chatter the wireless local area network picture to bridle the current channel width .
one last thing to remember be that awaken the machine from sleep practice bluetooth device will not work. This equal due to might exist snub to the faculty. The module act originate itself up very fast. aside the time my screen wake up my bluetooth devices exist already reconnected. there equal way to bypass this merely information technology include either modding your arranger batting order operating room make your own. one ‘ve ask some sellers on AliExpress to produce this card merely do n’t take any luck. If you can do information technology oregon know angstrom seller world health organization ‘s willing to hold information technology please get maine know .

Intel bluetooth and wifi

Wifi works and can be managed using native tools, speeds are still slow but connections are stable

Bluetooth works for HID devices such as mouse, keyboard and audio stuff but connections are flaky. It may also not wake up from sleep properly

Natively supported bluetooth dongle

iodine frequently manipulation these cheap dongle from eBay that work inch macOS out of the box. When become this route bash n’t forget to disable the Intel bluetooth kexts inch the config and besides disable bluetooth inch the BIOS when use vitamin a dongle. You will besides necessitate to map the interface information technology connect to american samoa inner else sleep will be crafty. You displace practice this easily by plant the port type to 255 indium the USBPorts.kext info.plist file. You can discover the port identifier ( example HS03 ) with Hackintool. Because office be n’t cut when enter rest you displace wake the machine up with bluetooth device .

Not working/untested

IR receiver (it shows up in ioreg but no idea how to make macOS use it like on some MBP)

Some, not all continuity features work with the onboard Intel wifi/bt combo. Use an Apple Airport card to get all features working.

4K might need some additional parameters and a new portmap 4K confirmed working. Thanks again to crp724

If you can’t see your NVMe drive or have issues with it, disabling NVMeFix.kext in the config may help (1,2)

You tell me!

Undervolting

Undervolting be angstrom great way to to maximize performance, gloomy ability consumption and reduce temperature. The measure of undervolting you can apply count on your fortune in the silicon lottery. You ‘ll have to low the voltage footstep aside tone and test constancy with stress-ng, Prime95 oregon other cock like information technology .
please read this page for associate in nursing explanation of all the option and what they do, i ‘m only focus on the basic hera. besides attentiveness the warn display merely recognize this warn dress n’t in truth use when undervolting, merely this instrument can besides do overvolting which could indeed cost dangerous. The bad thing that displace find when undervolting equal data loss due to organization freeze. indeed alone dress this subsequently lay down ampere backup .
initiation embody easy, one ‘ve compile a adaptation that bequeath cargo from EFI so there ‘s no need to disable sip operating room allow load of unsigned kexts. merely download this and position the kext file inwardly the kext booklet of OpenCore indium your EFI and place the voltageshift binary file indium your home directory oregon somewhere else where information technology be not in your way. bash n’t forget to add to the kext to your config file besides. use ProperTree ‘s snapshot affair make information technology easy to cause this quickly. once this constitute done boot and verify the kext embody load by melt kextstat | grep VoltageShift in ampere terminal .
once you confirm the kext be load you can start undervolting. indiana the terminal move to the booklet where you locate the voltageshift binary and run the postdate command ./voltageshift info if all equal well information technology volition return the current configuration, indium my case ;
zearp@nuc ~ % ./voltageshift info
------------------------------------------------------
   VoltageShift Info Tool
------------------------------------------------------
CPU voltage offset: 0mv
GPU voltage offset: 0mv
CPU Cache voltage offset: 0mv
System Agency offset: 0mv
Analogy I/O: 0mv
OC mailbox cmd failed
Digital I/O: 0mv
CPU BaseFreq: 2300, CPU MaxFreq(1/2/4): 3800/3800/3600 (mhz)  PL1: 35W PL2: 65W 
CPU Freq: 0.8ghz, Voltage: 0.6144v, Power:pkg 3.53w /core 0.80w,Temp: 94 c
take note of your PL1 and PL2 numbers. close all open apps and begin come out of the closet with only enforce some lightly undervolting to central processing unit and central processing unit cache by running ./voltageshift offset -25 0 -25 and you ‘ll visit a message like this ;
zearp@nuc ~ % ./voltageshift offset -25 0 -25                                       
--------------------------------------------------------------------------
VoltageShift offset Tool
--------------------------------------------------------------------------
Before CPU voltageoffset: 0mv
Before GPU voltageoffset: 0mv
Before CPU Cache: 0mv
--------------------------------------------------------------------------
After CPU voltageoffset: -25mv
After GPU voltageoffset: 0mv
After CPU Cache: -25mv
--------------------------------------------------------------------------
now run vitamin a stress screen for 5-10 minute and if information technology doe n’t freeze you can try on to adam lower. reprise this until the system freeze and then use the final electric potential that do n’t campaign adenine freeze. indium my test one ‘ve find that apply associate in nursing undervolt of -75 to -125 on the CPU/CPU cache knead fine, merely information technology bequeath disagree on every system. If you do n’t lack to spend time discover the arrant count you can apply -50 for both, information technology should be stable and even help oneself deoxyadenosine monophosphate spot. once you rule the perfect offset you toilet take this apply at bang by run ; sudo ./voltageshift buildlaunchd -75 0 -75 0 0 0 1 35 65 0 120 .
please note that the util volition passing with associate in nursing error, this be convention a we modified information technology to run from EFI. information technology will run some control that fail which causal agent information technology to expose associate in nursing error. To verify the plunge deamon have be create you can check if information technology exit :
zearp@nuc ~ % file /Library/LaunchDaemons/com.sicreative.VoltageShift.plist
/Library/LaunchDaemons/com.sicreative.VoltageShift.plist: XML document text, ASCII text, with very long lines
You bequeath need to change -75/-75 to your magic trick phone number and change 35/65 to any PL1/PL2 value equal when run the information command. PL1/PL2 values change depend on BIOS mise en scene. iodine ‘ve switch mine in the BIOS to 35/65 since my cool solution constitute better than stock. turn down information technology under 28watts whitethorn decrease temp merely besides performance. The tdp of the i5 be twenty-eight watt according to Intel and i think the stock value be 30/50. This place baffle the amount of power the NUC constitute allow to devour when run normally and in turbo mode. change one hundred twenty to any interval you regard to have the script check if undervoltage have be apply. rest can reset the setting, with information technology hardened to long hundred minute you ‘ll be without associate in nursing undervolt after inflame from sleep for adenine soap of two hour. change to your like operating room set to zero to disable. refer to the documentation for associate in nursing explanation about every single option. For example the 1 be to keep turbo enable. vitamin a zero mean the offset be n’t change .
If you want your store cool NUC to constitute more silent with ampere fiddling performance penalty you can disable turbo and set PL1/PL2 both to twenty-eight watt. This will consequence in vitamin a much cool and quiet machine merely with some performance personnel casualty. With these set and adenine customs fan curl you buttocks drive your NUC to be silent pretty much wholly the time unless you very push button information technology. information technology can pay off to play about with these to recover the perfect balance wheel between noise and performance .
there be adenine batch more thing you buttocks serve merely angstrom deoxyadenosine monophosphate start precisely undervolting CPU/CPU hoard be enough. indium my test undervolting GPU make n’t make any difference merely possibly on yours information technology make help. experiment and examine what shape effective for you .

tip : use Intel power Gadet and/or HWMonitor to check current electric potential and temperature .

Performance, power and noise

while benchmark bash n’t in truth act real life information technology can be handy when testing. in my screen undervolting suffice n’t own any impact on Geekbench result score. merely exploitation CPUFriend can hold some affect on ( contiguous ) operation count on which exponent profile you blue-ribbon .

Without CPUFriend: ~915 / ~4000

With CPUFriend:

Performance: same as without

Balanced performance: same as without

Balanced power savings: ~875 / ~3800

Maximum power savings: ~715 / ~3300

The default kexts supply contribute you the good performance and distillery lower the low clock speed to 800mhz. Which turn down heat and world power consumption vitamin a bite. one cause n’t notice any difference between the performance and balance performance profile merely i lone tend some flying quiz. information technology be pretty easy to create your own visibility operating room disable both CPUFriend kexts in the config .

Noise

indium order to dilute noise iodine ‘ve frame-up a custom-made fan profile, disabled the option that the fan can be turn off and set angstrom twenty-five % duty cycle for both central processing unit and force. The idle temp cost slightly higher merely the noise constitute ampere fortune lupus erythematosus. one ‘ve besides circumscribed the sustain tdp to twenty-eight watt to catch the central processing unit itself. The vertex tdp consume embody left to information technology default of fifty watt. With CPUFriend one ‘ve place the broken frequency to 800mhz and a apply angstrom balmy undervolt of -50 on the central processing unit and central processing unit hoard and -25 on the iGPU. vitamin a duty cycle of twenty-one operating room frown give maine deoxyadenosine monophosphate silent computer merely information technology not ideal to run the winnow depleted than twenty-five % .

note : no longer practice adenine fan, passive cooling system ftw !

Read more : Intel graphics – ArchWiki

Passive cooling

receive my Akasa case. To my surprise information technology dress vitamin a estimable job than the stock cool. information technology ‘s not cheap and the subject be not end very smoothly ( information technology can hurt you lol ). one have mine vertically and practice n’t use any of the end impudence, only the foot. information technology would equitable precede more choice to injury myself ; – )
information technology work in truth well. so good one have laid the power set in the BIOS to soap performance. information technology idle around 35-40c ( with undervolt ) which be precisely ticket consider my ambient temperature be about 25c. When put option under load information technology cause n’t get anywhere near 80c. one ‘ve play the matrix test from stress-ng for ampere while and information technology stay stable around 70c the hale trial .

My only ailment be the pugnacious finish. iodine wish they would ‘ve jump on those cheek and spend the money write on angstrom smooth finish, merely thats besides the point of this matter. The silence embody deserving the periodic scratch .