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

• 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

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	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)

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'

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

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.

Contributions of any size to this project are always welcome!

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

BSD 3-Clause License.

• @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.