# drdonk/unlocker

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/drdonk-unlocker).**

3,840 stars · 527 forks · Go · mit

## Links

- GitHub: https://github.com/DrDonk/unlocker
- awesome-repositories: https://awesome-repositories.com/repository/drdonk-unlocker.md

## Description

Unlocker is a patching tool designed to enable the installation and booting of macOS guest operating systems on non-Apple hardware. It functions as a macOS guest enabler by modifying virtualization software binaries to bypass hardware restrictions and support OS combinations that are not supported by default.

The project provides a mechanism to emulate Apple-specific device signatures by intercepting calls between the virtual machine manager and the hardware. It also includes a driver image provider that delivers ISO images containing the necessary utilities and drivers for guest installations.

The software covers binary patching, checksum-based version verification to ensure patch compatibility, and state-based reversion logic to restore software to its original factory state. It also manages the provisioning of guest tool images and the verification of patch status.

## Tags

### Operating Systems & Systems Programming

- [macOS Virtualization](https://awesome-repositories.com/f/operating-systems-systems-programming/macos-virtualization.md) — Enables the installation and booting of macOS guest operating systems on non-Apple hardware.
- [Hypervisor Hooking](https://awesome-repositories.com/f/operating-systems-systems-programming/hypervisor-hooking.md) — Intercepts calls between the virtual machine manager and hardware to emulate Apple-specific device signatures.
- [macOS Proxmox Virtualization](https://awesome-repositories.com/f/operating-systems-systems-programming/macos-proxmox-virtualization.md) — Functions as a system for bypassing hardware restrictions to run macOS virtual machines on non-Apple hardware.
- [Virtualization Software Patching](https://awesome-repositories.com/f/operating-systems-systems-programming/virtualization-software-patching.md) — Applies and reverts modifications to virtualization tools to enable unsupported guest operating systems.
- [VMware macOS Unlockers](https://awesome-repositories.com/f/operating-systems-systems-programming/vmware-macos-unlockers.md) — Enables the installation and booting of macOS guest operating systems on VMware virtualization software.
- [Patch Version Verifications](https://awesome-repositories.com/f/operating-systems-systems-programming/firmware-checksum-verifications/patch-version-verifications.md) — Uses checksum-based verification to ensure patches are applied only to compatible versions of the virtualization software.
- [Disk Image Bundlers](https://awesome-repositories.com/f/operating-systems-systems-programming/system-administration-maintenance/disk-imaging-tools/disk-image-bundlers.md) — Provides bootable ISO images that bundle necessary drivers and utilities for guest installation.
- [Patch Reversion Utilities](https://awesome-repositories.com/f/operating-systems-systems-programming/system-administration-maintenance/system-administration-utilities/system-modification-frameworks/system-volume-patchers/patch-reversion-utilities.md) — Removes applied modifications from the virtualization software to restore the installation to its original state. ([source](https://cdn.jsdelivr.net/gh/drdonk/unlocker@main/README.md))

### Part of an Awesome List

- [Virtualization Patching Tools](https://awesome-repositories.com/f/awesome-lists/devtools/virtualization-patching-tools.md) — Modifies virtualization software binaries to support hardware and OS combinations not supported by default.

### Development Tools & Productivity

- [Hypervisor Compatibility Patches](https://awesome-repositories.com/f/development-tools-productivity/compatibility-verification/cpu-instruction-compatibility-verifications/macos-cpu-compatibility-patches/hypervisor-compatibility-patches.md) — Ensures macOS guest machines can boot and function correctly on unsupported virtualization platforms.
- [Binary State Restoration](https://awesome-repositories.com/f/development-tools-productivity/version-control-repository-tools/version-control-managers/repository-utilities/history-analysis-visualization/action-reversion-systems/application-state-reversion/binary-state-restoration.md) — Tracks original file bytes before modification to allow complete restoration of the software to its factory state.

### Software Engineering & Architecture

- [Binary Patching Utilities](https://awesome-repositories.com/f/software-engineering-architecture/binary-patching-utilities.md) — Implements a binary patching mechanism to modify virtualization software binaries for bypassing hardware restrictions.

### DevOps & Infrastructure

- [Guest Software Provisioning](https://awesome-repositories.com/f/devops-infrastructure/guest-software-provisioning.md) — Provides custom image files to install necessary drivers and utilities within the guest operating system.

### Hardware & IoT

- [Guest Driver ISOs](https://awesome-repositories.com/f/hardware-iot/custom-hardware-drivers/installation-driver-injection/guest-driver-isos.md) — Provides ISO images containing necessary drivers and utilities for macOS guest installations.