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
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 --recurse-submodules https://github.com/Qonfused/ASUS-ZenBook-Pro-Duo-15-UX581-Hackintosh
cd ASUS-ZenBook-Pro-Duo-15-UX581-Hackintosh

If you've cloned this project without resolving submodules, you'll need to initialize them:

git submodule init
git submodule update

Note: Optionally, you can add git aliases to always resolve submodules:

git config --global alias.clone-all 'clone --recurse-submodules'
git config --global alias.pull-all 'pull --recurse-submodules'

2. Build this repository using OCE-Build

Note OCE-Build must be run in a Linux or macOS environment.

For Windows users, refer to aka.ms/wslinstall and aka.ms/wsl2 for instructions on installing wsl and upgrading to the wsl2 kernel (recommended).

• You can install a Linux distribution directly from the Microsoft Store (e.g. Ubuntu 20.04.5 LTS).
• Alternatively, you can setup devcontainers with Docker and VSCode to run a containerized Linux environment on top of wsl. The devcontainer for this project will setup and build the project automatically upon container creation.

For Linux users (or wsl), ensure you have the following commands available:

• cURL
  • Check with curl --version
  • Install with sudo apt install curl
• bsdtar
  • Check with bsdtar --version
  • Install with sudo apt install libarchive-tools
• iasl
  • Check with iasl -v
  • Install with sudo apt install acpica-tools

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

# Run build pipeline for the UX581GV EFI
bash scripts/build.sh --UX581GV
# Run build pipeline for the UX581LV EFI
bash scripts/build.sh

You can run a validation script to check the EFI build output with:

# Verify build output for the UX581GV/LV EFI
bash scripts/validate-efi.sh

3. Using this EFI with macOS

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

Note To enable iServices functionality, please refer to the notice in the build-generated .serialdata file under the src/ directory for instructions on validating your serial number. Remember that you can re-generate this data by running bash scripts/lib/gen-serial.sh or by removing this file and re-running the build script.

You can optionally instead download GenSMBIOS follow the iServices guide to generate new SMBIOS data for your machine. You'll then need to store your SMBIOS data in a new .serialdata file:

MLB:                String | "M0000000000000001"
ROM:                Data   | <112233445566>
SystemProductName:  String | "MacBookPro16,4"
SystemSerialNumber: String | "W00000000001"
SystemUUID:         String | "00000000-0000-0000-0000-000000000000"

You can apply these values by running bash scripts/lib/patch-serial.sh or by re-running the build script.

🔥 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.