Skip to content

Latest commit

 

History

History
83 lines (58 loc) · 10.4 KB

README.md

File metadata and controls

83 lines (58 loc) · 10.4 KB
Raw

ASUS Zenbook 13 Hackintosh

This is a pre-built OpenCore Hackintosh EFI for ASUS Zenbook 13 laptops. This has been tested on the BX325J (aka UX325J) model, but also should work with others as long as they have an Intel Ice Lake processor, the closer your model is to mine, the better. You can even go as far as trying this on a completely different laptop with an Ice Lake processor, max it doesn't boot or some other things don't work, you can always edit the EFI folder.

Notes

I am not responsible for bricked devices, data lost, thermonuclear war, or you getting fired because macOS didn't boot. Please follow the instructions properly and take a backup of your data before proceeding. YOU are choosing to make these modifications, and if you point the finger at me for messing up your device, I will laugh at you.

What's not working

  • Sleep: You'll have to disable it by running sudo pmset disablesleep 1 in the Terminal app. The screen can still turn off after a few minutes or after you close the lid.

  • Touchpad Numpad: No fix avalible.

  • Managing keyboard backlight: You have to turn it on to your desired intensity in a supported OS and then reboot to macOS. At least it turns off when you close the lid, and then turns back on when opened (probably because hardware manages that).

  • Bluetooth is a bit buggy: If you try to connect to a Bluetooth device and it immidiatly dissconnects, type sudo purge in the terminal (then type in your password), unpair the device, and pair it again.

  • Sometimes Settings app not starting: Similar fix to the Bluetooth one, just type sudo purge into the terminal (then type in your password) and after it finished, open Settings again.

If you are able to fix any of these or find a non-listed issue, please file a pull request or an issue.

What's working

Everything not listed in the previus section.

Prerequisites

  • A brain with at least 100 IQ.

  • If you use Windows, make sure BitLocker is turned off.

  • Disable secure boot: Go into the UEFI setup by rebooting your computer and holding F2 (if it just boots into the OS, you can try other keys on the top of your keyboard). After you see the cool UEFI screen (it should look like mine if you have an ASUS), press F7 to enter advanced mode, go to the Security tab, then into "Secure boot" and change "Secure boot control" to Disabled. Now press F10 and then Ok to save your changes and reboot.

  • Find out your audio driver codec if you have an (even slightly) different device model: It should be something like ALC*** with Realtek and CX**** with Conexant. Search up a tutorial on how for your OS online (you'll see why in step 7), I won't go into detail here as the codec included works on my model.

How to install

  1. Download the latest EFI from the releases page. Then, go to the the installer website, and download the same version you downloaded from releases. I recommend downloading the torrent as it is fast, but you will need a torrent client. You will now be redirected to a site called linkvertise, turn off your adblocker here, and click on free access with ads. Click on "I'm interested" then on "Explore web page" and on the webpage wait a few seconds, then close the tab and go back to linkvertise. Now click on the tiny "I already completed this step" button, and now you have access to the download.
  2. After you've downloaded them, prepare a USB that is at least 16 GBs in size, and attach it to the computer. In this step everything on the USB will be erased, so back them up before proceeding. Now download and install BalenaEtcher and and inside it, select the .raw installer you just downloaded, then select the USB device, and click Flash. This will take some time.
  3. Now prepare the partitions. Use something like GParted on a live Linux USB, or other partition software on Windows. If you want to dual-boot (which I recommend, no Hackintosh can be perfect), also give space to the future macOS (I think you'll need minimum 40 GBs), it should be a filesystem that macOS allows to erase (FAT32, NTFS or HFS+) because we will format it as APFS later. Also give some space (like 200 MBs) to a new EFI partition formatted as FAT32, and copy my EFI folder there. Make sure to unzip it, and that the EFI folder inside the partition contains the Boot and OC folders, not another EFI. If it does, rename the EFI/EFI/ folder to something else, and move it onto the root of the USB drive, delete the EFI folder you moved it out from, and name it back to EFI.
  4. Now, reboot your computer, and press the UEFI key (for me, it's F2, but if it doesn't work, try other Fn keys, Escape or delete). Press F8 to select the boot device, and select your EFI partition (not the USB!), most likely called UEFI OS, and when you see the options, select "Install macOS XXX" with an orange Apple. It can take a minute to boot, don't worry.
  5. After it loaded, select the language, click Continue, and double-click Disk Utility, click on this button: the button, and select "Show all devices", now if you wanted to dual-boot, select the macOS partition (NOT THE EFI) it's mostly identifiable by the size, click Erase and name it something like macOS, then proceed with the deletion. If you didn't want to dual-boot, do the same, just with your previus OS partition. After it finished, click Done, and the red window button to go back.
  6. Now double-click the Install macOS XXX button, continue, accept the agreement, in which they specifically tell you only to install on a Mac, and choose the partition you just named macOS (or any other name) and continue. This will take some time, so grab a cup of c̶o̶f̶f̶e̶e̶ water while you wait. The computer will turn off miltiple times while installing, but that is normal. If it turns off, you can pull out the USB drive (press a button if only the screen turned off), turn the computer back on, and the installation should automatically continue. These turn-offs can also happen during a macOS update if I remember correctly.
  7. After it installed and booted, install OpenCore Configurator, go to SMBIOS, then select the MacBook model from the gray drop-down menu below that you want to spoof (I recommend MacBook8,2). Go trough the setup, and check if audio (and microphone) is working. If it is, skip step 8.
  8. If not, go to the AppleALC supported codecs page, search with Cmd+F (Cmd is the Windows key) to find your audio driver codec, and save the possible layouts onto your desktop (a cool macOS feature, select and hold the text for a while and drag it onto your desktop to save it). Install OpenCore Configurator. Now in Finder, go into your EFI partition, if you didn't name it, it's probably called NO NAME, and go into EFI, OC, and open config.plist using OpenCore Configurator. Now go to the NVRAM tab, select 7C436110-AB2A-4BBB-A880-FE41995C9F82 and double-click the value of boot-args. Change the value of alcid to the number of one of the supported codecs you have in the file on your desktop, save, and reboot. Check if sound is working again, and if not, change the alcid to another number from the supported codecs, save and reboot, and repeat this until the audio is working.
  9. Maybe even install a PC keyboard layout like this Hungarian PC keyboard layout for Mac. Search online to find more layouts. Tough I stopped using that layout, because I want to get used to where special characters are on Mac. (in the future, I plan to buy a Mac, but don't worry, I will keep this computer so I can still maintain this)
  10. Enjoy!

I get gray screen in recovery mode, what do I do?

If you get a gray screen in recovery, it also means that you may not see updates in settings, for me, I couldn't even update from the full macOS installer because it said "A snapshot is currently set to boot that is not the currently booted snapshot.", so follow this easy way to fix that.

Reset your NVRAM from the boot entry "Reset NVRAM.efi". If it doesn't work, try resetting your NVRAM in your installer USB's "Reset NVRAM" boot entry.

How to update to a new macOS version

If it's a small update, like from 14.0 to 14.1, it's as simple as going into the settings and updating it in the software update menu. If there is a macOS update, but Settings says "Your system is up to date.", refer to "I get gray screen in recovery mode, what do I do?".

However, if it is a bigger update like from 14.0 to 15.0, you can't do it his way, it won't let you download for some reason. Instead, you have to go to the App Store, search up the update by it's (code)name and download the full installer (it will redirect you to the settings) and then replace your EFI folder with a newer version after I've released it. Only start the install process after I've released a new EFI, or do it yourself if I take a long time (doing yourself has some risks though, so I recommend you make a Time Machine backup before doing that)! Just downloading before I haven't released a new one yet and quitting the installer is okay. After that, you can open the Install macOS xxx app, and follow the steps to install the update.

These steps might change as I haven't gotten to test it on an actual update except for Ventura and my EFI was a little different then, but it may have been fixed now. I will test it again once macOS 15 comes out.

Credits

devboloji for the base EFI

Olarila for the installer

OpenIntelWireless for Wi-Fi and Bluetooth kexts

acidanthera for a lot of kexts!

KingOfFright for it's ACPIBatteryManager (battery status) kext fork. An earlier fork is made by RehabMan and the original is by gsly.

Apple for macOS

...And many others!

If you like the project, star this and Infinix-Hackintosh-Opencore-Guide. Also consider donating to Olarila!