This repository provides a comprehensive set of scripts, configuration files, and precompiled bootloader components to run macOS as a guest operating system on Linux hosts using QEMU/KVM and the OpenCore bootloader. It is not a traditional application but rather an infrastructure-as-code project that automates the creation of a virtual Hackintosh environment. The codebase includes a Python script (`fetch-macOS-v2.py`) to download macOS recovery images from Apple's servers with cryptographic verification, shell scripts to launch QEMU with the appropriate CPU flags, firmware, and device emulation, and a set of OpenCore EFI binaries (kexts, drivers, ACPI tables, icons) tailored for macOS compatibility. The project also documents GPU passthrough, USB passthrough, kernel debugging, and reverse engineering of macOS VM detection. While the repository is highly popular and actively maintained, the code quality is uneven: many shell scripts are boilerplate-heavy with hardcoded paths, and the prebuilt binaries are opaque, making the project more of a curated recipe collection than a polished software product. The most reusable components are the macOS downloader script and the OpenCore disk image builder, which can be extracted and adapted for other virtualization workflows.
This repository provides a complete OpenCore EFI configuration for running macOS on a Gigabyte Z490 Vision G motherboard with an Intel i9-10850K CPU. It includes pre-built ACPI tables (SSDTs), kexts, drivers, boot themes, and detailed documentation for hardware support such as audio (ALC1220), Ethernet (I225-V), USB mapping, graphics (UHD 630 / RX 580), and power management. The repo is not a software application but a curated set of configuration files and binary assets for a specific Hackintosh build. It also contains system reports and benchmark results for reference. The primary value is as a drop-in EFI folder for users with identical hardware, and as a reference for ACPI patching and kext selection on Comet Lake platforms.