ASUS ZenBook Pro Duo 15 UX581 Hackintosh

A Hackintosh project for the ASUS ZenBook Pro Duo 15" built on top of the OpenCore bootloader and OCE-Build build manager.

⚡Quick Links

• Current Progress
  • macOS Version Support
  • Hardware Features
  • Software Features
• Getting Started
  • 1. Clone this repository using git
  • 2. Build this repository using OCE-Build
  • 3. Using this EFI with macOS
• Contributing
• License
• Credits

⚙️ Current Progress

Note This repository is still a work in progress.

See this repository's task board and issues page for current progress. Upcoming or planned changes are also tracked on a roadmap board.

Refer to the CHANGELOG or SemVer board for changes implemented per release version.

macOS Version Support:

macOS Version	Status		Minimum version	Maximum version
Sequoia	🚧	In Preview.	(None)	(Latest)
Sonoma	✅	Fully Supported.	(None)	(Latest)
Ventura	✅	Fully Supported.	(None)	(Latest)
Monterey	✅	Fully Supported.	(None)	(Latest)
Big Sur	✅	Fully Supported.	(None)	(Latest)
Catalina	✅	Fully Supported.	10.15.7 (19H1419)	(Latest)

Hardware Features:

Component	Device	Status
CPU	• Intel Core i9-10980HK • Intel Core i7-10750H	✅	Natively supported (since macOS Catalina).
	• Intel Core i9-9980HK • Intel Core i7-9750H	✅	Natively supported.
Graphics	Intel UHD Graphics 630	✅	Full acceleration (with DRM).
	Nvidia GeForce RTX 2060 6GB	❌	Disabled; no macOS support.
Displays	15.6" Primary Display (OLED, 3840x2160 @ 60 Hz)	✅	Mostly supported (no backlight control).
	14" Screenpad Plus Display (IPS, 3840x1100 @ 60 Hz)	🚧	Work in progress (with backlight control).
Interfaces	Built-in Keyboard	✅	Fully supported (with media keys and backlight control).
	Built-in Trackpad	✅	Fully supported (GPIO pinned with multi-touch gestures)
	Touchscreen (Primary Display) (Screenpad Plus Display)	✅	Fully supported (GPIO pinned with multi-touch gestures)
		✅
	Capacitive Stylus	🚧	Work in progress (works without pressure data).
Audio (Realtek ALC294)	Built-in speakers	✅	Fully supported (with volume control).
	Built-in microphone	✅	Fully supported.
Camera	Windows Hello HD Camera	🚧	Work in progress.
Wi-Fi	Intel AX200 (Wi-Fi 6 + Bluetooth 5.0)	✅	Fully supported (with limited Continuity support).
Bluetooth
Storage	Samsung PM981 NVMe SSD	❌	Not supported (requires SSD replacement).
Ports	(Left) • 1x 4.5mm DC-in (19V, 3.42A) • 1x HDMI 1.4 • 1x USB 3.1 Gen 2 Type-A (Right) • 1x USB 3.1 Gen 2 Type-A • 1x 3.5 mm Audio combo jack • 1x Thunderbolt 3 Type-C	✅	Fully supported.
Battery	Built-in Battery	✅	Fully supported (with power reading).
	AC Power Adapter	✅	Fully supported (with hotplug and charge limit feature).

Software Features:

Type	Feature	Status
iServices (iCloud)		✅	Fully supported.
Continuity	Airplay to Mac	✅	Supported.
	Sidecar	✅	Supported.
	Handoff	✅	Supported.
	Continuity Camera	🚧	Untested.
	Universal Clipboard	✅	Supported.
	Universal Control	✅	Supported.
Sleep / Wake	Sleep	✅	Supported.
	Hibernation	✅	Supported.
Battery Indication		✅	Fully supported.

✨ Getting Started

1. Clone this repository using Git

To clone this repository locally with submodules, run the below commands:

git clone https://github.com/Qonfused/ASUS-ZenBook-Pro-Duo-15-UX581-Hackintosh
cd ASUS-ZenBook-Pro-Duo-15-UX581-Hackintosh

2. Build this repository using OCE-Build

This project uses OCE-Build to automatically version and build this repository's EFI.

To build this project's EFI, run either of the below commands at the root of the project:

# In PowerShell
scripts/build.ps1

# In Bash/WSL
scripts/build.sh

Important

To run powershell scripts, you may need to set your execution policy using:

Set-ExecutionPolicy RemoteSigned

You can also download OCE-Build and run the ocebuild build command from the root of the project.

3. Using this EFI with macOS

To enable iServices functionality, you can:

1. Generate SMBIOS data with GenSMBIOS

• Follow the Dortania iServices guide to generate new SMBIOS data for your machine.

2. For local builds of this EFI, patch existing SMBIOS data automatically.

• This is automatically patched each time you run a build using the .serialdata file (using existing data or data generated by GenSMBIOS).
• Refer to the .serialdata.example file for an example of the entry format.

Refer to the Install Guide and Post-Install Guide for installation instructions.

🔥 Contributing

Contributions of any size to this project are always welcome!

Refer to CONTRIBUTING.md for instructions (and tips) on making contributions to this project.

⚖️ License

BSD 3-Clause License.

🌟 Credits

• @shiecldk for their continued contributions and work in the original Zenbook Pro Duo 15" (UX582) OpenCore configuration and guide that inspired this project.
• @UsedDiscord for their contributions and direction helping investigate screenpad and trackpad functionality.
• @wern-apfel for their contribution helping to enable ATKD WMI functionality. -[@danperks] for their contributions in testing and debugging this project.