Skip to content

vmw

vmw turns one YAML profile into a full KVM virtualization stack: a patched kernel, a patched QEMU, patched OVMF firmware, and a libvirt domain definition. Each layer changes values that guest software can read: CPUID leaves, MSR behavior, firmware tables, SMBIOS strings, and TPM identity.

The research target is VMAware, an open-source VM-detection library. Research covers which detection surfaces close, and which are inherent to nested virtualization.

Quickstart

$ git clone https://github.com/meowdiocre/vmw.git
$ cd vmw
$ pip install -e ".[dev]"
$ vmw

vmw with no arguments opens the dashboard TUI. See Usage for the full CLI.

Layout

Section Covers
Usage CLI commands, profile format, patch workflow
QEMU Hypervisor CPUID bits, ACPI tables, SMBIOS
Firmware OVMF build, boot logo, secure boot, identity strings
TPM libtpms and swtpm identity
Kernel The KVM/SVM patch: CPUID interception, MSR passthrough
Operations Running profile, known gaps, useful commands
Manual scripts Host/guest setup scripts vmw does not automate
Roadmap Current detection status

Status

The refactor is in progress on the refactor branch. See the roadmap for current status.

License

GPL-3.0-or-later. See the repository.