macOS Big Sur & Catalina & Mojave & High Sierra on XiaoMi NoteBook Pro 2017 & 2018

English | 中文

• Configuration
• Current Status
  • Clover
  • OpenCore
• Installation
  • First-time installation
  • Build
  • Upgrade
• Improvements
• FAQ
• Changelog
• A reward
• Credits
• Support and discussion

• Ethernet may not work on macOS10.15, view #256
• In macOS10.15, you need to update Wireless-USB-Adapter Driver
  • If you are not using macOS10.15, it's still recommended to update the driver above
• Discrete graphic cardis not working, since macOS doesn't support Optimus technology
  • Have used SSDT-DDGPU to disable it in order to save power
• Fingerprint sensor is not working
  • Have used SSDT-USB to disable it in order to save power
• Intel Bluetooth may cause sleep problems and does not support some Bluetooth devices
  • View Work-Around-with-Bluetooth
• Intel Wi-Fi (Intel Wireless 8265) could work by additional configurations
  • Buy a USB Wi-Fi dongle or supported wireless card
  • Use itlwm and HeliPort or Black80211-Catalina to drive Intel Wi-Fi
• Realtek USB SD Card Reader (RTS5129) is not working
  • Have used SSDT-USB to disable it in order to save power
• Everything else works well

• Support macOS10.13 ~ macOS10.15.6, but not macOS11+
• Should Clean NVRAM after using OpenCore
  • Press Fn+F11 in Clover boot page

• Support macOS10.13 ~ macOS11.0 beta 4 (20A5343i)
• Software in Windows may lose activation due to different hardware UUID generated by OpenCore
  • According to OpenCore Official Configuration, you can try to inject the original firmware UUID to PlatformInfo - Generic - SystemUUID in /OC/config.plist
• Should Clean NVRAM after using Clover
  • Press Space in OpenCore boot page, and then select Reset NVRAM entry
• Limited theme

• Please refer to the following installation tutorials
  • Xiaomi Mi Notebook Pro High Sierra 10.13.6
  • Xiaomi Mi Notebook Pro MacOS Catalina Installation Guide || ENGLISH
• or video tutorials
  • Xiaomi NoteBook PRO HACKINTOSH INSTALLATION GUIDE !!!
  • GUIA HACKINTOSH ESPAÑOL 2020 || Instalación de macOS Catalina Xiaomi Mi Notebook Pro
• If the trackpad doesn't work during the installation, please plug a wired mouse or a wireless mouse projector before the installation. After the installation completes, open Terminal.app and run sudo kextcache -i /. Wait for the process ending and restart the device. Enjoy your trackpad!
• Complete EFI packs are available in the releases page.
• Please don't clone or download the master branch for daily use.

• Build the latest beta EFI by running the following command in Terminal:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/daliansky/XiaoMi-Pro-Hackintosh/master/makefile.sh)"

• Or run the following command in Terminal:

git clone --depth=1 https://github.com/daliansky/XiaoMi-Pro-Hackintosh.git
cd XiaoMi-Pro-Hackintosh
./makefile.sh

• Some advanced usages are:

# Ignore errors when the script is running
./makefile.sh --IGNORE_ERR
# Bundled with Chinese verison Docs
./makefile.sh --LANG=CN
# Preserve work files during the building stage
./makefile.sh --NO_CLEAN_UP
# Bypass GitHub API
./makefile.sh --NO_GH_API
# Build the latest beta EFI with pre-release kexts
./makefile.sh --PRE_RELEASE=Kext
# Build the latest beta EFI with pre-release OpenCore
./makefile.sh --PRE_RELEASE=OC

• A complete replacement of BOOT and CLOVER(or OC) folders is required. Delete these two folders and copy them from the release pack.
• You can also update Clover EFI by running the following command in Terminal:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/daliansky/XiaoMi-Pro-Hackintosh/master/install.sh)"

• Use ALCPlugFix to fix unworking jack after replug
• Use itlwm and HeliPort or Black80211-Catalina to drive Intel Wi-Fi
• Use DVMT_and_0xE2_fix to set DVMT to 64mb and unlock CFG
• Use NVMeFix to enable APST on NVMe SSDs
• Use xzhih's one-key-hidpi to improve quality of system UI
  • Support 1424x802 HiDPI resolution
  • On macOS > 10.13.6, to enable higher HiDPI resolution (<1600x900), you need to use DVMT_and_0xE2_fix to set DVMT to 64mb first and then change the value for framebuffer-flags to CwfjAA== in config.plist - Devices (DeviceProperties) - Properties (Add) - PciRoot(0x0)/Pci(0x2,0x0)
• Use one-key-cpufriend to modify CPU power management

You need to rebuild the kext cache after every system update. Use Kext Utility.app or type sudo kextcache -i / in Terminal.app. Then restart. If this still doesn't work, try to press F9.

Starts from VoodooI2C v2.4.1, the click down action is emulated to force touch, which causes the failure of click down and drag gestures. You can turn off Force Click in SysPref - Trackpad or choose three finger drag in SysPref - Accessibility - Mouse & Trackpad - Trackpad Options.

If you have black screen for five minutes and get no response from the device, please force restart your laptop(Long press power button) and choose Boot macOS Install from ~ entry.

For Clover users, press Fn+F11 when you are in Clover boot page. Then Clover will refresh nvram.plist, and lock message should be removed.
For OC users, press Esc to enter the boot menu during startup. Then, press Space key and choose Reset NVRAM.

It is not recommended to open FileVault. You can press Fn+F3 in the Clover boot page and choose the icon with FileVault. Then you can boot in the system and close FileVault.

Many people met this problem by using the new version of AptioMemoryFix.efi. A workaround is to delete AptioMemoryFix.efi (or OcQuirks.efi, OpenRuntime.efi, and OcQuirks.plist) in /CLOVER/drivers/UEFI/ and replace it with the old version provided in #93.

Also make sure Sandbox and Hyper-V functions in Windows 10 are disabled.

First, in macOS, open SysPref - Startup Disk. Choose the target system.
Then, open /EFI/OC/config.plist, and turn off ShowPicker.
When you want to switch OS, press Esc during startup to call the boot menu.

Turn on AudioSupport and PlayChime in /OC/config.plist - UEFI - Audio.

You can view Changelog for detailed information.

All the project is made for free, but you can reward me if you want.

Wechat	Alipay

• Thanks to Acidanthera for providing AppleALC, AppleSupportPkg, HibernationFixup, Lilu, NVMeFix, OcBinaryData, OpenCorePkg, VirtualSMC, VoodooInput, VoodooPS2, and WhateverGreen.
• Thanks to apianti, blackosx, blusseau, dmazar, and slice2009 for providing Clover.
• Thanks to daliansky for providing OC-little.
• Thanks to FallenChromium, jackxuechen, Javmain, johnnync13, Menchen, Pasi-Studio, qeeqez, and Bat.bat for valuable suggestions.
• Thanks to hieplpvip and syscl for providing sample of DSDT patches.
• Thanks to OpenIntelWireless for providing IntelBluetoothFirmware.
• Thanks to RehabMan for providing EAPD-Codec-Commander, EFICheckDisabler, OS-X-Clover-Laptop-Config, OS-X-Null-Ethernet, and SATA-unsupported.
• Thanks to VoodooI2C for providing VoodooI2C.

• Mi Notebooks supported by other projects:

  • Mi-Gaming-Laptop by johnnync13
  • Mi-NB-Air-125-6y30 by johnnync13
  • Mi-NB-Air-125-7y30 by influenist
  • Mi-NB-Air-133-Gen1 by johnnync13
  • Mi-NB-Air-133-2018 by johnnync13

• tonymacx86.com:

  • [Guide] Xiaomi Mi Notebook Pro High Sierra 10.13.6

• QQ:

  • 247451054 小米PRO黑苹果高级群
  • 137188006 小米PRO黑苹果
  • 689011732 小米笔记本Pro黑苹果