How to Fix HackMate – a TUI tool that fully automates OpenCore EFI creation onto your USB
This is a comprehensive guide to resolve the issue described in the post. Ensure you follow all steps carefully.
1. Prerequisites
- Hardware compatibility: Verify your exact Mac or PC model, CPU, GPU, and Wi-Fi/Bluetooth chipset.
- Required tools: Have OpenCore, OCLP, ProperTree, and a USB installer ready.
2. Compatibility Snapshot
- Check if your hardware is fully supported by the target macOS version. OCLP supports many models, but some have limitations.
3. Installation Preparation
- Configure your BIOS/UEFI settings appropriately.
- Create a USB installer matching your target macOS.
4. EFI and config.plist Review
- Review your EFI folder layout: BOOT, OC/ACPI, OC/Drivers, OC/Kexts, OC/Tools.
- Ensure essential kexts like Lilu, VirtualSMC, and WhateverGreen are present.
5. Post-Installation
- Run OCLP Post-Install Root Patch if you are on an unsupported Mac.
- Check graphics acceleration, Wi-Fi, and Bluetooth.
6. Troubleshooting
Reported issue
- For this specific issue, verify your kexts and patches are up to date.
- Check system logs and use verbose mode to identify errors.
Common Hackintosh/OCLP checks
- Stuck at Apple logo: Check verbose logs.
- No graphics acceleration: Verify Metal support.
7. Dual Boot and Advanced Configuration
- If dual booting, use separate disks when possible to avoid EFI overwrites.
8. Verification, Maintenance and Rollback
- Verify the fix worked and keep dated EFI archives.
- Have a rollback plan using Time Machine or a previous EFI.
9. References and Glossary
Original Question: "HackMate – a TUI tool that fully automates OpenCore EFI creation onto your USB"
HackMate – a TUI tool that fully automates OpenCore EFI creation onto your USB
I'm building a tool called HackMate that automates the entire process of creating a bootable OpenCore hackintosh USB. No manual config.plist editing, no hunting down kexts, no macrecovery commands.
BEFORE I SAY ANYTHING! This isn't a beast tool or distro, it automates the Dortania guide steps using the same tools they recommend (macrecovery, SSDTTime, acidanthera kexts from GitHub releases). macOS comes directly from Apple. Nothing is patched or modified!
Here's what it does automatically:
Scans your hardware — CPU generation/codename, iGPU, audio codec (reads /proc/asound), ethernet chipset, WiFi chipset, touchpad type (PS/2, I2C-ELAN, I2C-HID, RMI, etc.), NVMe, Thunderbolt
Shows compatible macOS versions — filtered by your CPU gen and GPU vendor (e.g. no Sonoma+ for pre-7th gen, no Mojave/Catalina for Nvidia)
You pick your USB drive — only shows actual USB drives, filters out internal disks
Then it runs fully automated:
- Formats USB as FAT32, creates EFI/OC/BOOT structure
- Downloads macOS recovery directly from Apple CDN via macrecovery
- Generates a valid SMBIOS (serial, MLB, UUID, ROM with real Apple OUIs)
- Generates config.plist with correct framebuffer patches, ALC layout-id, booter/kernel quirks for your hardware
- Downloads the right kexts from GitHub releases (104 kexts in the database, it picks based on your hardware)
- Downloads latest OpenCore release and copies BOOTx64.efi, OpenCore.efi, drivers
- Generates SSDTs automatically using SSDTTime — reads your actual DSDT from /sys/firmware/acpi/tables/DSDT, no dumping required
What you still need to do after:
- Run USBToolBox to map your USB ports and replace USBMap.kext
- That's basically it
Tech: Python + Textual TUI. Runs on Linux (needs root for disk access). Color-coded logs, and an "Advanced" panel that shows every raw command being run.
Tested on a ThinkPad T480s (i5-8350U, UHD 620, ALC257, I219, Intel 8265 WiFi). Successfully booted Tahoe recovery.
Still working on it — would love feedback from people with different hardware to see how well the kext selection holds up.
I plan on building it for windows too, but for now, only available on linux distrubutions, any of them, as long as you have python installed (v. 3.10+)
[link] [comments]
Post a Comment