Folders and files
| Name | Name | Last commit date | ||
|---|---|---|---|---|
██╗ ██╗ █████╗ ██████╗██╗ ██╗███╗ ███╗ █████╗ ████████╗███████╗ ██║ ██║██╔══██╗██╔════╝██║ ██╔╝████╗ ████║██╔══██╗╚══██╔══╝██╔════╝ ███████║███████║██║ █████╔╝ ██╔████╔██║███████║ ██║ █████╗ ██╔══██║██╔══██║██║ ██╔═██╗ ██║╚██╔╝██║██╔══██║ ██║ ██╔══╝ ██║ ██║██║ ██║╚██████╗██║ ██╗██║ ╚═╝ ██║██║ ██║ ██║ ███████╗ ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝ ╚═╝ ╚══════╝
Automates the entire process of creating a bootable OpenCore hackintosh USB. No manual config.plist editing, no hunting down kexts, no macrecovery commands.
Supports Linux, Windows, and macOS as host operating systems.
v1.3.0 is out — Windows users can now download a single HackMate.exe from the releases page — no Python, no venv, no setup.py. Also fixes AMD config.plist crash, Windows SSL error, and macOS lspci error. Config.plist editor added to welcome screen.
If you cloned before June 25th (running from hackmate-linux/): Just run your usual command — HackMate will auto-migrate itself to the new src/ layout and relaunch. No manual steps needed.
If you're on macOS and got a lspci not found error: macOS is now fully supported. Pull the latest and re-run.
If USB formatting fails on Windows: Fixed in latest update. Pull and try again. If it still fails, use the new Already Formatted button — format your USB as FAT32 (GPT) in Disk Management first, then pick that option in HackMate.
If you got sudo: uv: command not found: Don't use sudo uv run. Always run with sudo .venv/bin/python3 src/hackmate.py after setup.
Kaby Lake (7th gen) users: Tahoe now shows as an option for your hardware. Pull the latest and rerun.
git clone https://github.com/riftaway7-code/hackmate.git
cd hackmate
python3 setup.py
sudo .venv/bin/python3 src/hackmate.pyAlways use the full path to the venv Python (.venv/bin/python3) with sudo — not python3 or uv run. sudo does not inherit your PATH so it won't find uv or your user-installed packages.
Download HackMate.exe from the latest release and run as Administrator.
Antivirus false positives: Some AVs (Bkav, Gridinsoft, Zillya) flag the EXE as malware. This is a known false positive with PyInstaller-built executables — every major AV (Defender, Kaspersky, ESET, CrowdStrike, Sophos) reports clean. The EXE is built transparently from source on GitHub Actions: view build logs.
Must be run as Administrator. Right-click PowerShell and select "Run as administrator" before running any of these commands.
git clone https://github.com/riftaway7-code/hackmate.git
cd hackmate
python setup.py
.venv\Scripts\python.exe src\hackmate.pyAlways use .venv\Scripts\python.exe to run HackMate — not python or uv run. The venv ensures all dependencies are available.
- Scans your hardware (CPU, GPU, audio, ethernet, WiFi, touchpad, NVMe, Thunderbolt)
- Shows compatible macOS versions based on your hardware
- You pick a USB drive (internal disks are hidden)
- Fully automated from there:
- Formats USB as FAT32 and creates EFI structure
- Downloads macOS recovery directly from Apple
- Generates SMBIOS (serial, MLB, UUID, ROM)
- Generates config.plist with the correct quirks for your hardware
- Downloads kexts from GitHub releases
- Downloads latest OpenCore release
- Generates SSDTs from your actual DSDT using SSDTTime
CPU generations: Sandy Bridge · Ivy Bridge · Haswell · Broadwell · Skylake · Kaby Lake · Coffee Lake · Comet Lake · Rocket Lake · Alder Lake · Raptor Lake · AMD Ryzen / Threadripper
Laptops tested: ThinkPad T480s, T480, T470, X1 Carbon · Dell XPS 13/15 · HP EliteBook · ASUS ZenBook · Acer Aspire
Platforms: laptops, desktops, mini-PCs
macOS versions: Ventura · Sonoma · Sequoia · Tahoe (macOS 16)
- Run USBToolBox (saved to EFI/HackMate-Extras/) inside macOS to map your USB ports
- Replace the placeholder USBMap.kext with your generated one — or use HackMate's USB Mapping screen
Do I need a Mac to use HackMate? No. HackMate runs on Linux, Windows, and macOS. You can create the USB from any computer.
Will this work on my laptop/desktop? If your CPU is Intel 2nd–13th gen or AMD Ryzen, it very likely will. Run HackMate and it will tell you which macOS versions are compatible with your exact hardware.
Is this the same as following the Dortania OpenCore guide manually? HackMate uses the same tools (macrecovery, SSDTTime, OpenCore) recommended by Dortania, but automates every step. The output EFI is equivalent to what you'd build manually — just without hours of work.
Can I hackintosh a ThinkPad? Yes — HackMate was built and tested on a ThinkPad T480s. Intel WiFi (itlwm + HeliPort), trackpad (VoodooI2C), and all common ThinkPad hardware is supported.
Does it work on Windows without Python? Yes. Download HackMate.exe from the releases page — no Python or dependencies needed.
My antivirus is flagging HackMate.exe Known false positive with PyInstaller-built executables. Every major AV (Defender, Kaspersky, ESET) reports clean. The EXE is built from source on GitHub Actions — view build logs.
HackMate is free and open source. If it saved you hours of config.plist hell, consider sponsoring:
- macOS is sourced directly from Apple's servers
- Uses the same tools recommended by the Dortania guide (macrecovery, SSDTTime, OpenCore)
- Tested on ThinkPad T480s (i5-8350U, Intel 8265 WiFi, Kaby Lake-R)
- Auto-updates itself on launch via GitHub