How utmapp/utm works
UTM is a system-emulation and virtual-machine host for Apple platforms, built around QEMU and Apple’s virtualization APIs. Users create or import a VM, configure its hardware, launch and interact with it, then manage its files, snapshots, and devices. The graph includes the shared VM catalog, both execution backends, platform display, and documented remote and automation capabilities. Edges reflect README statements or source-index references; unsampled subsystem wiring is not inferred.
Main entry points: UTMQemuVirtualMachine.swift QEMU VM · UTMAppleVirtualMachine.swift Apple VM · VMData.swift VM Records · UTMVirtualMachine.swift VM Lifecycle
Components 21
App and VM Catalog
- VM Catalog
Platform/UTMData.swift - VM Records
Platform/VMData.swift - VM Registry
Services/UTMRegistry.swift - Registry Entry
Services/UTMRegistryEntry.swift
VM Configuration
- Shared Configuration
Configuration/UTMConfiguration.swift - QEMU Configuration
Configuration/UTMQemuConfiguration.swift - Apple Configuration
Configuration/UTMAppleConfiguration.swift
VM Runtime
- VM Lifecycle
Services/UTMVirtualMachine.swift - QEMU VM
Services/UTMQemuVirtualMachine.swift - Apple VM
Services/UTMAppleVirtualMachine.swift - SPICE VM
Services/UTMSpiceVirtualMachine.swift - Snapshot Service
Services/UTMSnapshotService.swift - QEMU Engine
QEMULauncher/main.c - Apple Virtualization
Guest Interaction
- VM Display
Platform/macOS/Display/VMDisplayWindow.swift - QEMU Display
Platform/macOS/Display/VMDisplayQemuDisplayController.swift - Apple Display
Platform/macOS/Display/VMDisplayAppleWindowController.swift - Apple USB Manager
Services/UTMAppleUSBManager.swift
Remote and Automation
- Remote Client
Remote/UTMRemoteClient.swift - Scripting API
Scripting/UTMScriptingVirtualMachineImpl.swift
Other components
- User
Connections 26
- User → VM Catalog: creates and manages
- VM Catalog → VM Records: wraps VMs
Platform/UTMData.swift - VM Records → VM Registry: uses registry
Platform/VMData.swift - VM Records → QEMU VM: uses backend
Platform/VMData.swift - VM Records → Apple VM: uses backend
Platform/VMData.swift - Registry Entry → VM Lifecycle: tracks lifecycle
Services/UTMRegistryEntry.swift - VM Lifecycle → Registry Entry: updates state
Services/UTMVirtualMachine.swift - QEMU Configuration → Shared Configuration: implements
Configuration/UTMQemuConfiguration.swift - Apple Configuration → Shared Configuration: implements
Configuration/UTMAppleConfiguration.swift - QEMU VM → QEMU Configuration: reads configuration
Services/UTMQemuVirtualMachine.swift - Apple VM → Apple Configuration: reads configuration
Services/UTMAppleVirtualMachine.swift - QEMU VM → SPICE VM: uses SPICE
Services/UTMQemuVirtualMachine.swift - Apple VM → Snapshot Service: uses snapshots
Services/UTMAppleVirtualMachine.swift - QEMU VM → Snapshot Service: uses snapshot manifest
Services/UTMQemuVirtualMachine.swift - User → VM Display: interacts with guest
- VM Display → VM Lifecycle: controls VM
Platform/macOS/Display/VMDisplayWindowController.swift - QEMU Display → QEMU VM: renders and inputs
Platform/macOS/Display/VMDisplayQemuDisplayController.swift - Apple Display → Apple VM: controls display
Platform/macOS/Display/VMDisplayAppleWindowController.swift - Apple Display → Apple USB Manager: queries devices
Platform/macOS/Display/VMDisplayAppleWindowController.swift - Apple VM → Apple USB Manager: claims devices
Services/UTMAppleVirtualMachine.swift - User → Remote Client: connects remotely
- Remote Client → SPICE VM: uses remote VM
Platform/UTMData.swift - User → Scripting API: automates VM
- Scripting API → VM Records: accesses VM data
Scripting/UTMScriptingVirtualMachineImpl.swift - QEMU VM → QEMU Engine: launches engine
- Apple VM → Apple Virtualization: runs guest