utmapp

Decide which layer of the VirtIO GPU stack owns a bug before fixing it — the guest driver (UMD/KMD), the virtio transport and virglrenderer, the d3dmetal-native or DXMT backend shim, Apple's D3DMetal itself, Wine/CrossOver behavior, or UTM's display path — by…

Build a development UTM.app with host-side changes — rebuild one dependency (virglrenderer, QEMU, d3dmetal-native, DXMT, SPICE, …) in an existing UTM dependency tree, repackage it into the framework the app embeds, rebuild UTM, and prove the change is in the…

Build the VirtIO GPU Windows driver — the Neptune user-mode driver (Mesa) and the viogpu3d kernel-mode driver — on a Windows build VM over SSH, and pull the verified, test-signed driver package back to this host. Use when asked to build the drivers, the KMD,…

Write or resume a handoff for a GPU-stack investigation that spans sessions — a fixed template of confirmed findings with evidence, exact repro steps, environment and versions, saved diagnostic patches, eliminated hypotheses as a do-not-redo list, and the…

Kernel-debug a Windows test VM over kdnet with kd.exe running on its debugger dev VM — attach, watch the display miniport's DbgPrint output live while it loads, break in to a hung guest, collect bugcheck analysis, resume, and find user-mode DLL load failures…

Turn an investigation's working tree into clean, reviewable commits across the repos of the VirtIO GPU stack (guest driver, KMD, virglrenderer, backend shims, QEMU, UTM) — separate diagnostics from the fix, split it into logical commits that each carry their…

Measure GPU performance in a UTM VM the valid way and decide whether a change made it faster, slower or no different — 3DMark single-test runs with validity checks, interleaved A/B between builds, drivers, backends or UTM apps, frame pacing from the VM…

Triage a utmapp/UTM GitHub issue about 3D graphics (Neptune D3D, Venus, the guest-tools GPU driver) — extract the reporter's exact environment, reproduce on the release UTM with the released guest-tools driver at the reporter's settings, then on a development…

Review pending UTM changes before they are submitted. Runs a standard correctness/quality code review of the current branch's diff AND audits it against UTM's contribution rules in CONTRIBUTING.md and AGENTS.md — scope discipline, commit/PR format, AI…

Submit the current UTM change as a pull request to github.com/utmapp/UTM. Ensures /utm-review has run, then either updates an existing PR (squashing each new edit into the commit that owns it and force-pushing) or opens a new PR (gathering issue links and the…

Build, run, and debug a UTM change for real. Covers building UTM, building all dependencies or just one after changing it, creating a disposable test VM by scripting and deleting it afterwards, where logs go, debugging, headless GUI checks, and the iOS…

Publish a new UTM release on GitHub. Drafts the release notes from the commits and pull requests since the last release, has the user approve them, bumps the version in Build.xcconfig, commits and tags it, pushes, and creates the GitHub release with a…

Publish a notarized UTM SE build to the AltStore PAL source (pal.getutm.app) from its App Store Connect Alternative Distribution Package (ADP) ID — fetches the ADP via AltStore, updates adp/ + config.json, pushes + tags, uploads the IPAs as the latest GitHub…