ASUS Vivobook S15 S531FL Hackintosh

OpenCore version: 1.0.0

Guide used: https://dortania.github.io/OpenCore-Install-Guide/

Updated 17 July 2024 for macOS 14.5, will update again when 15.0 is released

This EFI may work on other ASUS laptops with similar specs, use it at your own risk!

You may use older versions of macOS with this EFI, just replace AirportItlwm.kext with your desired version accordingly and rebuild CPUFriendDataProvider.kext

My Specs

ASUS Official Website
CPU: Intel Core i7-8565U
GPU: Intel UHD 620 & Nvidia MX250
RAM: 8GB Internal + 8GB Slotted DDR4 2133MHz
Storage: Intel 660p 512GB
Wifi/BT Card: Intel(R) Dual Band Wireless AC 8265
Touchpad: ELAN1200
BIOS revision: Version 301

Working:

CPU & Full Power Management (800MHz min freq)
GPU QE/CI with 2GB VRAM & Brightness adjustment
HiDPI with framebuffer patch to run any HiDPI resolution
Wifi & Bluetooth
Sleep (S3 state)
Sound (Internal speaker) with boot chime
All USB ports including Micro SD slot
Native battery charging limiter to 83%, toggle in settings

Not Working:

UVC IR Webcam
Nvidia MX250
Keyboard Backlight

Issues:

CPU thermal throttles at 70C under heavy load instead of 95C. Clock speed and Power draw drops to 2.5GHz and 12W respectively. This issue also occurs on some real MacBooks. There is currently no known fix.

Untested:

HDMI (probably need to patch framebuffer)
Multicombo headphone jack (probably need VerbStub.kext)
Apple features such as Continuity, AirDrop, iMessage and FaceTime as I don't have an iOS device. (App Store works)

Pre Installation:

The EFI folder in this repo is the final setup of this hack. Please follow the official guide and remove unnecessary kexts, SSDTs and modify the config.plist before booting into the installer to install macOS.

Post Installation Stuff:

Monitor your CPU, GPU, fan speed, memory usage and more
Enable HiDPI by following steps from this website and with this app
Calibrate your display white point with this accessibility option
Build your own Voltageshift.kext for undervolting without disabling SIP
Automate applying undervolt on boot & waking from sleep with Hammerspoon
- Paste this in init.lua (modify to your username)
- Following code below has power limits set when plugged in/on battery. Change accordingly to suit your needs

function sleepWatchFunction(eventType)
  if (eventType == hs.caffeinate.watcher.systemDidWake) then
    batteryWatchFunction()
   end
end

function batteryWatchFunction(eventType)
  hs.execute("/users/yongj1e/voltageshift offset -121 -100 -100 -100 -100 0")
  if (hs.battery.powerSource() == 'AC Power') then
    hs.execute("/users/yongj1e/voltageshift power 25 25")
  else
    hs.execute("/users/yongj1e/voltageshift power 5 5")
  end
end

sleepWatcher = hs.caffeinate.watcher.new(sleepWatchFunction)
sleepWatcher:start()

batteryWatcher = hs.battery.watcher.new(batteryWatchFunction)
batteryWatcher:start()
batteryWatchFunction()

Get a powerful systemwide EQ with Apple's AU Lab and BlackHole
- 1. Install both AU Lab & BlackHole.
- 1. Follow steps here
- 1. Open AU Lab, select "BlackHole" as input device and your desired audio device as output.

y0ngj1e/ASUS-S531FL-Hackintosh-OpenCore