Preview

UTM 2.0 includes a redesign of the frontend for iOS 14 and introduces support for macOS 11. Due API limitations, the new design will not be available for iOS 13 and below. That means any feature that depends on the new design will also not be back-ported to iOS 13. Launching UTM 2.0 on iOS 14 will show the new design and launching UTM 2.0 on iOS 13 and below will show the old design.

iOS 14 unfortunately patched the ptrace() exploit that allowed UTM to run side-loaded on non-jailbroken devices. UTM 2.0 running on iOS 14 requires either jailbreaking or tethering to the Xcode debugger (launch directly from Xcode). To better support future iOS releases, we are deprecating support for non-jailbroken devices. This means that future features may depend on jailbreak and "legacy" UTM will no longer get priority for new features.

As always, please report all bugs to Github

Changes (All)

• QEMU updated from 4.2.0 to 5.1.0
• Removable drives and changing discs while VM is running (#109)
• Tap to right click with Apple Pencil 2 (#297) thanks @conath

Changes (iOS 14 only)

• Brand new UI for the home view and configuration views
• Advanced mode: bypass QEMU arguments generated by configuration and pass args directly (#381)
• Jailbroken devices can use more JIT memory (#67)
• Sort VMs on home view (#356)

Bug Fixes

• Sound issues in older OS versions fixed by latest QEMU (#345)
• Race condition in UTMQemuManager (#178)
• Fail gracefully when creating a VM with an invalid name (#210)

Release

Happy WWDC! 🎉

Changes

• Improved contrast of buttons and spinner
• Added pull-to-refresh on home screen
• Fix alignment and display issues with activity indicator popup

Known Issues

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

Release Candidate

For the next few months, expect only bug fixes and minor tweaks. PLEASE help us by submitting any issues you find on Github (after searching).

Changes

• Added link to the User Guide to the home screen
• Changed icons from SF Symbol Light to SF Symbol Regular

Bug Fixes

• Fixed race condition whenever multiple alerts trigger at the same time in the home screen
• Fixed importing/copying .utm if the app has not started yet
• Fixed AirDrop .utm

Known Issues

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

Release Candidate

For the next few months, expect only bug fixes and minor tweaks. PLEASE help us by submitting any issues you find on Github (after searching).

Changes

• Added zh-Hant translation (thanks @hui2007)
• iPad Split View supported in auto-resolution (#357)
• Opening .utm from Files app inside UTM's directory will launch VM

Bug Fixes

• Fixed UTM not showing in Files app (#360)

Known Issues

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

Release Candidate

For the next few months, expect only bug fixes and minor tweaks. PLEASE help us by submitting any issues you find on Github (after searching).

Changes

• Updated zh-Hans translation (thanks @js-john)
• Added SunGEM network card (#340)

Bug Fixes

• Fixed importing a .utm file (#342)
• Fixed a crash when resizing display or restarting VM (#355)
• Fixed software keys not being depressed when scrolling (#354)
• Fixed software modifier keys not being depressed when using hardware keyboard

Known Issues

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

Release Candidate

For the next few months, expect only bug fixes and minor tweaks. PLEASE help us by submitting any issues you find on Github (after searching).

!!! THIS RELEASE BREAKS SOME EXISTING VMS, PLEASE READ THESE NOTES FOR MORE INFORMATION !!!

Changes

• Removed force drive type to "virtio" for "virt" machines (#324) NOTE: This breaks many ARM VMs that depended on this behaviour (including the official ArchLinux image). Those will boot into a black screen. To fix, you need to modify the drive and set the "Location" from "sd" (or whatever) to "virtio".
• Display version number in config (#328)
• A warning message is displayed when saving a suspend image is not supported (#310) NOTE: You must have a qcow2 disk image to use suspend. If you only have ISO and/or RAW images, suspend/resume will not work.
• Removed the option to create RAW images. NOTE: this created a lot of confusion because 1) suspend/resume didn't work (see above) and 2) there is no performance benefit against "compressed" (qcow2) images. There is also an incorrect assumption that "compressed" images will auto-compress the data. That is incorrect, as it only compresses the initial data of all zeros.
• Added an option to set machine properties manually for those who need it (#313) NOTE: Most do not need to touch this new option. It's only use right now is a workaround for mac99 VMs that need to set via=pmu-adb on some older versions of MacOS.
• Added more keys to the keyboard strip including "page down" needed for installing older versions of Windows (#323)
• Improved debug logging to save more log entries

Bug Fixes

• Fixed on-screen keyboard broken in RC2 (#329)
• Fixed issue where UTM attempts to resume a VM that has no suspend image (#280)
• Fixed Ctrl+C in console mode (#327)
• Fixed a rare crash on background-to-foreground (#335)
• Fixed an issue where in some instances switching cursor input type (direct<->indirect) did not work (#298)
• Fixed an issue where the cursor is misaligned when SPICE is installed (#300)
• Fixed an issue where the keyboard strip is too tall or short after an external keyboard is plugged in or removed (#333)

Known Issues

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

Other Information

iOS 13.5 is out. While UTM supports iOS 13.5 and currently does not use the "Psychic Paper" sandbox escape, we still encourage anyone who does not need iOS 13.5 features to stay on stock iOS 13.4.x because we may develop a fork in the future with features that require either sandbox escape or jailbreak.

Release Candidate

For the next few months, expect only bug fixes and minor tweaks. PLEASE help us by submitting any issues you find on Github (after searching).

This release is only focused on bug fixes in console mode. There is no change to the GUI mode.

Bug Fixes

• Fixed issues with pause/resume feature in console mode (#286)
• With external keyboard connected, press any key to open up keyboard (#284)
• Fixed modifier keys with external keyboard in console mode (#285)
• Fixed three finger gestures to show/hide toolbar in console mode (#259)
• White background text shows up with white foreground text (#287)
• Added sending stty command to resize the terminal (#282)

Known Issues

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

Release Candidate

UTM is now feature complete! 🎉 For the next few months, expect only bug fixes and minor tweaks. PLEASE help us by submitting any issues you find on Github (after searching).

New Features

• iPadOS 13.4: touchpad scroll gesture and right click as well as mouse middle and right click. UTM is ready to support Magic Keyboard on day one!
• Added inertia to scrolling. Includes scroll wheel emulation from touch gestures and gamepad joystick.

Bug Fixes

• Shared directory not working (#265). Note that previously, we advertised support for shared directories outside the app sandbox. This feature has been moved to a future milestone as it requires much more work. As a result, v1.0 will only support shared directory inside the app sandbox.
• Bug in additional arg parsing broke args with spaces (#266)
• Gamepad thumbstick does not move the mouse cursor if the thumbstick is locked in place (#262)
• When "retina mode" is enabled, device rotation does not change resolution (#275)
• On iPads, device rotation does not change resolution (#275)

Known Issues

• Note that USB/BT mouse scroll wheel does not work well but this seems to be an iOS issue in general.
• Many issues in console mode. In v1.0, those bugs will not be fixed.

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

Preview

🐰🥚🔔 Happy Easter!

New Features

• Shared directory: select a directory to access from the VM. On iOS 13, you can select any directory on the system while on older versions you can access any directory in UTM's sandbox. Requires SPICE guest WebDAV tools installed.
• Background mode: using location services to run in the background. Please note that iOS kills any background process that uses too much CPU.
• Graphics mode: add option to change scaler
• Graphics mode: add option to auto-change resolution to device screen (requires SPICE guest tools)
• Console mode: change font, font size, and cursor blink
• Gamepad support: control VM with a controller (thanks @js-john)

Bug Fixes

• Crash when attempting to add port forward on iPad (#239)
• Add via=pmc for Mac PPC emulation (#236)
• Debug log not flushed on crash (#194)
• S3 sleep causes display to stop working (#235)
• New VMs will now have a static UUID (#224)
• System settings: memory usage alerts now at 50% total RAM as discovered by experiments (#120)
• Timezone incorrect in Windows (#246)
• Arrow keys do not work in aarch64 (thanks @lshzh-ww) (#188)
• Updated zh-Hans translation (thanks @js-john)

Known Issues

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

Other Information

UTM is almost feature complete! All the configuration pages are now working and all major features are implemented. At this point, bug fixing is the main priority. The next series of releases will be RC (release candidate) builds where no new features will be introduced. Please help us by reporting any bug you may find in Github.

Preview

New Features

• Console mode: boot without GUI into a Terminal (thanks @fredyshox)
• iPadOS 13.4 touchpad support for VM (thanks @conath)
• Added ko-KR translation (thanks @obbcth)
• Implemented advanced network settings including port forwarding
• Share clipboard between guest and iOS. Requires SPICE guest tools to be installed. Image support on Windows is limited to PNGs only.
• Tweaked toolbar display on large screens (toolbar should be small)

Bug Fixes

• DNS server requires manual setting on guests (#198)
• Microphone access crashes UTM (#202)
• Mouse not working in some Linux distributions (#203)

Known Issues

• Microphone not working (although it no longer crashes) (#219)
• Gestures do not work with iPadOS touchpad (#214)
• Invalid settings (including advanced network settings) will cause VM to not launch
  Please check the full list on Github and help report any bug you find that is not listed.

Other Information

Note that when you update UTM, any suspended VM will not be compatible and will crash on the next boot. It is advised that you shut down all VMs before updating UTM to avoid using any unsaved data.