How insidegui/virtualbuddy works
VirtualBuddy is a macOS virtualization application. The principal workflow is: a user selects or creates a VM, the application stores it in the VM library, launches a session, configures virtualization, and boots the guest OS. Installation branches through Apple restore-image catalogs or local/custom images, while configuration supports hardware, storage, networking, sharing, and saved states. The sampled code confirms library/session orchestration, catalog loading, storage modeling, saved-state lookup, and guest-folder mounting; several backend links are inferred only from documented capabilities and tree paths.
Main entry points: VMInstallationWizard.swift Installation Wizard · VirtualMachineSessionUIManager.swift Session Manager · VMController.swift VM Controller · VirtualMachineConfigurationHelper.swift VM Configurator
Components 23
Application UI
- VirtualBuddy App
VirtualBuddy/Bootstrap/VirtualBuddyApp.swift - Session Manager
VirtualUI/Source/Session/VirtualMachineSessionUIManager.swift - Configuration UI
VirtualUI/Source/VM Configuration/VMConfigurationViewModel.swift
VM Management
- VM Library
VirtualCore/Source/Virtualization/VMLibraryController.swift - VM Model
VirtualCore/Source/Models/VBVirtualMachine.swift - Storage Model
VirtualCore/Source/Models/VBStorageDeviceContainer.swift - Saved States
VirtualCore/Source/Models/SavedState/VMLibraryController+SavedState.swift
Installation
- Installation Wizard
VirtualUI/Source/Installer/VMInstallationWizard.swift - Restore Catalog
VirtualUI/Source/Installer/Steps/Restore Image Selection/RestoreImageSelectionController.swift - Restore API
VirtualCore/Source/Restore Images/VBAPIClient.swift - Download Backend
VirtualCore/Source/Restore/Download/URLSessionDownloadBackend.swift - Restore Backend
VirtualCore/Source/Restore/Installation/VirtualizationRestoreBackend.swift
Virtualization Runtime
- VM Controller
VirtualCore/Source/Virtualization/VMController.swift - VM Instance
VirtualCore/Source/Virtualization/VMInstance.swift - VM Configurator
VirtualCore/Source/Virtualization/Helpers/VirtualMachineConfigurationHelper.swift - Network Devices
VirtualCore/Source/Virtualization/VMNetworkAttachmentHelper.swift
Guest Integration
- Guest Support
VirtualCore/Source/GuestSupport/GuestAppSupport.swift - Guest Connection
VirtualWormhole/Source/GuestConnection.swift - Shared Folder Mount
VirtualBuddyGuest/Dashboard/GuestSharedFoldersManager.swift
Other components
- User
- Apple Restore Servers
- Host Filesystem
- Guest OS
Connections 23
- User → VirtualBuddy App: uses
- VirtualBuddy App → Session Manager: opens sessions
- Session Manager → VM Library: loads VMs
- Session Manager → VM Controller: launches VM
- VM Controller → VM Instance: controls runtime
- VM Controller → VM Configurator: builds configuration
- VM Configurator → Storage Model: resolves disks
- VM Configurator → Network Devices: configures network
- Configuration UI → VM Model: updates configuration
- Storage Model → Host Filesystem: resolves images
- VM Library → Saved States: creates states
- Saved States → VM Model: finds VM
- User → Installation Wizard: starts install
- Installation Wizard → Restore Catalog: selects image
- Restore Catalog → Restore API: fetches catalog
- Restore API → Apple Restore Servers: requests images
- Installation Wizard → Download Backend: downloads image
- Installation Wizard → Restore Backend: installs system
- Restore Backend → VM Model: creates VM
- VM Instance → Guest Connection: communicates guest
- Guest Support → Guest Connection: provides guest services
- Guest OS → Shared Folder Mount: runs mount
- Shared Folder Mount → Host Filesystem: mounts shared folders