v4.7.3 (Beta)

[osy]

Highlights

• QEMU v10.0.2: The backend has been updated to the latest upstream QEMU which brings with it a variety of bug fixes and performance improvements.
• Liquid Glass: UTM adopts the Liquid Glass design on *OS 26.
• App Intents: New support for automation with Shortcuts.
• Keyboard Shortcuts: Define custom key combinations (such as Ctrl+Alt+Del) that can be sent to the VM from the new Keyboard menu.
• Improved Wizard: Simplify the creation of emulated machines by selecting from a list of well-supported configurations. The updated wizard can create more working configurations such as RISC-V64 Ubuntu, classic Mac OS 8.x/9.x, and Windows 95/98.

Notes

• (iOS) iOS 26 breaks the technique that AltJIT and similar tools use to enable JIT.

Changes (v4.7.3)

• Fixed a crash when starting a VM results in a block device error
• Stop button can now be used a second time to force kill a VM if it is unresponsive after stopping for the first time
• libusb: Fixed multiple race conditions that caused crashes when using USB capture
• CocoaSpice: Fixed multiple race conditions that caused crashes during VM start
• Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon)
• (macOS) Scripting: Fixed broken commands due to name collision (AppleScript error with UTM 4.7.2 beta #7360)
• (macOS) Fixed crash when exiting full screen (v4.7.2 (Beta) crashes on macOS when leaving the full-screen VM window in the background #7377)

Changes (v4.7.2)

• (macOS) AVF: Fixed a crash when starting any Apple Virtualization VM (Latest UTM beta crashes every macOS VM on macOS Tahoe public beta. #7355) (We are re-releasing v4.7.2 with build 112 due to this critical bug.)
• Home: Display network details and active IP addresses on the home details screen (thanks @gabefair)
• Home: Show a security warning message when importing a .utm with custom arguments (Google Vulnerability Report: warn user when custom arguments are used #6252)
• Config: Option to reset UEFI without pre-loading Secure Boot keys (useful for custom TPM configurations) (Enable UEFI & TMP2 without enforcing Secure Boot #7005)
• Config: Pre-loading Secure Boot keys will now install Microsoft UEFI 2023 certificates (Expiring Microsoft Secure Boot Certificates #7257)
• Config: When PS/2 device is enabled, no longer create USB mouse and keyboard devices. This allows older Windows install to work out of the box.
• Config: Quotes in custom arguments are no longer stripped (unless the only quotes wrap the entire argument) (Cannot specify JSON custom arguments because quotes are eaten #6343)
• Config: Provide a fixed serial number for VirtIO block devices (feature: VirtIO block devices to provide a serial number #7332)
• QEMU: Fixed an issue which causes Windows 98 to BSoD (Legacy Windows 9x machines no longer boot for v4.7.1 Beta on macOS #7342)
• QEMU: Do not create a default floppy drive when -nodefaults is used. UTM configuration will set up a FDC device and this is the only way to set up bootindex for floppy.
• Wizard: Legacy Windows configurations will now use PS/2 controller by default
• Wizard: Update OS logos to be consistent with other icons
• Wizard: Windows + i440fx hardware will now instantiate default devices (sound, VGA, networking) that should work with Windows 95/98
• Wizard: Add additional supported hardware configurations for running older Windows
• Wizard: Support floppy boot for Windows configuration
• Scripting: New input automation suite for sending keyboard and mouse input (Problems about a Specific QMP Scripting Use Case #6462)
• USB: Fixed a rare crash when initializing the USB devices list (UTM crash when USB is connected #5811)
• SPICE: Fixed an issue where monitor configuration sent to spice-vdagent contains an invalid size (SPICE vdagent version mismatch causes resolution change issues #5832)
• Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon)
• (iOS) Toolbar: Fix foreground issue on iOS 26 beta 5 and higher
• (macOS) Added ability to auto-connect USB devices on start (Allow permanent USB pass-through configuration #3400)
• (macOS) Fixed connecting USB devices from secondary windows
• (macOS) New "Virtual Machine" menu which mirrors the actions accessible through the toolbar
• (macOS) Keyboard Shortcuts toolbar icon is no longer shown by default (it can be placed on the toolbar through View -> Customize Toolbar). It is also accessible through the "Virtual Machine" menu.
• (macOS) Fixed sending simultaneous mouse button presses (Simultaneous Middle and Right Mouse Button Support on Windows 11 ARM in UTM #7068)
• (macOS) utmctl: Add version command to detect current UTM version
• (macOS) Settings: New option to disable key swapping on ISO keyboards (Keyboard mapping is differs in guest on ISO keyboard #6976)
• (macOS) Settings: New option to randomize network MAC addresses on clone (Randomize mac address when cloning a VM #7035)

Changes (v4.7.1)

• New Liquid Glass icon thanks to @forcequitOS
• Added App Intents for VM operations (Add Shortcuts automation support #6245)
• Added UEFI boot support for RISC-V64 and LoongArch64. This allows Ubuntu for RISC-V64 to work out of the box. (No way to emulate Risc-V #7183)
• QEMU PPC: Disable bootindex when boot-device is used in prom-env. This allows Yellow Dog Linux for PPC to work out of the box. (PowerPC mac99 doesn't seem load -prom-env options #6436)
• QEMU x86_64: Fixed floppy boot order configuration for other PC models (isapc, i440fx) (floppy boot order, but this time on system=isapc #7166)
• QEMU PPC/M68K: Includes classicvirtio drivers to support cursor input without capture and directory sharing (Use the "classicvirtio" to improve support for classic Mac OS clients. #6520)
• QEMU M68K: Fixed virtio drive config (Use virtio-blk-device for m68k #7008)
• Fixed a rare crash after stopping VM due to a race condition in libusb
• Home: improve screenshot contrast in Dark Mode (Dim viewport into VM display using black instead white when OS is in dark mode #6894)
• Config: Fixed a crash when trying to enter a large size value when creating a new drive (Crash entering size when creating a new drive #7295)
• Config: Corrected the default host IP address in port forwarding config to "0.0.0.0" when it incorrectly displayed "127.0.0.1" (port forwarding defaults to making the host port publicly accessible #7132)
• Keyboard Shortcuts: Create custom combinations of keyboard shortcuts from either Settings -> Input or via the Keyboard icon in the VM (press and hold on iOS/visionOS). This will allow you to easily send key commands such as Ctrl+Alt+Del or Stop+A to the VM. (Add a more clear way to send Ctrl+Alt+Delete #5698, Pass CTRL-BREAK on MacBook #6310, SPARC timeout waiting for ARP/RARP packet #6757)
• Wizard: New option to import an existing drive image when setting up a Linux VM. This allows Ubuntu for RISC-V64 to work out of the box. (No way to emulate Risc-V #7183)
• Wizard: New option to create a serial port only Linux VM. This allows Ubuntu for RISC-V64 to work out of the box. (No way to emulate Risc-V #7183)
• Wizard: Removed VHDX import option because Microsoft now provides ARM64 ISO images. Note: You can still create manually import an VHDX after creating a new VM.
• Wizard: New template to create classic Mac OS VMs for M68K and PPC (Machine mac99,via=cuda can't find keyboard #3504, Q800 Emulation uses the wrong VirtIO device #6890)
• Wizard: Most common and supported machines for emulation are now listed prominently with the full list of supported QEMU architectures/targets hidden behind an "Expert" mode. This is necessary because most of the QEMU targets are not properly supported by the wizard anyways and does not generate a bootable config. They usually require a lot more manual tinkering. The page order of the wizard is also tweaked so the hardware config comes before the boot config now.
• Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon)
• (iOS SE) Fixed a crash when launching ArchLinux due to mis-handling of REV32
• (iOS SE) Fixed a crash when the first instruction executed is a goto
• (iOS SE) Removed ARM32, RISC-V32, and added M68K. There is little use for ARM32 and RISC-V32 as they cannot boot anything useful that cannot also be booted by the 64-bit variant (which is still included). If you have a counter example of this, please open an issue on GitHub and we can consider re-adding it back in the future. However, removing these will make the app size a lot smaller. M68K is added to support classic Mac OS.
• (macOS 11) Fixed guest tools mounting (Install Windows Guest Tools not working on macOS 11 #7297)
• (macOS 11) Fixed stop button not working (Power button not working on macOS 11 #7298)
• (macOS) Fixed a bug where an error message on startup leads to the window being stuck (Any QEMU crash results in a unclosable window #7161)
• (macOS) Settings: New setting to disable file locking so VMs can be launched from a network share or a filesystem that does not support locking ("Failed to lock byte 100: Operation not supported" when opening utm image from network location #7211)
• (macOS) Settings: New setting to disable screenshots completely for privacy reasons (Option to disable VM display preview in main UTM application window #6620)
• (macOS) Settings: New setting to swap Ctrl and Cmd keys in VMs (Feature request: swap <control> and <command> #4003)
• (macOS 26) Settings: Brand new layout with a sidebar to match other native apps
• (macOS) AVF: Added clearer message when trying to install macOS beta without having the latest beta support tools installed
• (macOS) AVF: New option to resize (expand) disk images (Host-side guided disk resize via UI when using Apple Virtualisation #6891)
• (macOS 26) Fixed a layout issue with the resize image popover
• (macOS) Home: Fixed hide sidebar button
• (macOS) Config: Show localized network adapter names when available (Show localized bridge network name when available #7287) (thanks @Schamper)
• (macOS) Scripting: Fixed an issue where wrong UUIDs were generated for display configs ([BUG] Update displays produces new id for displays #7145)

Changes (v4.7.0)

• Updated to QEMU v10.0.2
• Config: In the RAM slider, the maximum value has been increased to 64GiB (note that you can always go above the slider limit by typing in the text box) (More than 32GB RAM with Apple's Virtualization Framework #7234)
• Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon)
• Wizard: Fixed crash when VM name is empty (UTM crashes if you try to create VMs without names #7245)
• (iOS) Toolbar: Refactored toolbar button layout code
• (macOS) Host only networks: you can set up multiple host-only networks (including ones shared by VMware) and have multiple VMs on the same virtual network (thanks @Schamper)
• (macOS) utmctl: added option to boot Apple VMs into recovery mode (thanks @cees-elzinga)
• (macOS) Enable QEMU support for vmapple (Request: new MacOS paravirtual graphics support from Qemu 10? #7150) Machine model is removed for stability reasons but apple-gfx-pci is still supported for Intel VMs
• (macOS) Rename the main window to 'UTM Library' (Suggestion for UTM VM list #7264)
• (macOS) Display an error when IPSW install fails to load the file (instead of crashing) (Unable to install macOS on macOS host #6855)
• (macOS) Settings: Fixed a layout issue (macOS: fix issue where the Settings window (via cmd+,) was scaled to be too short when showing the inputs tab #7117)
• (macOS) Apple Virtualization: Add support for ASIF drive images. On macOS 26, ASIF drives will be created by default.

Issues

Please check the full list on Github and help report any bug you find that is not listed.

Installation

• iOS
• macOS

File	Description	Installation	JIT	Hypervisor	USB
UTM.deb	Jailbroken iOS version	Open in Cydia, dpkg, or Sileo	Yes	Yes(1)	Yes
UTM.dmg	macOS version	Mounting and copying UTM.app to /Applications	Yes	Yes	Yes
UTM.ipa	Non-jailbroken iOS version (sideloading)	AltStore, etc (see guide)	Yes(2)	No	No
UTM-HV.ipa	Non-jailbroken iOS version (TrollStore)	TrollStore	Yes	Yes(1)	Yes
UTM-SE.ipa	Non-jailbroken iOS version (sideloading)	AltStore, enterprise signing, etc	No	No	No
UTM-Remote.ipa	Remote client	Any	No	No	No

1. Hypervisor on iOS requires an M1 iPad or newer.
2. Enabling JIT may require a separate JIT enabler such as Jitterbug or Jitstreamer.

---

This discussion was created from the release v4.7.3 (Beta).