Highly engineered. Optimized kernel. Intelligent boot engine.
OSX4VM is a hand-crafted OpenCore + QEMU/KVM configuration for running macOS on Windows (via WSL2) or native Linux. Built for maximum responsiveness, real Mac-like behavior, and the cleanest possible implementation.
git clone https://github.com/ltnproject/OSX4VM.git
cd OSX4VMBefore running, make sure the following are in place:
- Virtualization enabled in your BIOS (VT-x for Intel, AMD-V/SVM for AMD)
- WSL2 installed (Windows users) — or a native Linux environment
- QEMU and KVM installed on your system
- Python 3 available in your terminal
Not sure if virtualization is enabled? Check Task Manager → Performance → CPU and look for Virtualization: Enabled. If it shows Disabled, enter your BIOS and enable it before continuing.
Download the official macOS Recovery image directly from Apple's servers. Supports macOS Tahoe (26) and earlier.
python3 fetch_macos.pyCreate a high-performance QCOW2 virtual disk. 64 GB minimum, 128 GB recommended.
qemu-img create -f qcow2 mac_hdd.qcow2 128GLaunch the boot engine. It automatically detects your hardware, verifies KVM health, and optimizes memory mapping.
chmod +x boot.sh && ./boot.shOnce OpenCore loads:
- Select macOS Base System
- Open Disk Utility and format your virtual drive as APFS
- Close Disk Utility and proceed with the installation
- Reboot when prompted — you're done
| Component | Description |
|---|---|
OpenCore/config.plist |
Hand-tuned OpenCore config with custom ACPI & RTC patches |
fetch_macos.py |
Direct Apple CDN fetcher with automated BaseSystem logic |
boot.sh |
Diagnostic boot engine with dynamic RAM/core allocation |
- Advanced ACPI & RTC Patches — Real Mac-like power behavior
- Power Management Optimizations — Tuned for KVM host environments
- Enhanced WSL2 SMBios Data — Seamless integration on Windows
- Real-time KVM Health Check — Validates your setup before every boot
- Auto-Hardware Optimization — Detects and adapts to your host machine
- Dynamic RAM/Core Allocation — Maximizes guest performance automatically
- macOS Tahoe (26) Support — Always up to date with the latest releases
The OpenCore configuration lives at OpenCore/config.plist. It includes custom kernel tweaks and resource allocation logic not found in standard repositories. Edit with caution — most users will not need to touch this file.
| Platform | Status |
|---|---|
| Windows + WSL2 | ✅ Fully supported |
| Native Linux (KVM) | ✅ Fully supported |
| macOS host | ❌ Not supported |
Is this optimized? Yes. This version includes custom kernel tweaks and resource allocation logic not found in standard repositories. Hand-tuned ACPI patches ensure real Mac-like power behavior.
Which macOS versions are supported?
All modern macOS versions up to and including Tahoe (26). Select your target version when running fetch_macos.py.
© 2026 Ltn Project. Privacy and power.
For more detailed information, visit github.com/ltnproject/OSX4VM