README.md

ASUS ZenBook Duo 14 UX481 Hackintosh

A Hackintosh project for the ASUS ZenBook Duo 14" 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 i7-10510U • Intel Core i5-10210U	✅	Natively supported (since macOS Catalina).
Graphics	Intel UHD Graphics 620	✅	Full acceleration (with DRM).
	Nvidia GeForce MX250 2GB	❌	Disabled; no macOS support.
Displays	14" Primary Display (IPS, 1920x1080 @ 60 Hz)	✅	Fully supported (with backlight control).
	12.6" Screenpad Plus Display (IPS, 1920x515 @ 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)
	(Physical) Trackpad Buttons	✅	Fully supported.
	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 AX201 (Wi-Fi 6 + Bluetooth 5.0)	✅	Fully supported (with limited Continuity support).
Bluetooth
Storage	Intel 660p NVMe SSD	✅	Fully supported (with power management).
Ports	(Left) • 1x 4.5mm DC-in (19V, 3.42A) • 1x HDMI 1.4 • 1x USB 3.1 Gen 2 Type-A • 1x USB 3.1 Gen 2 Type-C (Right) • 1x USB 3.1 Gen 1 Type-A • 1x 3.5 mm Audio combo jack • 1x MicroSD card reader	✅	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	AirDrop	❌	Unsupported.
	AirPlay to Mac	✅	Supported.
	Sidecar	❌	Unsupported.
	Handoff	✅	Supported.
	Continuity Camera	❌	Unsupported.
Universal Clipboard	✅	Supported.
Universal Control	❌	Unsupported.
Sleep / Wake	Sleep	✅	Supported.
	Hibernation	✅	Supported.
Battery Indication		✅	Fully supported.

✨ Getting Started

1. Clone this repository using Git

To clone this repository locally, run the below command:

git clone https://github.com/Qonfused/ASUS-ZenBook-Duo-14-UX481-Hackintosh
cd ASUS-ZenBook-Duo-14-UX481-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.
• @1Revenger for their contributions in fixing trackpad buttons and multi-touchscreen inputs in VoodooI2CHID.
• @wern-apfel for their contributions helping to enable ATKD WMI functionality.