ASUS ZenBook Pro Duo 15 UX581 Hackintosh

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

![License](https://img.shields.io/badge/⚖_License-BSD_3_Clause-lightblue?labelColor=3f4551) ![SemVer](https://img.shields.io/badge/SemVer-v0.1.0-important?logo=SemVer&labelColor=3f4551) ![Supported Models](https://img.shields.io/badge/Supported%20Models-UX581GV%20%7C%20UX581LV-important?labelColor=3f4551) ![OpenCore](https://img.shields.io/badge/OpenCore-1.0.0-0c7dbe?logo=Osano&logoColor=0298e1&labelColor=3f4451) ![OCE Build](https://github.com/Qonfused/ASUS-ZenBook-Pro-Duo-15-UX581-Hackintosh/actions/workflows/oce-build.yml/badge.svg?branch=main)

⚙️ 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).
CPU	• Intel Core i9-9980HK • Intel Core i7-9750H	✅	Natively supported.
Graphics	Intel UHD Graphics 630	✅	Full acceleration (with DRM).
Graphics	Nvidia GeForce RTX 2060 6GB	❌	Disabled; no macOS support.
Displays	15.6" Primary Display (OLED, 3840x2160 @ 60 Hz)	✅	Mostly supported (no backlight control).
Displays	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)
	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).
Audio (Realtek ALC294)	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	Intel AX200 (Wi-Fi 6 + Bluetooth 5.0)	✅	Fully supported (with limited Continuity support).
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).
Battery	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.
Sleep / Wake	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:

Generate SMBIOS data with GenSMBIOS
- Follow the Dortania iServices guide to generate new SMBIOS data for your machine.
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.

Qonfused / ASUS-ZenBook-Pro-Duo-15-UX581-Hackintosh

readme