v4.2.3 (Beta)

[osy]

Highlights

• (iOS SE) TCTI backend updates. Vector instruction support can improve the performance of certain workloads.
• (macOS) Guest interface commands. New commands accessible from the scripting interface as well as the command line interface (utmctl) can be used to read/write files, execute commands, and list IP addresses. These commands require QEMU guest agent to be installed.
• (macOS) Scripting interface additions. The scripting interface now allows for creation of a new VM, configuration an existing VM, changing drive image, and more. See this page for more details and the cheat sheet for example usage.
• (macOS) External read-write drive images. In QEMU, if a supported drive interface is selected (USB, Floppy, etc) along with an image type of Disk, the drive can now be marked as either read-only or read-write. This can be used as an alternative way of transferring data to and from the VM when the guest does not support SPICE or VirtFS. In AVF, support for read-write images has be fixed as well (when "read only" is unchecked in the settings).

Notes

• iOS 14 and macOS 11.3 are the minimum supported systems for UTM v4.x. Please use UTM v3.x for support down to iOS 11 and macOS 11

Changes (v4.2.3)

• Added support for read-write removable devices on supported interfaces (USB, Floppy, etc). To use this feature, set the image type to "Disk" and uncheck the "Read Only?" option in the drive settings. Note that you may have to eject and re-mount the drive image for effect to take place. (Data storage with secondary image on external disk #5079)
• Removable USB devices will no longer show up as a CD drive if the image type is set to "Disk" (Removable USB Drives are always CDROM #5171)
• Reverted a change from v4.2.0 where virtio bus devices were removed (this broke some people's configurations) (virtio-net-device in block list, even though my VM won't get a network connection without it #5137)
• Fixed an issue where when QEMU fails to start, subsequent attempts to start the VM will automatically fail
• Fixed an issue where due to a race, removable drives may not be mounted on start
• (iOS) Fixed an issue when the pointer is hovering over a toolbar button when the VM starts and subsequent clicks will toggle the button (Trackpad click unable to lose focus from last selected toolbar icon #4843)
• (macOS) AVF: Fixed an issue where a removable drive that is not marked as read-only still gets marked as read-only after restarting UTM (when upgrading from a previous version, you must eject and re-mount the image for effect to take place) (AVF VM: removable storage switches to read-only after relaunch of UTM #5170)
• (macOS) Fixed an issue where incorrect subnet parameters are generated for vmnet advanced settings (UTM Qemu VM: cannot set subnet, invalid parameter net #5128)
• (macOS) CLI: Added a new clone command (Clone VMs with utmctl #5004)

Changes (v4.2.2)

• Fixed an issue where a VM that is moved manually (e.g. with Finder) cannot be started (Manually moved VMs cannot start due to incorrect shortcut link #5121)
• Fixed an issue where the cursor disappears after resuming a suspended VM (Mouse pointer does not display after resuming paused VM in UTM SE and UTM on Mac #4665)
• (macOS) Scripting: Add support for make, duplicate, and delete verbs on virtual machines
• (macOS) Scripting: Add support for modifying certain configuration options
• (macOS) Scripting: Removed virtual machine properties: notes, machine, architecture, memory. You should now use similar properties in the configuration record
• (macOS) Support changing the audio backend to CoreAudio and make CoreAudio the default (due to better latency and as a workaround to some crashes) (Option to change audio backend to CoreAudio on macOS #5125)

Changes (v4.2.1)

• QEMU: Support more than 8 cores for ARM64 targets (Enable QEMU support for more than 8 cores in HVF #4847)
• Synchronize time on resume when QEMU guest agent is installed which should fix clock drift issues (Time inside VM goes out of sync #3218)
• (iOS SE) Updated TCTI to latest branch from @ktemkin which has support for vector instructions (Merge new TCTI features #4865)
• (macOS) Switch to emulated trackpad when guest+host are macOS 13+ (second attempt for VM scrolling locks up #4636 and single click treated as double click in macos 13.1 guest #4645)
• (macOS) Fixed the "raw image" checkbox when creating a new drive (Unable to enable the "Raw Image" button #5100)
• (macOS) Add PC speaker sound device as an option. You can now add a second sound device on supported targets (x86_64/i386 PC based targets) and set the hardware to PC Speaker to emulate older motherboard speakers.
• (macOS) Scripting: new verbs "open file", "execute", and "query ip" which uses the QEMU guest agent to send commands to the guest. Use the Apple Script Editor's Open Dictionary tool for more information.
• (macOS) CLI: new commands "file push", "file pull", "exec", and "ip-address". See utmctl help for more information.

Changes (v4.2.0)

• Updated virglrenderer to latest (27/02/2023) commit
• Automatically revert CPU to "default" if model is missing due to updated QEMU (New version is inconsistent with previously created VMs #4910)
• Remove virtio-bus devices (they didn't work) (virtio-gpu-gl-device not working with new v4.1.5 release #4893)
• Support drag and drop to import an .utm package (Import files by dragging into the VM directly. #3599)
• Support copying sparse images across different volumes (thanks @ktprograms)
• Fixed tearing/performance issue for non-GL accelerated displays when under graphics load (Upgrading to 4.1 degrades experience on Intel Macbook Pro #5049)
• Fixed error when importing a new drive with the same name as an existing drive (Unable to replace drives with the same filename during a single edit #5052)
• Fixed a crash on startup when multiple audio devices are plugged in (Crash in gst_osx_audio_src_io_proc when starting VM #4629)
• Wizard: Generate a working configuration for isapc (No 'PCI' bus found for device 'virtio-serial-pci' #4961)
• Settings: Use pretty labels for CPU flags (OptionsList for Flags doesn't show pretty values, but rather raw values #4940)
• Translation: updated French (thanks @FRtranslator)
• Translation: added Czech readme (thanks @stinovlasmp)
• Translation: updated German (thanks @LostInCompilation and @afh)
• (macOS) Capture Mouse has been renamed to Capture Input and now will show the current capture status as a toggle button
• (macOS) Apple VMs (macOS guests) now support Capture Input which will capture the system keys. This used to be always on as the default. It is now off by default and the toggle button will enable it. (Option to disable capturing system keys in macOS VMs #4667)
• (macOS) Ignore missing links (drives, shared directory, etc) when saving an Apple VM
• (macOS) Preference: added option to force Num Lock on (Add "Force NumLock" default on for Windows Guests #4625)
• (macOS) Preference: added option to prevent idle sleep while VM is running (Prevent Sleep When VM is Running #4963)
• (macOS) Preference: added option to suppress exit confirmation (Ability to turn off Quitting confirmation window #4989)
• (macOS) Fixed delete drive confirmation not showing up on latest macOS
• (macOS) Fixed disposable mode stuck on when a VM is run once in disposable mode (debian vm data changes not save in normal mode (not disposable mode) #5025)
• (macOS) Fixed an issue where a moved or deleted VM with a stopped window open will attempt to use the old path (QEMU arguments won't update after moving the VM to another location #4985)
• (macOS) Fixed cursor scrolling and double click issues (VM scrolling locks up #4636, single click treated as double click in macos 13.1 guest #4645)
• (macOS) Support following a change in system default input or output audio device (Follow changes in sound output device #3488)
• (macOS) Support retry of macOS installation when it fails (the IPSW will not automatically be unlinked)
• (macOS) Support retaining of installer IPSW bookmark across VM moves and UTM restarts (macOS Virtualization.framework VMs don't save bookmark to install IPSW when Moving to external disk #4938)

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

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

---

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