UTM

## Highlights * (macOS) **DirectX graphics support for Windows**: Modern accelerated graphics for Windows 11 is now available on UTM for the first time. The driver is still experimental and games compatibility is currently limited. * **Vulkan 1.3 graphics support for Linux**: Vulkan 1.3 is now supported on Linux guests with VirtIO Venus drivers in Mesa. Additionally, OpenGL 4.1 is supported with the new Apple Core OpenGL backend (macOS only). ## Notes * We now have a [development blog](https://blog.getutm.app)! Follow us for in-depth technical deep dives such as how we brought DirectX to QEMU. * (macOS) To use the new graphics driver for Windows 11, we recommend a fresh install because the driver is still experimental and its use could lead to instability in the system. During the install of the guest tools, you will be prompted to select the experimental graphics driver. If you wish to install the new driver on a system that already is running the older display only driver, you need to run the uninstall script provided on the guest tools install ISO first. * (macOS) Apple CoreGL backend does not support Vulkan or DirectX. * KosmicKrisp is provided as a WIP but the current upstream build is incomplete so MoltenVK is the recommended driver * Linux desktop rendering in Vulkan does not work due to lack of support for indirect draws for geometry shaders. Please configure your guest to use the older VirGL Gallium driver. ## Changes (v5.0.5) * Reverted minimum version requirement imposed by v5.0.4: once again we support versions down to macOS 11.3 and iOS 14.0. However, DirectX support is still limited to macOS 13.0 and iOS 16.0. * Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon) * Config: For ARM64 configs, GICv3 is now selected by default. Previously this was only the case for > 8 vCPUs. This improves performance for higher vCPU counts < 8. * Downloader: Path traversal and symlink checks added when unpacking downloaded ZIP files * Wizard: scaling is now default to "nearest" when a "classic" computer emulation is created in the wizard and "linear" otherwise. Previously it was "nearest" for all configurations which led to poor scaling filter for anything with higher resolutions. * (iOS) Support DirectX 11 with DXMT. Note that due to older iOS version (which supports TrollStore + Hypervisor), compatibility of DirectX titles is worse than macOS. * (iOS) QEMU: Fixed MMIO BAR bug which prevented large hostmem window from working * (iOS) Config: Improved RAM limit detection * (macOS) DirectX 12 is now supported with D3DMetal backend (when available). You must (re)install the latest UTM guest tools experimental 3D graphics driver. * (macOS) Support holding down Caps Lock key when input capture is enabled (#7840) (thanks @lprazdnik) * (macOS) Settings: new options to gracefully power down all running VMs on exit (#7829) (thanks @vectorseven) * (macOS) Settings: support CmdOpt swapping (#7837) (thanks @lprazdnik) * (macOS) Scripting: add snapshots commands to scripting interface (#7832) (thanks @naveenrajm7) * (macOS) AVF: Better error message when macOS guest version is too high (#7806) (thanks @sigitkusuma) ## Changes (v5.0.4) * (macOS) Added support for Neptune backend in virglrenderer for DirectX support * Localization: Updated German (thanks @Benjamin123-tech) * Scripting: new reload config and VLAN commands (#7710, #7711) (thanks @GregOriol) * SPICE: Fixed various bugs in renderer that leads to performance and tearing issues * SPICE: Fixed a memory leak that could result in large amount of memory use by UTM * Updated USB icon (#7718) (thanks @tan9) * Fixed crash in UTMRegistry and memory leak in AVF installer (#7701) (thanks @Casey) ## Changes (v5.0.3) * Fixed regression in GRUB rendering time due to new graphics backend * Fixed Vulkan issues on latest Wayland * Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon) * Home: Confirm delete when using swipe left (#3086) * Home: Prevent duplicate VMs from appearing (#7533) (thanks @DevSecTim) * AVF: Fixed CPU spike and mic loss due to two audio devices (thanks @matapo) * Scripting: Added ability to get IP address from AVF machines (#7643) (thanks @hellcastter) * Scripting: Fixed "update registry" for AVM backend (#7664) (thanks @EkkoG) * Scripting: Improve USB device matching logic (thanks @TronickDev) ## Changes (v5.0.2) * Environment variables are now logged when debug log is enabled * Fixed a regression in GL acceleration where desktop might not render correctly (#7626) * Added geometry shaders support to MoltenVK to enable DXVK (thanks @Anducalliew433) (#7575) * (iOS) Fixed an issue where EAGL backend boots into a black screen (#7587) * (iOS) Fixed a crash on iOS 15 due to incompatible symbols (#7593) * (iOS) Fixed verbose logging for graphics backend * (iOS) Fixed a crash when GL is enabled due to missing support for glDrawElementsInstancedBaseVertex (#7596) * (macOS) Fixed an issue when after resizing a window if the guest outputs a different resolution size, the wrong texture resolution is used leading to misaligned cursor and warped graphics (#5781) * (macOS) Fixed an issue where the window resizes to 0x0 when native scaling is enabled ## Changes (v5.0.1) * CocoaSpice: Reworked Metal renderer to be faster and have lower latency * Fixed an issue where a BIOS file with a comma in the filename will fail to load * Default FPS will now be the maximum refresh rate of the display on macOS and iPadOS (iPhone with ProMotion will still have 60Hz as the default rate but can be overridden to 120Hz through settings) * (macOS) Fixed issue causing `HV_UNSUPPORTED` on startup with Vulkan enabled (#7579) * (iOS) Fixed resolution issue on external displays (#6040) * (iOS) Pinch to zoom will turn off automatically updating zoom from the guest (until reset with the resize button) * (iOS) Fixed external display menu not updating * (iOS) Fixed incorrect scale on external displays and connecting an external display will now automatically scale to fit * (iOS) Fixed an issue where powering off the VM will show the home screen but not terminate UTM in the background ## Changes (v5.0.0) * Add Venus support for Vulkan (#4551) * Add Apple Core OpenGL support for OpenGL 4.1 (#4285) (thanks @startergo) ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## Highlights * (macOS) **DirectX 11 graphics support for Windows**: Modern accelerated graphics for Windows 11 is now available on UTM for the first time. The driver is still experimental and games compatibility is currently limited. * **Vulkan 1.3 graphics support for Linux**: Vulkan 1.3 is now supported on Linux guests with VirtIO Venus drivers in Mesa. Additionally, OpenGL 4.1 is supported with the new Apple Core OpenGL backend (macOS only). ## Notes * UTM 5 now requires macOS 13 and iOS 16 as the minimum supported version. If you are running an older version, you should stay on the last stable release of UTM 4. * We now have a [development blog](https://blog.getutm.app)! Follow us for in-depth technical deep dives such as how we brought DirectX to QEMU. * (macOS) To use the new graphics driver for Windows 11, we recommend a fresh install because the driver is still experimental and its use could lead to instability in the system. During the install of the guest tools, you will be prompted to select the experimental graphics driver. If you wish to install the new driver on a system that already is running the older display only driver, you need to run the uninstall script provided on the guest tools install ISO first. * (macOS) Apple CoreGL backend does not support Vulkan or DirectX. * KosmicKrisp is provided as a WIP but the current upstream build is incomplete so MoltenVK is the recommended driver * Linux desktop rendering in Vulkan does not work due to lack of support for indirect draws for geometry shaders. Please configure your guest to use the older VirGL Gallium driver. ## Changes (v5.0.4) * (macOS) Added support for Neptune backend in virglrenderer for DirectX support * Localization: Updated German (thanks @Benjamin123-tech) * Scripting: new reload config and VLAN commands (#7710, #7711) (thanks @GregOriol) * SPICE: Fixed various bugs in renderer that leads to performance and tearing issues * SPICE: Fixed a memory leak that could result in large amount of memory use by UTM * Updated USB icon (#7718) (thanks @tan9) * Fixed crash in UTMRegistry and memory leak in AVF installer (#7701) (thanks @Casey) ## Changes (v5.0.3) * Fixed regression in GRUB rendering time due to new graphics backend * Fixed Vulkan issues on latest Wayland * Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon) * Home: Confirm delete when using swipe left (#3086) * Home: Prevent duplicate VMs from appearing (#7533) (thanks @DevSecTim) * AVF: Fixed CPU spike and mic loss due to two audio devices (thanks @matapo) * Scripting: Added ability to get IP address from AVF machines (#7643) (thanks @hellcastter) * Scripting: Fixed "update registry" for AVM backend (#7664) (thanks @EkkoG) * Scripting: Improve USB device matching logic (thanks @TronickDev) ## Changes (v5.0.2) * Environment variables are now logged when debug log is enabled * Fixed a regression in GL acceleration where desktop might not render correctly (#7626) * Added geometry shaders support to MoltenVK to enable DXVK (thanks @Anducalliew433) (#7575) * (iOS) Fixed an issue where EAGL backend boots into a black screen (#7587) * (iOS) Fixed a crash on iOS 15 due to incompatible symbols (#7593) * (iOS) Fixed verbose logging for graphics backend * (iOS) Fixed a crash when GL is enabled due to missing support for glDrawElementsInstancedBaseVertex (#7596) * (macOS) Fixed an issue when after resizing a window if the guest outputs a different resolution size, the wrong texture resolution is used leading to misaligned cursor and warped graphics (#5781) * (macOS) Fixed an issue where the window resizes to 0x0 when native scaling is enabled ## Changes (v5.0.1) * CocoaSpice: Reworked Metal renderer to be faster and have lower latency * Fixed an issue where a BIOS file with a comma in the filename will fail to load * Default FPS will now be the maximum refresh rate of the display on macOS and iPadOS (iPhone with ProMotion will still have 60Hz as the default rate but can be overridden to 120Hz through settings) * (macOS) Fixed issue causing `HV_UNSUPPORTED` on startup with Vulkan enabled (#7579) * (iOS) Fixed resolution issue on external displays (#6040) * (iOS) Pinch to zoom will turn off automatically updating zoom from the guest (until reset with the resize button) * (iOS) Fixed external display menu not updating * (iOS) Fixed incorrect scale on external displays and connecting an external display will now automatically scale to fit * (iOS) Fixed an issue where powering off the VM will show the home screen but not terminate UTM in the background ## Changes (v5.0.0) * Add Venus support for Vulkan (#4551) * Add Apple Core OpenGL support for OpenGL 4.1 (#4285) (thanks @startergo) ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## Highlights * **Improved graphics acceleration for Linux**: Vulkan 1.3 is now supported on Linux guests with VirtIO Venus drivers in Mesa. OpenGL 4.1 is supported with the new Apple Core OpenGL backend (macOS only). ## Known Issues * (macOS) Apple CoreGL backend does not support Vulkan. * KosmicKrisp is provided as a WIP but the current upstream build is incomplete so MoltenVK is the recommended driver * Linux desktop rendering in Vulkan does not work due to lack of support for indirect draws for geometry shaders. Please configure your guest to use the older VirGL Gallium driver. ## Changes (v5.0.3) * Fixed regression in GRUB rendering time due to new graphics backend * Fixed Vulkan issues on latest Wayland * Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon) * Home: Confirm delete when using swipe left (#3086) * Home: Prevent duplicate VMs from appearing (#7533) (thanks @DevSecTim) * AVF: Fixed CPU spike and mic loss due to two audio devices (thanks @matapo) * Scripting: Added ability to get IP address from AVF machines (#7643) (thanks @hellcastter) * Scripting: Fixed "update registry" for AVM backend (#7664) (thanks @EkkoG) * Scripting: Improve USB device matching logic (thanks @TronickDev) ## Changes (v5.0.2) * Environment variables are now logged when debug log is enabled * Fixed a regression in GL acceleration where desktop might not render correctly (#7626) * Added geometry shaders support to MoltenVK to enable DXVK (thanks @Anducalliew433) (#7575) * (iOS) Fixed an issue where EAGL backend boots into a black screen (#7587) * (iOS) Fixed a crash on iOS 15 due to incompatible symbols (#7593) * (iOS) Fixed verbose logging for graphics backend * (iOS) Fixed a crash when GL is enabled due to missing support for glDrawElementsInstancedBaseVertex (#7596) * (macOS) Fixed an issue when after resizing a window if the guest outputs a different resolution size, the wrong texture resolution is used leading to misaligned cursor and warped graphics (#5781) * (macOS) Fixed an issue where the window resizes to 0x0 when native scaling is enabled ## Changes (v5.0.1) * CocoaSpice: Reworked Metal renderer to be faster and have lower latency * Fixed an issue where a BIOS file with a comma in the filename will fail to load * Default FPS will now be the maximum refresh rate of the display on macOS and iPadOS (iPhone with ProMotion will still have 60Hz as the default rate but can be overridden to 120Hz through settings) * (macOS) Fixed issue causing `HV_UNSUPPORTED` on startup with Vulkan enabled (#7579) * (iOS) Fixed resolution issue on external displays (#6040) * (iOS) Pinch to zoom will turn off automatically updating zoom from the guest (until reset with the resize button) * (iOS) Fixed external display menu not updating * (iOS) Fixed incorrect scale on external displays and connecting an external display will now automatically scale to fit * (iOS) Fixed an issue where powering off the VM will show the home screen but not terminate UTM in the background ## Changes (v5.0.0) * Add Venus support for Vulkan (#4551) * Add Apple Core OpenGL support for OpenGL 4.1 (#4285) (thanks @startergo) ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## Highlights * **Improved graphics acceleration for Linux**: Vulkan 1.3 is now supported on Linux guests with VirtIO Venus drivers in Mesa. OpenGL 4.1 is supported with the new Apple Core OpenGL backend (macOS only). ## Known Issues * (macOS) Apple CoreGL backend does not support Vulkan. * KosmicKrisp is provided as a WIP but the current upstream build is incomplete so MoltenVK is the recommended driver * Linux desktop rendering in Vulkan does not work due to lack of support for indirect draws for geometry shaders. Please configure your guest to use the older VirGL Gallium driver. ## Changes (v5.0.2) * Environment variables are now logged when debug log is enabled * Fixed a regression in GL acceleration where desktop might not render correctly (#7626) * Added geometry shaders support to MoltenVK to enable DXVK (thanks @Anducalliew433) (#7575) * (iOS) Fixed an issue where EAGL backend boots into a black screen (#7587) * (iOS) Fixed a crash on iOS 15 due to incompatible symbols (#7593) * (iOS) Fixed verbose logging for graphics backend * (iOS) Fixed a crash when GL is enabled due to missing support for glDrawElementsInstancedBaseVertex (#7596) * (macOS) Fixed an issue when after resizing a window if the guest outputs a different resolution size, the wrong texture resolution is used leading to misaligned cursor and warped graphics (#5781) * (macOS) Fixed an issue where the window resizes to 0x0 when native scaling is enabled ## Changes (v5.0.1) * CocoaSpice: Reworked Metal renderer to be faster and have lower latency * Fixed an issue where a BIOS file with a comma in the filename will fail to load * Default FPS will now be the maximum refresh rate of the display on macOS and iPadOS (iPhone with ProMotion will still have 60Hz as the default rate but can be overridden to 120Hz through settings) * (macOS) Fixed issue causing `HV_UNSUPPORTED` on startup with Vulkan enabled (#7579) * (iOS) Fixed resolution issue on external displays (#6040) * (iOS) Pinch to zoom will turn off automatically updating zoom from the guest (until reset with the resize button) * (iOS) Fixed external display menu not updating * (iOS) Fixed incorrect scale on external displays and connecting an external display will now automatically scale to fit * (iOS) Fixed an issue where powering off the VM will show the home screen but not terminate UTM in the background ## Changes (v5.0.0) * Add Venus support for Vulkan (#4551) * Add Apple Core OpenGL support for OpenGL 4.1 (#4285) (thanks @startergo) ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## Highlights * **Improved graphics acceleration for Linux**: Vulkan 1.3 is now supported on Linux guests with VirtIO Venus drivers in Mesa. OpenGL 4.1 is supported with the new Apple Core OpenGL backend (macOS only). ## Known Issues * (macOS) Apple CoreGL backend does not support Vulkan. * DXVK does not work due to missing features (#7575) * KosmicKrisp is provided as a WIP but the current upstream build is incomplete so MoltenVK is the recommended driver ## Changes (v5.0.1) * CocoaSpice: Reworked Metal renderer to be faster and have lower latency * Fixed an issue where a BIOS file with a comma in the filename will fail to load * Default FPS will now be the maximum refresh rate of the display on macOS and iPadOS (iPhone with ProMotion will still have 60Hz as the default rate but can be overridden to 120Hz through settings) * (macOS) Fixed issue causing `HV_UNSUPPORTED` on startup with Vulkan enabled (#7579) * (iOS) Fixed resolution issue on external displays (#6040) * (iOS) Pinch to zoom will turn off automatically updating zoom from the guest (until reset with the resize button) * (iOS) Fixed external display menu not updating * (iOS) Fixed incorrect scale on external displays and connecting an external display will now automatically scale to fit * (iOS) Fixed an issue where powering off the VM will show the home screen but not terminate UTM in the background ## Changes (v5.0.0) * Add Venus support for Vulkan (#4551) * Add Apple Core OpenGL support for OpenGL 4.1 (#4285) (thanks @startergo) ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## Highlights * **Improved graphics acceleration for Linux**: Vulkan 1.3 is now supported on Linux guests with VirtIO Venus drivers in Mesa. OpenGL 4.1 is supported with the new Apple Core OpenGL backend (macOS only). ## Known Issues * (macOS) Apple CoreGL backend does not support Vulkan. * DXVK does not work due to missing features (#7575) * KosmicKrisp is provided as a WIP but the current upstream build is incomplete so MoltenVK is the recommended driver * (macOS 26) VM will not start due to `HV_UNSUPPORTED` error. This is a build issue that will be addressed in the next release. Workaround: Disable Vulkan from settings. (#7579) ## Changes (v5.0.0) * Add Venus support for Vulkan (#4551) * Add Apple Core OpenGL support for OpenGL 4.1 (#4285) (thanks @startergo) ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## 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. ## Changes (v4.7.5) * Fixed some rare conditions that could lead to a VM fail to start and spin infinitely * Fixed some rare crashes that can happen after a VM stops * Fixed parsing of file paths with commas in the name (thanks @nikolan123) * ANGLE: Fixed a memory leak issue in the GLES backend (#7546) (thanks @cnnn) * ANGLE: Fixed a memory leak issue in the Metal backend (#4958) * Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon) * (macOS) Fixed App Intents on macOS 26 (#7412) (thanks @peterneutron) * (macOS) Fixed an error when file locking is disabled and a removable drive with no image selected is started (#7527) * (macOS) AVF: Fixed shared directory disconnecting when window is resized (#7488) (thanks @evan314159) * Hotfix: (1/3/25) An earlier release of v4.7.5 has an issue that prevented VMs from starting. Make sure you are on build 118. ## Changes (v4.7.4) * (macOS) Fixed a crash on VM start when a toolbar menu was reinitialized (note v4.7.4 was re-released to address this) (#7408) * Home: Fixed layout issue with button titles * (macOS) Fixed a crash when VM exits while USB is active * (iOS) Support for StikDebug on iOS 26 (non-SE only) ## 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 (#7360) * (macOS) Fixed crash when exiting full screen (#7377) ## Changes (v4.7.2) * (macOS) AVF: Fixed a crash when starting any Apple Virtualization VM (#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 (#6252) * Config: Option to reset UEFI without pre-loading Secure Boot keys (useful for custom TPM configurations) (#7005) * Config: Pre-loading Secure Boot keys will now install Microsoft UEFI 2023 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) (#6343) * Config: Provide a fixed serial number for VirtIO block devices (#7332) * QEMU: Fixed an issue which causes Windows 98 to BSoD (#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 (#6462) * USB: Fixed a rare crash when initializing the USB devices list (#5811) * SPICE: Fixed an issue where monitor configuration sent to spice-vdagent contains an invalid size (#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 (#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 (#7068) * (macOS) utmctl: Add `version` command to detect current UTM version * (macOS) Settings: New option to disable key swapping on ISO keyboards (#6976) * (macOS) Settings: New option to randomize network MAC addresses on clone (#7035) ## Changes (v4.7.1) * New Liquid Glass icon thanks to @forcequitOS * Added App Intents for VM operations (#6245) * Added UEFI boot support for RISC-V64 and LoongArch64. This allows Ubuntu for RISC-V64 to work out of the box. (#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. (#6436) * QEMU x86_64: Fixed floppy boot order configuration for other PC models (isapc, i440fx) (#7166) * QEMU PPC/M68K: Includes classicvirtio drivers to support cursor input without capture and directory sharing (#6520) * QEMU M68K: Fixed virtio drive config (#7008) * Fixed a rare crash after stopping VM due to a race condition in libusb * Home: improve screenshot contrast in Dark Mode (#6894) * Config: Fixed a crash when trying to enter a large size value 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" (#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. (#5698, #6310, #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. (#7183) * Wizard: New option to create a serial port only Linux VM. This allows Ubuntu for RISC-V64 to work out of the box. (#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 (#3504, #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 (#7297) * (macOS 11) Fixed stop button not working (#7298) * (macOS) Fixed a bug where an error message on startup leads to the window being stuck (#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 (#7211) * (macOS) Settings: New setting to disable screenshots completely for privacy reasons (#6620) * (macOS) Settings: New setting to swap Ctrl and Cmd keys in VMs (#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 (#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 (#7287) (thanks @Schamper) * (macOS) Scripting: Fixed an issue where wrong UUIDs were generated for display configs (#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) (#7234) * Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon) * Wizard: Fixed crash when VM name is empty (#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 (#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' (#7264) * (macOS) Display an error when IPSW install fails to load the file (instead of crashing) (#6855) * (macOS) Settings: Fixed a layout issue (#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](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## 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. ## Changes (v4.7.4) * (macOS) Fixed a crash on VM start when a toolbar menu was reinitialized (note v4.7.4 was re-released to address this) (#7408) * Home: Fixed layout issue with button titles * (macOS) Fixed a crash when VM exits while USB is active * (iOS) Support for StikDebug on iOS 26 (non-SE only) ## 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 (#7360) * (macOS) Fixed crash when exiting full screen (#7377) ## Changes (v4.7.2) * (macOS) AVF: Fixed a crash when starting any Apple Virtualization VM (#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 (#6252) * Config: Option to reset UEFI without pre-loading Secure Boot keys (useful for custom TPM configurations) (#7005) * Config: Pre-loading Secure Boot keys will now install Microsoft UEFI 2023 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) (#6343) * Config: Provide a fixed serial number for VirtIO block devices (#7332) * QEMU: Fixed an issue which causes Windows 98 to BSoD (#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 (#6462) * USB: Fixed a rare crash when initializing the USB devices list (#5811) * SPICE: Fixed an issue where monitor configuration sent to spice-vdagent contains an invalid size (#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 (#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 (#7068) * (macOS) utmctl: Add `version` command to detect current UTM version * (macOS) Settings: New option to disable key swapping on ISO keyboards (#6976) * (macOS) Settings: New option to randomize network MAC addresses on clone (#7035) ## Changes (v4.7.1) * New Liquid Glass icon thanks to @forcequitOS * Added App Intents for VM operations (#6245) * Added UEFI boot support for RISC-V64 and LoongArch64. This allows Ubuntu for RISC-V64 to work out of the box. (#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. (#6436) * QEMU x86_64: Fixed floppy boot order configuration for other PC models (isapc, i440fx) (#7166) * QEMU PPC/M68K: Includes classicvirtio drivers to support cursor input without capture and directory sharing (#6520) * QEMU M68K: Fixed virtio drive config (#7008) * Fixed a rare crash after stopping VM due to a race condition in libusb * Home: improve screenshot contrast in Dark Mode (#6894) * Config: Fixed a crash when trying to enter a large size value 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" (#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. (#5698, #6310, #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. (#7183) * Wizard: New option to create a serial port only Linux VM. This allows Ubuntu for RISC-V64 to work out of the box. (#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 (#3504, #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 (#7297) * (macOS 11) Fixed stop button not working (#7298) * (macOS) Fixed a bug where an error message on startup leads to the window being stuck (#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 (#7211) * (macOS) Settings: New setting to disable screenshots completely for privacy reasons (#6620) * (macOS) Settings: New setting to swap Ctrl and Cmd keys in VMs (#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 (#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 (#7287) (thanks @Schamper) * (macOS) Scripting: Fixed an issue where wrong UUIDs were generated for display configs (#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) (#7234) * Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon) * Wizard: Fixed crash when VM name is empty (#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 (#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' (#7264) * (macOS) Display an error when IPSW install fails to load the file (instead of crashing) (#6855) * (macOS) Settings: Fixed a layout issue (#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](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## 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 (#7360) * (macOS) Fixed crash when exiting full screen (#7377) ## Changes (v4.7.2) * (macOS) AVF: Fixed a crash when starting any Apple Virtualization VM (#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 (#6252) * Config: Option to reset UEFI without pre-loading Secure Boot keys (useful for custom TPM configurations) (#7005) * Config: Pre-loading Secure Boot keys will now install Microsoft UEFI 2023 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) (#6343) * Config: Provide a fixed serial number for VirtIO block devices (#7332) * QEMU: Fixed an issue which causes Windows 98 to BSoD (#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 (#6462) * USB: Fixed a rare crash when initializing the USB devices list (#5811) * SPICE: Fixed an issue where monitor configuration sent to spice-vdagent contains an invalid size (#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 (#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 (#7068) * (macOS) utmctl: Add `version` command to detect current UTM version * (macOS) Settings: New option to disable key swapping on ISO keyboards (#6976) * (macOS) Settings: New option to randomize network MAC addresses on clone (#7035) ## Changes (v4.7.1) * New Liquid Glass icon thanks to @forcequitOS * Added App Intents for VM operations (#6245) * Added UEFI boot support for RISC-V64 and LoongArch64. This allows Ubuntu for RISC-V64 to work out of the box. (#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. (#6436) * QEMU x86_64: Fixed floppy boot order configuration for other PC models (isapc, i440fx) (#7166) * QEMU PPC/M68K: Includes classicvirtio drivers to support cursor input without capture and directory sharing (#6520) * QEMU M68K: Fixed virtio drive config (#7008) * Fixed a rare crash after stopping VM due to a race condition in libusb * Home: improve screenshot contrast in Dark Mode (#6894) * Config: Fixed a crash when trying to enter a large size value 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" (#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. (#5698, #6310, #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. (#7183) * Wizard: New option to create a serial port only Linux VM. This allows Ubuntu for RISC-V64 to work out of the box. (#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 (#3504, #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 (#7297) * (macOS 11) Fixed stop button not working (#7298) * (macOS) Fixed a bug where an error message on startup leads to the window being stuck (#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 (#7211) * (macOS) Settings: New setting to disable screenshots completely for privacy reasons (#6620) * (macOS) Settings: New setting to swap Ctrl and Cmd keys in VMs (#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 (#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 (#7287) (thanks @Schamper) * (macOS) Scripting: Fixed an issue where wrong UUIDs were generated for display configs (#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) (#7234) * Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon) * Wizard: Fixed crash when VM name is empty (#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 (#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' (#7264) * (macOS) Display an error when IPSW install fails to load the file (instead of crashing) (#6855) * (macOS) Settings: Fixed a layout issue (#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](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## 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.2) * (macOS) AVF: Fixed a crash when starting any Apple Virtualization VM (#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 (#6252) * Config: Option to reset UEFI without pre-loading Secure Boot keys (useful for custom TPM configurations) (#7005) * Config: Pre-loading Secure Boot keys will now install Microsoft UEFI 2023 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) (#6343) * Config: Provide a fixed serial number for VirtIO block devices (#7332) * QEMU: Fixed an issue which causes Windows 98 to BSoD (#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 (#6462) * USB: Fixed a rare crash when initializing the USB devices list (#5811) * SPICE: Fixed an issue where monitor configuration sent to spice-vdagent contains an invalid size (#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 (#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 (#7068) * (macOS) utmctl: Add `version` command to detect current UTM version * (macOS) Settings: New option to disable key swapping on ISO keyboards (#6976) * (macOS) Settings: New option to randomize network MAC addresses on clone (#7035) ## Changes (v4.7.1) * New Liquid Glass icon thanks to @forcequitOS * Added App Intents for VM operations (#6245) * Added UEFI boot support for RISC-V64 and LoongArch64. This allows Ubuntu for RISC-V64 to work out of the box. (#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. (#6436) * QEMU x86_64: Fixed floppy boot order configuration for other PC models (isapc, i440fx) (#7166) * QEMU PPC/M68K: Includes classicvirtio drivers to support cursor input without capture and directory sharing (#6520) * QEMU M68K: Fixed virtio drive config (#7008) * Fixed a rare crash after stopping VM due to a race condition in libusb * Home: improve screenshot contrast in Dark Mode (#6894) * Config: Fixed a crash when trying to enter a large size value 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" (#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. (#5698, #6310, #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. (#7183) * Wizard: New option to create a serial port only Linux VM. This allows Ubuntu for RISC-V64 to work out of the box. (#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 (#3504, #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 (#7297) * (macOS 11) Fixed stop button not working (#7298) * (macOS) Fixed a bug where an error message on startup leads to the window being stuck (#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 (#7211) * (macOS) Settings: New setting to disable screenshots completely for privacy reasons (#6620) * (macOS) Settings: New setting to swap Ctrl and Cmd keys in VMs (#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 (#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 (#7287) (thanks @Schamper) * (macOS) Scripting: Fixed an issue where wrong UUIDs were generated for display configs (#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) (#7234) * Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon) * Wizard: Fixed crash when VM name is empty (#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 (#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' (#7264) * (macOS) Display an error when IPSW install fails to load the file (instead of crashing) (#6855) * (macOS) Settings: Fixed a layout issue (#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](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## 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 and classic Mac OS 8.x/9.x. ## Notes * (iOS) iOS 26 breaks the technique that AltJIT and similar tools use to enable JIT. ## Changes (v4.7.1) * New Liquid Glass icon thanks to @forcequitOS * Added App Intents for VM operations (#6245) * Added UEFI boot support for RISC-V64 and LoongArch64. This allows Ubuntu for RISC-V64 to work out of the box. (#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. (#6436) * QEMU x86_64: Fixed floppy boot order configuration for other PC models (isapc, i440fx) (#7166) * QEMU PPC/M68K: Includes classicvirtio drivers to support cursor input without capture and directory sharing (#6520) * QEMU M68K: Fixed virtio drive config (#7008) * Fixed a rare crash after stopping VM due to a race condition in libusb * Home: improve screenshot contrast in Dark Mode (#6894) * Config: Fixed a crash when trying to enter a large size value 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" (#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. (#5698, #6310, #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. (#7183) * Wizard: New option to create a serial port only Linux VM. This allows Ubuntu for RISC-V64 to work out of the box. (#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 (#3504, #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 (#7297) * (macOS 11) Fixed stop button not working (#7298) * (macOS) Fixed a bug where an error message on startup leads to the window being stuck (#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 (#7211) * (macOS) Settings: New setting to disable screenshots completely for privacy reasons (#6620) * (macOS) Settings: New setting to swap Ctrl and Cmd keys in VMs (#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 (#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 (#7287) (thanks @Schamper) * (macOS) Scripting: Fixed an issue where wrong UUIDs were generated for display configs (#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) (#7234) * Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon) * Wizard: Fixed crash when VM name is empty (#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 (#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' (#7264) * (macOS) Display an error when IPSW install fails to load the file (instead of crashing) (#6855) * (macOS) Settings: Fixed a layout issue (#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](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## 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. ## Notes * (iOS) iOS 26 breaks the technique that AltJIT and similar tools use to enable JIT. Do not update to iOS 26 if you want to use the JIT supported version of UTM. ## 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) (#7234) * Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon) * Wizard: Fixed crash when VM name is empty (#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 (#7150) * (macOS) Rename the main window to 'UTM Library' (#7264) * (macOS) Display an error when IPSW install fails to load the file (instead of crashing) (#6855) * (macOS) Settings: Fixed a layout issue (#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](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## Highlights * **QEMU v9.1.2** The backend has been updated to the latest upstream QEMU which brings with it a variety of bug fixes and performance improvements. * (macOS 15) **Nested virtualization for Linux** Linux VMs using Apple Virtualization backend on macOS 15 and M3 or newer will now have nested virtualization enabled by default. * (macOS 15) **Total Store Ordering for QEMU** VMs using QEMU backend on macOS 15 can now enable TSO (in QEMU settings) at the hypervisor level. When TSO is enabled on a guest operating system that is aware of the system register (i.e. Rosetta for Linux), performance of Intel emulation within the guest can be greatly improved. Note that if the guest kernel supports dynamically toggling TSO, you do not need to enable this. * (macOS 15) **Improved macOS guest support** The last window size (including full screen size) will be restored when the guest supports dynamic resolution. Removable drives and shared directories can now be ejected and changed while the macOS VM is running. Copy/paste synchronization between macOS 15 guest and host now works when the guest tools are installed (from the CD icon in the toolbar). ## Notes * (macOS) There is a known issue with macOS 15.0 and 15.0.1 where accesses to files will fail due to a permission error. This issue has been resolved with macOS 15.1. * (macOS) There is a known issue on M4 series of Macs where virtualization fails for macOS guests older than 13.4. The issue has been resolved with macOS 15.2. * The default CPU for x86_64 emulation and virtualization will now try to match the architecture of your system or the highest architecture that QEMU supports. For example, a 2016 MacBook Pro or newer will now emulate a "Skylake" based processor instead of a generic x86_64 processor. This should improve compatibility and performance of newer operating systems but may cause issues with older operating systems. If you run into issues, you can manually change the CPU model to an older one in the VM's System settings. * v4.6.5 reverted a change from v4.6.4 due to reports of crashes and kernel panics on some machines. As a result, there will be issues when upgrading to Windows 11 24H2 where the screen will go black. An alternative fix with an updated driver will be provided as soon as possible, but for now if you plan to upgrade to Windows 11 24H2, it is recommended you do it from v4.6.4 before updating UTM. ## Changes (v4.6.5) * Reverted virtio-ramfb changes from v4.6.4 due to some users experiencing crashes and kernel panics. An alternative fix to the black screen issue will come in a Windows Guest Support driver update in the future. Until that is released, issue #6332 and #6883 will be unfixed. (#6919) * Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon) * Localization: Updated Korean (thanks @somnisomni) * (iOS Remote) Show an error message when Local Network Access is not granted and support retry scanning on failure * (iOS Remote) Fix hang when QEMU terminates early * (iOS Remote) Fix crash on iOS 14 (#7034) (thanks @tearsinthegame) * (iOS Remote) Fix error starting VMs with pcspeaker * (macOS) Scripting: added icon, display, and registry configuration options (thanks @naveenrajm7) * (macOS) Fixed an issue where the cursor might be captured while a modal is presented, making closing the modal impossible (#6960, #7092) * (macOS) VM Config: Improved layout of the Apple VM shared directory page (#6712) * (macOS) When toggling a shared directory from read-only -> read-write, UTM will crash if the change fails. Now, the option will be disabled if it is known to fail. (#7001) * (macOS) Settings: New option to handle first click in QEMU VMs even if the window is in the background (#7098) * (macOS) utmctl: Fix utmctl not detecting the application bundle path if UTM.app was renamed (#7094) ## Changes (v4.6.4) * ~~Fixed an issue with virtio-ramfb device where Windows may sometimes try to render to an inactive display target causing black screen, "Guest has not initialized the display (yet)", or broken cursor. This sometimes happens right after installing the viogpudo drivers for the first time and more recently while upgrading to Windows 11 24H2. (#6332, #6883)~~ * Fixed a crash that might occur when a serial port is used and a large amount of data arrives at startup * Fixed a crash that might occur on a VM with a serial port if data arrives as the guest is shutting down * (macOS) Fixed a crash launching any ARM64 virtualized QEMU VMs on macOS Monterey or older (#6881) * (macOS) Fixed a deadlock (freeze) which can be observed if a Linux VM with GL acceleration enabled is left running for a long time (#5205) * (macOS) Fixed auto-resolution restore not working properly after a macOS guest is paused or suspended (#6874) * (macOS) Fixed an issue causing the mouse cursor to disappear when a macOS guest is paused (#6875) ## Changes (v4.6.3) * (iOS) Fixed a bug which caused Hypervisor to not work on supported devices * (macOS) Fixed a bug where the restored resolution gets re-scaled causing the window size to be incorrect (#6854, #6864) * (macOS) Workaround for a bizarre issue that causes QEMU VMs to not boot up because reading of the BIOS file results in failure ## Changes (v4.6.2) * Updated QEMU to v9.1.2 and fixed a crash during Windows setup (x86_64) (#6835) * Fixed a race condition that causes starting VM to fail with "QMP stream error seen" * (iOS) Fixed DEB install * (iOS) Fixed a crash when the main bundle executable is not the same as the currently running executable * (iOS) Fixed a crash on iOS 18 due to namespace collision with internal names * (iOS) Fixed auto-zoom to fill screen not properly working when Display Zoom is used (#6736) * (macOS) Fixed TSO mode not working in QEMU * (macOS) Fixed slow virtualization issues on Intel Macs (#6325) * (macOS) Fixed boot issues with Windows 11 24H2 (x86_64) (#6772) * (macOS) Support > 32GiB RAM configurations in QEMU (#5537) ## Changes (v4.6.1) * Updated SPICE GTK to v0.42, libsoup to v3.6.0, and phodav to 3.0 * Fixed an issue where an empty and broken .utm package is created when creation of VM fails * Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon) * Localization: Updated Japanese (thanks @MMP0) * (macOS) Fix fullscreen button showing up as zoom when the dock icon is disabled (thanks @ntoskrnl) (#6269) * (macOS) Fixed an issue "With SME enabled, at least one vector length must be enabled." when an M4 series Mac is running macOS 15.2 beta (#6790) * (macOS) Fixed permission issue with EFI vars when installed with Nix (#6725) * (macOS 13) Enable changing shared directory for newer macOS guests (#6807) * (macOS) Fixed a memory leak caused by an event listener not unregistering after the VM window is closed * (macOS) Support saving and restoring dynamic resolution when the guest supports it (both QEMU SPICE based and Apple Virtualization based guests) * (macOS) Scripting: added new import and export commands to the Apple Script interface as well as extra QEMU args to the configuration for a new VM (thanks @naveenrajm7) (#6716, #6734, #6741) * (macOS) Scripting: Fixed a crash when an invalid .utm package is found * (macOS 15) Virtualization: Fixed nested virtualization not being set (#6789) * (macOS 15) Virtualization: Support ejecting and changing removable drives while the VM is running * (macOS 15) Virtualization: Support installing guest tools for macOS guests * (macOS 15) Virtualization: Support copy-paste on macOS 15 guests when guest tools is installed * (macOS) Home: Fixed alerts not showing up * (macOS) Home: Fixed VM download confirmation not showing up when wizard is open (#6820) ## Changes (v4.6.0) * Updated to QEMU v9.1.0 * Fixed "RPC timeout" when stopping a VM * Fixed a race condition when cleaning up SPICE objects * Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon) * (iOS 16+) Home: Always show the sidebar * (macOS 15) Enable nested virtualization when available ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## Highlights * **QEMU v9.1.2** The backend has been updated to the latest upstream QEMU which brings with it a variety of bug fixes and performance improvements. * (macOS 15) **Nested virtualization for Linux** Linux VMs using Apple Virtualization backend on macOS 15 and M3 or newer will now have nested virtualization enabled by default. * (macOS 15) **Total Store Ordering for QEMU** VMs using QEMU backend on macOS 15 can now enable TSO (in QEMU settings) at the hypervisor level. When TSO is enabled on a guest operating system that is aware of the system register (i.e. Rosetta for Linux), performance of Intel emulation within the guest can be greatly improved. Note that if the guest kernel supports dynamically toggling TSO, you do not need to enable this. * (macOS 15) **Improved macOS guest support** The last window size (including full screen size) will be restored when the guest supports dynamic resolution. Removable drives and shared directories can now be ejected and changed while the macOS VM is running. Copy/paste synchronization between macOS 15 guest and host now works when the guest tools are installed (from the CD icon in the toolbar). ## Notes * (macOS) There is a known issue with macOS 15.0 and 15.0.1 where accesses to files will fail due to a permission error. This issue has been resolved with macOS 15.1. * (macOS) There is a known issue on M4 series of Macs where virtualization fails for macOS guests older than 13.4. The issue has been resolved with macOS 15.2. * The default CPU for x86_64 emulation and virtualization will now try to match the architecture of your system or the highest architecture that QEMU supports. For example, a 2016 MacBook Pro or newer will now emulate a "Skylake" based processor instead of a generic x86_64 processor. This should improve compatibility and performance of newer operating systems but may cause issues with older operating systems. If you run into issues, you can manually change the CPU model to an older one in the VM's System settings. ## Changes (v4.6.4) * Fixed an issue with virtio-ramfb device where Windows may sometimes try to render to an inactive display target causing black screen, "Guest has not initialized the display (yet)", or broken cursor. This sometimes happens right after installing the viogpudo drivers for the first time and more recently while upgrading to Windows 11 24H2. (#6332, #6883) * Fixed a crash that might occur when a serial port is used and a large amount of data arrives at startup * Fixed a crash that might occur on a VM with a serial port if data arrives as the guest is shutting down * (macOS) Fixed a crash launching any ARM64 virtualized QEMU VMs on macOS Monterey or older (#6881) * (macOS) Fixed a deadlock (freeze) which can be observed if a Linux VM with GL acceleration enabled is left running for a long time (#5205) * (macOS) Fixed auto-resolution restore not working properly after a macOS guest is paused or suspended (#6874) * (macOS) Fixed an issue causing the mouse cursor to disappear when a macOS guest is paused (#6875) ## Changes (v4.6.3) * (iOS) Fixed a bug which caused Hypervisor to not work on supported devices * (macOS) Fixed a bug where the restored resolution gets re-scaled causing the window size to be incorrect (#6854, #6864) * (macOS) Workaround for a bizarre issue that causes QEMU VMs to not boot up because reading of the BIOS file results in failure ## Changes (v4.6.2) * Updated QEMU to v9.1.2 and fixed a crash during Windows setup (x86_64) (#6835) * Fixed a race condition that causes starting VM to fail with "QMP stream error seen" * (iOS) Fixed DEB install * (iOS) Fixed a crash when the main bundle executable is not the same as the currently running executable * (iOS) Fixed a crash on iOS 18 due to namespace collision with internal names * (iOS) Fixed auto-zoom to fill screen not properly working when Display Zoom is used (#6736) * (macOS) Fixed TSO mode not working in QEMU * (macOS) Fixed slow virtualization issues on Intel Macs (#6325) * (macOS) Fixed boot issues with Windows 11 24H2 (x86_64) (#6772) * (macOS) Support > 32GiB RAM configurations in QEMU (#5537) ## Changes (v4.6.1) * Updated SPICE GTK to v0.42, libsoup to v3.6.0, and phodav to 3.0 * Fixed an issue where an empty and broken .utm package is created when creation of VM fails * Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon) * Localization: Updated Japanese (thanks @MMP0) * (macOS) Fix fullscreen button showing up as zoom when the dock icon is disabled (thanks @ntoskrnl) (#6269) * (macOS) Fixed an issue "With SME enabled, at least one vector length must be enabled." when an M4 series Mac is running macOS 15.2 beta (#6790) * (macOS) Fixed permission issue with EFI vars when installed with Nix (#6725) * (macOS 13) Enable changing shared directory for newer macOS guests (#6807) * (macOS) Fixed a memory leak caused by an event listener not unregistering after the VM window is closed * (macOS) Support saving and restoring dynamic resolution when the guest supports it (both QEMU SPICE based and Apple Virtualization based guests) * (macOS) Scripting: added new import and export commands to the Apple Script interface as well as extra QEMU args to the configuration for a new VM (thanks @naveenrajm7) (#6716, #6734, #6741) * (macOS) Scripting: Fixed a crash when an invalid .utm package is found * (macOS 15) Virtualization: Fixed nested virtualization not being set (#6789) * (macOS 15) Virtualization: Support ejecting and changing removable drives while the VM is running * (macOS 15) Virtualization: Support installing guest tools for macOS guests * (macOS 15) Virtualization: Support copy-paste on macOS 15 guests when guest tools is installed * (macOS) Home: Fixed alerts not showing up * (macOS) Home: Fixed VM download confirmation not showing up when wizard is open (#6820) ## Changes (v4.6.0) * Updated to QEMU v9.1.0 * Fixed "RPC timeout" when stopping a VM * Fixed a race condition when cleaning up SPICE objects * Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon) * (iOS 16+) Home: Always show the sidebar * (macOS 15) Enable nested virtualization when available ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## Highlights * **QEMU v9.1.2** The backend has been updated to the latest upstream QEMU which brings with it a variety of bug fixes and performance improvements. * (macOS 15) **Nested virtualization for Linux** Linux VMs using Apple Virtualization backend on macOS 15 and M3 or newer will now have nested virtualization enabled by default. * (macOS 15) **Total Store Ordering for QEMU** VMs using QEMU backend on macOS 15 can now enable TSO (in QEMU settings) at the hypervisor level. When TSO is enabled on a guest operating system that is aware of the system register (i.e. Rosetta for Linux), performance of Intel emulation within the guest can be greatly improved. Note that if the guest kernel supports dynamically toggling TSO, you do not need to enable this. * (macOS 15) **Improved macOS guest support** The last window size (including full screen size) will be restored when the guest supports dynamic resolution. Removable drives and shared directories can now be ejected and changed while the macOS VM is running. Copy/paste synchronization between macOS 15 guest and host now works when the guest tools are installed (from the CD icon in the toolbar). ## Notes * (macOS) There is a known issue with macOS 15.0 and 15.0.1 where accesses to files will fail due to a permission error. This issue has been resolved with macOS 15.1. * (macOS) There is a known issue on M4 series of Macs where virtualization fails for macOS guests older than 13.4. The issue should be addressed by Apple in a future update. ([#6794](https://github.com/utmapp/UTM/issues/6794)) * There is a known issue ([#6332](https://github.com/utmapp/UTM/issues/6332)) with Windows 11 24H2 that causes the display to show a black screen or "Guest has not initialized the display (yet)" upon boot. We recommend not upgrading to 24H2 for existing installs and 23H2 for new installs. If you have already upgraded, please follow the workaround described in the linked issue. * The default CPU for x86_64 emulation and virtualization will now try to match the architecture of your system or the highest architecture that QEMU supports. For example, a 2016 MacBook Pro or newer will now emulate a "Skylake" based processor instead of a generic x86_64 processor. This should improve compatibility and performance of newer operating systems but may cause issues with older operating systems. If you run into issues, you can manually change the CPU model to an older one in the VM's System settings. * The update to QEMU v9.1.2 will likely introduce other issues and regressions. If you experience any problem (crashes, performance, errors) that was not evident in v4.5.x, please [open an issue](https://github.com/utmapp/UTM/issues) and provide all the requested information. It would also be helpful if you can provide a reproducible example and note the last version of UTM where it worked properly. ## Changes (v4.6.3) * (iOS) Fixed a bug which caused Hypervisor to not work on supported devices * (macOS) Fixed a bug where the restored resolution gets re-scaled causing the window size to be incorrect (#6854, #6864) * (macOS) Workaround for a bizarre issue that causes QEMU VMs to not boot up because reading of the BIOS file results in failure ## Changes (v4.6.2) * Updated QEMU to v9.1.2 and fixed a crash during Windows setup (x86_64) (#6835) * Fixed a race condition that causes starting VM to fail with "QMP stream error seen" * (iOS) Fixed DEB install * (iOS) Fixed a crash when the main bundle executable is not the same as the currently running executable * (iOS) Fixed a crash on iOS 18 due to namespace collision with internal names * (iOS) Fixed auto-zoom to fill screen not properly working when Display Zoom is used (#6736) * (macOS) Fixed TSO mode not working in QEMU * (macOS) Fixed slow virtualization issues on Intel Macs (#6325) * (macOS) Fixed boot issues with Windows 11 24H2 (x86_64) (#6772) * (macOS) Support > 32GiB RAM configurations in QEMU (#5537) ## Changes (v4.6.1) * Updated SPICE GTK to v0.42, libsoup to v3.6.0, and phodav to 3.0 * Fixed an issue where an empty and broken .utm package is created when creation of VM fails * Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon) * Localization: Updated Japanese (thanks @MMP0) * (macOS) Fix fullscreen button showing up as zoom when the dock icon is disabled (thanks @ntoskrnl) (#6269) * (macOS) Fixed an issue "With SME enabled, at least one vector length must be enabled." when an M4 series Mac is running macOS 15.2 beta (#6790) * (macOS) Fixed permission issue with EFI vars when installed with Nix (#6725) * (macOS 13) Enable changing shared directory for newer macOS guests (#6807) * (macOS) Fixed a memory leak caused by an event listener not unregistering after the VM window is closed * (macOS) Support saving and restoring dynamic resolution when the guest supports it (both QEMU SPICE based and Apple Virtualization based guests) * (macOS) Scripting: added new import and export commands to the Apple Script interface as well as extra QEMU args to the configuration for a new VM (thanks @naveenrajm7) (#6716, #6734, #6741) * (macOS) Scripting: Fixed a crash when an invalid .utm package is found * (macOS 15) Virtualization: Fixed nested virtualization not being set (#6789) * (macOS 15) Virtualization: Support ejecting and changing removable drives while the VM is running * (macOS 15) Virtualization: Support installing guest tools for macOS guests * (macOS 15) Virtualization: Support copy-paste on macOS 15 guests when guest tools is installed * (macOS) Home: Fixed alerts not showing up * (macOS) Home: Fixed VM download confirmation not showing up when wizard is open (#6820) ## Changes (v4.6.0) * Updated to QEMU v9.1.0 * Fixed "RPC timeout" when stopping a VM * Fixed a race condition when cleaning up SPICE objects * Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon) * (iOS 16+) Home: Always show the sidebar * (macOS 15) Enable nested virtualization when available ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## Highlights * (macOS) **IMPORTANT NOTICE PLEASE READ**: There is a known bug in this version that prevents QEMU VMs from working. Please update to the latest version of UTM. * **QEMU v9.1.2** The backend has been updated to the latest upstream QEMU which brings with it a variety of bug fixes and performance improvements. * (macOS 15) **Nested virtualization for Linux** Linux VMs using Apple Virtualization backend on macOS 15 and M3 or newer will now have nested virtualization enabled by default. * (macOS 15) **Total Store Ordering for QEMU** VMs using QEMU backend on macOS 15 can now enable TSO (in QEMU settings) at the hypervisor level. When TSO is enabled on a guest operating system that is aware of the system register (i.e. Rosetta for Linux), performance of Intel emulation within the guest can be greatly improved. Note that if the guest kernel supports dynamically toggling TSO, you do not need to enable this. * (macOS 15) **Improved macOS guest support** The last window size (including full screen size) will be restored when the guest supports dynamic resolution. Removable drives and shared directories can now be ejected and changed while the macOS VM is running. Copy/paste synchronization between macOS 15 guest and host now works when the guest tools are installed (from the CD icon in the toolbar). ## Notes * (macOS) There is a known issue with macOS 15.0 and 15.0.1 where accesses to files will fail due to a permission error. This issue has been resolved with macOS 15.1. * (macOS) There is a known issue on M4 series of Macs where virtualization fails for macOS guests older than 13.4. The issue should be addressed by Apple in a future update. ([#6794](https://github.com/utmapp/UTM/issues/6794)) * There is a known issue ([#6332](https://github.com/utmapp/UTM/issues/6332)) with Windows 11 24H2 that causes the display to show a black screen or "Guest has not initialized the display (yet)" upon boot. We recommend not upgrading to 24H2 for existing installs and 23H2 for new installs. If you have already upgraded, please follow the workaround described in the linked issue. * The default CPU for x86_64 emulation and virtualization will now try to match the architecture of your system or the highest architecture that QEMU supports. For example, a 2016 MacBook Pro or newer will now emulate a "Skylake" based processor instead of a generic x86_64 processor. This should improve compatibility and performance of newer operating systems but may cause issues with older operating systems. If you run into issues, you can manually change the CPU model to an older one in the VM's System settings. * The update to QEMU v9.1.2 will likely introduce other issues and regressions. If you experience any problem (crashes, performance, errors) that was not evident in v4.5.x, please [open an issue](https://github.com/utmapp/UTM/issues) and provide all the requested information. It would also be helpful if you can provide a reproducible example and note the last version of UTM where it worked properly. ## Changes (v4.6.2) * Updated QEMU to v9.1.2 and fixed a crash during Windows setup (x86_64) (#6835) * Fixed a race condition that causes starting VM to fail with "QMP stream error seen" * (iOS) Fixed DEB install * (iOS) Fixed a crash when the main bundle executable is not the same as the currently running executable * (iOS) Fixed a crash on iOS 18 due to namespace collision with internal names * (iOS) Fixed auto-zoom to fill screen not properly working when Display Zoom is used (#6736) * (macOS) Fixed TSO mode not working in QEMU * (macOS) Fixed slow virtualization issues on Intel Macs (#6325) * (macOS) Fixed boot issues with Windows 11 24H2 (x86_64) (#6772) * (macOS) Support > 32GiB RAM configurations in QEMU (#5537) ## Changes (v4.6.1) * Updated SPICE GTK to v0.42, libsoup to v3.6.0, and phodav to 3.0 * Fixed an issue where an empty and broken .utm package is created when creation of VM fails * Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon) * Localization: Updated Japanese (thanks @MMP0) * (macOS) Fix fullscreen button showing up as zoom when the dock icon is disabled (thanks @ntoskrnl) (#6269) * (macOS) Fixed an issue "With SME enabled, at least one vector length must be enabled." when an M4 series Mac is running macOS 15.2 beta (#6790) * (macOS) Fixed permission issue with EFI vars when installed with Nix (#6725) * (macOS 13) Enable changing shared directory for newer macOS guests (#6807) * (macOS) Fixed a memory leak caused by an event listener not unregistering after the VM window is closed * (macOS) Support saving and restoring dynamic resolution when the guest supports it (both QEMU SPICE based and Apple Virtualization based guests) * (macOS) Scripting: added new import and export commands to the Apple Script interface as well as extra QEMU args to the configuration for a new VM (thanks @naveenrajm7) (#6716, #6734, #6741) * (macOS) Scripting: Fixed a crash when an invalid .utm package is found * (macOS 15) Virtualization: Fixed nested virtualization not being set (#6789) * (macOS 15) Virtualization: Support ejecting and changing removable drives while the VM is running * (macOS 15) Virtualization: Support installing guest tools for macOS guests * (macOS 15) Virtualization: Support copy-paste on macOS 15 guests when guest tools is installed * (macOS) Home: Fixed alerts not showing up * (macOS) Home: Fixed VM download confirmation not showing up when wizard is open (#6820) ## Changes (v4.6.0) * Updated to QEMU v9.1.0 * Fixed "RPC timeout" when stopping a VM * Fixed a race condition when cleaning up SPICE objects * Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon) * (iOS 16+) Home: Always show the sidebar * (macOS 15) Enable nested virtualization when available ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## Highlights * **QEMU v9.1.0** The backend has been updated to the latest upstream QEMU which brings with it a variety of bug fixes and performance improvements. * (macOS 15) **Nested virtualization for Linux** Linux VMs using Apple Virtualization backend on macOS 15 and M3 or newer will now have nested virtualization enabled by default. * (macOS 15) **Total Store Ordering for QEMU** VMs using QEMU backend on macOS 15 can now enable TSO (in QEMU settings) at the hypervisor level. When TSO is enabled on a guest operating system that is aware of the system register (i.e. Rosetta for Linux), performance of Intel emulation within the guest can be greatly improved. Note that if the guest kernel supports dynamically toggling TSO, you do not need to enable this. * (macOS 15) **Improved macOS guest support** The last window size (including full screen size) will be restored when the guest supports dynamic resolution. Removable drives and shared directories can now be ejected and changed while the macOS VM is running. Copy/paste synchronization between macOS 15 guest and host now works when the guest tools are installed (from the CD icon in the toolbar). ## Notes * (macOS) There is a known issue with macOS 15.0 and 15.0.1 where accesses to files will fail due to permission error. This issue has been resolved with macOS 15.1. * (macOS) There is a known issue on M4 series of Macs where virtualization fails for macOS guests older than 13.4. The issue should be addressed by Apple in a future update. (#6794) * The update to QEMU v9.1.0 will likely introduce new issues and regressions. If you experience any problem (crashes, performance, errors) that was not evident in v4.5.x, please [open an issue](https://github.com/utmapp/UTM/issues) and provide all the requested information. It would also be helpful if you can provide a reproducible example and note the last version of UTM where it worked properly. ## Changes (v4.6.1) * Updated SPICE GTK to v0.42, libsoup to v3.6.0, and phodav to 3.0 * Fixed an issue where an empty and broken .utm package is created when creation of VM fails * Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon) * Localization: Updated Japanese (thanks @MMP0) * (macOS) Fix fullscreen button showing up as zoom when the dock icon is disabled (thanks @ntoskrnl) (#6269) * (macOS) Fixed an issue "With SME enabled, at least one vector length must be enabled." when an M4 series Mac is running macOS 15.2 beta (#6790) * (macOS) Fixed permission issue with EFI vars when installed with Nix (#6725) * (macOS 13) Enable changing shared directory for newer macOS guests (#6807) * (macOS) Fixed a memory leak caused by an event listener not unregistering after the VM window is closed * (macOS) Support saving and restoring dynamic resolution when the guest supports it (both QEMU SPICE based and Apple Virtualization based guests) * (macOS) Scripting: added new import and export commands to the Apple Script interface as well as extra QEMU args to the configuration for a new VM (thanks @naveenrajm7) (#6716, #6734, #6741) * (macOS) Scripting: Fixed a crash when an invalid .utm package is found * (macOS 15) Virtualization: Fixed nested virtualization not being set (#6789) * (macOS 15) Virtualization: Support ejecting and changing removable drives while the VM is running * (macOS 15) Virtualization: Support installing guest tools for macOS guests * (macOS 15) Virtualization: Support copy-paste on macOS 15 guests when guest tools is installed * (macOS) Home: Fixed alerts not showing up * (macOS) Home: Fixed VM download confirmation not showing up when wizard is open (#6820) ## Changes (v4.6.0) * Updated to QEMU v9.1.0 * Fixed "RPC timeout" when stopping a VM * Fixed a race condition when cleaning up SPICE objects * Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon) * (iOS 16+) Home: Always show the sidebar * (macOS 15) Enable nested virtualization when available ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## Highlights * **QEMU v9.1.0** The backend has been updated to the latest upstream QEMU which brings with it a variety of bug fixes and performance improvements. * (macOS 15) **Nested virtualization for Linux** Linux VMs using Apple Virtualization backend on macOS 15 and M3 or newer will now have nested virtualization enabled by default. * (macOS 15) **Total Store Ordering for QEMU** VMs using QEMU backend on macOS 15 can now enable TSO (in QEMU settings). When TSO is enabled on a guest operating system that is aware of the system register (i.e. Rosetta for Linux), performance of Intel emulation within the guest can be greatly improved. ## Notes * There is a known issue amongst some users with UTM running on macOS 15 where accesses to files will fail due to permission error. We are still investigating this (#6639) and related issues. In the meantime, we do not recommend upgrading to macOS 15. * The update to QEMU v9.1.0 will likely introduce new issues and regressions. If you experience any problem (crashes, performance, errors) that was not evident in v4.5.x, please [open an issue](https://github.com/utmapp/UTM/issues) and provide all the requested information. It would also be helpful if you can provide a reproducible example and note the last version of UTM where it worked properly. ## Changes (v4.6.0) * Updated to QEMU v9.1.0 * Fixed "RPC timeout" when stopping a VM * Fixed a race condition when cleaning up SPICE objects * Localization: Updated Chinese (Hong Kong, Simplified) (thanks @changanmoon) * (iOS 16+) Home: Always show the sidebar * (macOS 15) Enable nested virtualization when available ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## Highlights * (macOS) **UTM Remote server for macOS** On macOS 13+, you can enable UTM Server from the new option on the home screen or from Window -> UTM Server. Once enabled, you can stream QEMU backend VMs to supported clients. The preferences page includes additional options including auto-starting the server and allowing external connections so it can be used outside of the local network. New documentation pages will be added in the future. * (macOS) **UTM Remote client for iOS and visionOS** When UTM Server is enabled on macOS, you can connect to it with the new UTM Remote client which uses the same frontend as UTM for iOS/visionOS but without any of the QEMU backend. You can get it for free on the [App Store](https://apps.apple.com/us/app/utm-remote-virtual-machines/id6470773592). * (iOS) UTM SE's wizard now allow you to create a VM easily with a floppy boot image. * (iOS SE) We now accept donations through In-App Purchase. If you would like to support us, please use the heart button on top of the list of VMs. ## Notes * (macOS) The automation URI scheme has been removed due to potential security issues if the user clicks a malicious link that sends an input to the VM. Most of the URI scheme functionality has moved to [the scripting interface](https://docs.getutm.app/scripting/scripting/). ## Changes (v4.5.4) * Fixed an issue causing "The file ... couldn't be opened" immediately after creating a new VM (#6398) * The timestamp of the .utm package will always update to the last time it runs, this should make managing backups easier (#6474) * Fixed the error "Failed to lock byte 100: Operation not supported" when trying to attach an ISO which the OS has mounted or from a network drive that does not support locking (#6564) * Fixed an issue where release notes loading can be delayed by a lack of internet connection (it should just fail silently) * Localization: Added Arabic (thanks @muhammadbahaa2001) * Localization: Updated Chinese (Simplified + Hong Kong) (thanks @changanmoon) * Localization: Updated Japanese (thanks @MMP0) * (iOS Remote) Remote: fixed empty list when a single VM is unavailable (#6380) * (iOS) Updated DEB to support rootless * (iOS) Terminal lines no longer get hidden by the top curved edge or by the keyboard (#6482) * (iOS) Fixed an issue where importing a drive shows up as a removable drive (#6485) * (iOS) Fixed an issue where creating a new drive sometimes automatically closes the popup * (iOS) External displays can now view serial output terminals (#6594) * (iOS) Added new tips overlay for new users * (macOS) Remote Server: Immediately start server when "autostart" option is checked (#6429) * (macOS) Remote Server: fixed crash when specifying an invalid port number (#6584) ## Changes (v4.5.3) * Localization: Updated Japanese (thanks @MMP0) * Localization: Updated Chinese (Simplified + Hong Kong) (thanks @changanmoon) * Localization: Updated Italian (thanks @garamb1) * (macOS) Tweaked new icon picker: clicking the icon opens the picker (#6316) and fixed some layout issues (#6317) * (macOS) Fixed an issue where mouse/keyboard was not getting released when an error message popped up and "Capture .. automatically ..." is enabled (#6352) * (macOS 14+) AVF: New option to mount drive on virtual NVMe interface when running a Linux guest with Apple Virtualization. This should address file system corruption issues. (thanks @gnattu) * (macOS 12+) AVF: Use full synchronization mode for all non-external drives. This should address file system corruption issues. (thanks @gnattu) ## Changes (v4.5.2) * Improved icon selector UI (thanks @js-john) * Changed the position of destructive buttons in various confirmation alerts to better comply with Apple Human Interface Guidelines * Wizard: New options for "Other" operating system to allow for Floppy boot as well as legacy hardware (useful for setting up a DOS machine) * Wizard: Fixed an issue where the Windows Guest Tools will be downloaded even when a non-Windows VM is created * Localization: Updated Chinese (Simplified + Hong Kong) (thanks @changanmoon) * Localization: Updated Polish (thanks @mavethee) * Localization: Updated Japanese (thanks @MMP0) * (iOS) Fixed an issue where a machine with an empty removable drive cannot be booted * (iOS) New view for donation options * (visionOS) Fixed a crash when any VM is selected * (macOS) New setting: "Capture input automatically when window is focused" when enabled will automatically capture mouse/keyboard when a QEMU VM is started and when the VM window is clicked on (thanks @js-john) * (macOS) When "Capture input automatically when entering full screen" is enabled and the cursor moves to a different workspace (for example through a gesture), the cursor will be captured again upon re-entering the QEMU VM (#6242) (thanks @haroldm) * (macOS) Server: Fixed a crash due to bad format string * (macOS) Home: Support drag & drop onto a removable drive or shared directory (#3312) (thanks @hamtiko) * (macOS) Fixed an issue where cloning/moving an AVFW VM is extremely slower than Finder (#6262) * (macOS) Added a progress indicator for long duration tasks such as cloning/moving a VM or reclaiming free space (#4006) ## Changes (v4.5.1) * Fixed an issue with file locking resulting in VMs refusing to boot (#5757, #5830) * Fixed incorrect VM size calculation (#6166) * Show confirmation popup for VM downloads (#6156) * Removed automation URI scheme due to potential security issues (#6155) * Fixed display of newly selected custom icon (#6137) * Wizard: allow completely deleting RAM and storage size (#5885) * Scripting: Fixed file and process commands not working due to incorrect object life cycle (#5963) * Localization: Updated Japanese (thanks @MMP0) * Localization: Updated Polish (thanks @mavethee) * Localization: Updated Chinese (Simplified + Traditional) (thanks @changanmoon) * (iOS) Fixed zooming with pinch (#6179) * (macOS) Fixed USB icon always disabled (#6222) * (macOS) Fixed a crash when removing a device while a text field is highlighted (#5901) * (macOS) Fixed error message when double-clicking on a headless VM which has already been started (#5972) * (macOS) AVF: New display option to disable dynamic resolution in macOS 14+ VMs (#5873) * (macOS) Remove "VM display size is fixed" global setting because it was confusing and does not do the right thing * (macOS) Fixed incorrect display scaling when host screen resolution is smaller than VM display size (#6214) ## Changes (v4.5.0) * Updated ANGLE to latest Safari version * Fixed a crash due to screenshot being saved while the image was being destroyed (#4009) * Fixed a memory leak caused by a retain cycle while observing changes in the VM state * Localization: Added Italian (thanks @garamb1) * Localization: Updated Japanese (thanks @MMP0) * Localization: Updated Polish (thanks @mavethee) * Localization: Updated Chinese (Simplified + Traditional) (thanks @changanmoon) * (macOS) Add UTM Server feature * (iOS) Fixed the icon name for UTM SE erroneously set to UTM in translation (#5968) * (iOS) Disable logging of keyboard keys when Debug Logs are enabled. They aren't helpful for any issue debugging and poses a privacy issue. * (iOS) Reworked automatic resolution changing when SPICE tools are installed * (iOS) Fix crash due to race when re-sizing while a view is being destroyed * (visionOS) Move toolbar to top of window and support hiding * (visionOS) Make VM windows less rounded * (visionOS) Integrate new keyboard view ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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. 2. Enabling JIT may require a separate JIT enabler such as [Jitterbug][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## Highlights * (macOS) **UTM Remote server for macOS** On macOS 13+, you can enable UTM Server from the new option on the home screen or from Window -> UTM Server. Once enabled, you can stream QEMU backend VMs to supported clients. The preferences page includes additional options including auto-starting the server and allowing external connections so it can be used outside of the local network. New documentation pages will be added in the future. * (macOS) **UTM Remote client for iOS and visionOS** When UTM Server is enabled on macOS, you can connect to it with the new UTM Remote client which uses the same frontend as UTM for iOS/visionOS but without any of the QEMU backend. You can get it for free on the [App Store](https://apps.apple.com/us/app/utm-remote-virtual-machines/id6470773592). * (iOS) UTM SE's wizard now allow you to create a VM easily with a floppy boot image. ## Notes * (macOS) The automation URI scheme has been removed due to potential security issues if the user clicks a malicious link that sends an input to the VM. Most of the URI scheme functionality has moved to [the scripting interface](https://docs.getutm.app/scripting/scripting/). ## Changes (v4.5.3) * Localization: Updated Japanese (thanks @MMP0) * Localization: Updated Chinese (Simplified + Hong Kong) (thanks @changanmoon) * Localization: Updated Italian (thanks @garamb1) * (macOS) Tweaked new icon picker: clicking the icon opens the picker (#6316) and fixed some layout issues (#6317) * (macOS) Fixed an issue where mouse/keyboard was not getting released when an error message popped up and "Capture .. automatically ..." is enabled (#6352) * (macOS 14+) AVF: New option to mount drive on virtual NVMe interface when running a Linux guest with Apple Virtualization. This should address file system corruption issues. (thanks @gnattu) * (macOS 12+) AVF: Use full synchronization mode for all non-external drives. This should address file system corruption issues. (thanks @gnattu) ## Changes (v4.5.2) * Improved icon selector UI (thanks @js-john) * Changed the position of destructive buttons in various confirmation alerts to better comply with Apple Human Interface Guidelines * Wizard: New options for "Other" operating system to allow for Floppy boot as well as legacy hardware (useful for setting up a DOS machine) * Wizard: Fixed an issue where the Windows Guest Tools will be downloaded even when a non-Windows VM is created * Localization: Updated Chinese (Simplified + Hong Kong) (thanks @changanmoon) * Localization: Updated Polish (thanks @mavethee) * Localization: Updated Japanese (thanks @MMP0) * (iOS) Fixed an issue where a machine with an empty removable drive cannot be booted * (iOS) New view for donation options * (visionOS) Fixed a crash when any VM is selected * (macOS) New setting: "Capture input automatically when window is focused" when enabled will automatically capture mouse/keyboard when a QEMU VM is started and when the VM window is clicked on (thanks @js-john) * (macOS) When "Capture input automatically when entering full screen" is enabled and the cursor moves to a different workspace (for example through a gesture), the cursor will be captured again upon re-entering the QEMU VM (#6242) (thanks @haroldm) * (macOS) Server: Fixed a crash due to bad format string * (macOS) Home: Support drag & drop onto a removable drive or shared directory (#3312) (thanks @hamtiko) * (macOS) Fixed an issue where cloning/moving an AVFW VM is extremely slower than Finder (#6262) * (macOS) Added a progress indicator for long duration tasks such as cloning/moving a VM or reclaiming free space (#4006) ## Changes (v4.5.1) * Fixed an issue with file locking resulting in VMs refusing to boot (#5757, #5830) * Fixed incorrect VM size calculation (#6166) * Show confirmation popup for VM downloads (#6156) * Removed automation URI scheme due to potential security issues (#6155) * Fixed display of newly selected custom icon (#6137) * Wizard: allow completely deleting RAM and storage size (#5885) * Scripting: Fixed file and process commands not working due to incorrect object life cycle (#5963) * Localization: Updated Japanese (thanks @MMP0) * Localization: Updated Polish (thanks @mavethee) * Localization: Updated Chinese (Simplified + Traditional) (thanks @changanmoon) * (iOS) Fixed zooming with pinch (#6179) * (macOS) Fixed USB icon always disabled (#6222) * (macOS) Fixed a crash when removing a device while a text field is highlighted (#5901) * (macOS) Fixed error message when double-clicking on a headless VM which has already been started (#5972) * (macOS) AVF: New display option to disable dynamic resolution in macOS 14+ VMs (#5873) * (macOS) Remove "VM display size is fixed" global setting because it was confusing and does not do the right thing * (macOS) Fixed incorrect display scaling when host screen resolution is smaller than VM display size (#6214) ## Changes (v4.5.0) * Updated ANGLE to latest Safari version * Fixed a crash due to screenshot being saved while the image was being destroyed (#4009) * Fixed a memory leak caused by a retain cycle while observing changes in the VM state * Localization: Added Italian (thanks @garamb1) * Localization: Updated Japanese (thanks @MMP0) * Localization: Updated Polish (thanks @mavethee) * Localization: Updated Chinese (Simplified + Traditional) (thanks @changanmoon) * (macOS) Add UTM Server feature * (iOS) Fixed the icon name for UTM SE erroneously set to UTM in translation (#5968) * (iOS) Disable logging of keyboard keys when Debug Logs are enabled. They aren't helpful for any issue debugging and poses a privacy issue. * (iOS) Reworked automatic resolution changing when SPICE tools are installed * (iOS) Fix crash due to race when re-sizing while a view is being destroyed * (visionOS) Move toolbar to top of window and support hiding * (visionOS) Make VM windows less rounded * (visionOS) Integrate new keyboard view ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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. 2. Enabling JIT may require a separate JIT enabler such as [Jitterbug][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## Highlights * (macOS) **UTM Remote server for macOS** On macOS 13+, you can enable UTM Server from the new option on the home screen or from Window -> UTM Server. Once enabled, you can stream QEMU backend VMs to supported clients. The preferences page includes additional options including auto-starting the server and allowing external connections so it can be used outside of the local network. New documentation pages will be added in the future. * (macOS) **UTM Remote client for iOS and visionOS** When UTM Server is enabled on macOS, you can connect to it with the new UTM Remote client which uses the same frontend as UTM for iOS/visionOS but without any of the QEMU backend. You can get it for free on the [App Store](https://apps.apple.com/us/app/utm-remote-virtual-machines/id6470773592). * (iOS) UTM SE's wizard now allow you to create a VM easily with a floppy boot image. ## Notes * (macOS) The automation URI scheme has been removed due to potential security issues if the user clicks a malicious link that sends an input to the VM. Most of the URI scheme functionality has moved to [the scripting interface](https://docs.getutm.app/scripting/scripting/). ## Changes (v4.5.2) * Improved icon selector UI (thanks @js-john) * Changed the position of destructive buttons in various confirmation alerts to better comply with Apple Human Interface Guidelines * Wizard: New options for "Other" operating system to allow for Floppy boot as well as legacy hardware (useful for setting up a DOS machine) * Wizard: Fixed an issue where the Windows Guest Tools will be downloaded even when a non-Windows VM is created * Localization: Updated Chinese (Simplified + Hong Kong) (thanks @changanmoon) * Localization: Updated Polish (thanks @mavethee) * Localization: Updated Japanese (thanks @MMP0) * (iOS) Fixed an issue where a machine with an empty removable drive cannot be booted * (iOS) New view for donation options * (visionOS) Fixed a crash when any VM is selected * (macOS) New setting: "Capture input automatically when window is focused" when enabled will automatically capture mouse/keyboard when a QEMU VM is started and when the VM window is clicked on (thanks @js-john) * (macOS) When "Capture input automatically when entering full screen" is enabled and the cursor moves to a different workspace (for example through a gesture), the cursor will be captured again upon re-entering the QEMU VM (#6242) (thanks @haroldm) * (macOS) Server: Fixed a crash due to bad format string * (macOS) Home: Support drag & drop onto a removable drive or shared directory (#3312) (thanks @hamtiko) * (macOS) Fixed an issue where cloning/moving an AVFW VM is extremely slower than Finder (#6262) * (macOS) Added a progress indicator for long duration tasks such as cloning/moving a VM or reclaiming free space (#4006) ## Changes (v4.5.1) * Fixed an issue with file locking resulting in VMs refusing to boot (#5757, #5830) * Fixed incorrect VM size calculation (#6166) * Show confirmation popup for VM downloads (#6156) * Removed automation URI scheme due to potential security issues (#6155) * Fixed display of newly selected custom icon (#6137) * Wizard: allow completely deleting RAM and storage size (#5885) * Scripting: Fixed file and process commands not working due to incorrect object life cycle (#5963) * Localization: Updated Japanese (thanks @MMP0) * Localization: Updated Polish (thanks @mavethee) * Localization: Updated Chinese (Simplified + Traditional) (thanks @changanmoon) * (iOS) Fixed zooming with pinch (#6179) * (macOS) Fixed USB icon always disabled (#6222) * (macOS) Fixed a crash when removing a device while a text field is highlighted (#5901) * (macOS) Fixed error message when double-clicking on a headless VM which has already been started (#5972) * (macOS) AVF: New display option to disable dynamic resolution in macOS 14+ VMs (#5873) * (macOS) Remove "VM display size is fixed" global setting because it was confusing and does not do the right thing * (macOS) Fixed incorrect display scaling when host screen resolution is smaller than VM display size (#6214) ## Changes (v4.5.0) * Updated ANGLE to latest Safari version * Fixed a crash due to screenshot being saved while the image was being destroyed (#4009) * Fixed a memory leak caused by a retain cycle while observing changes in the VM state * Localization: Added Italian (thanks @garamb1) * Localization: Updated Japanese (thanks @MMP0) * Localization: Updated Polish (thanks @mavethee) * Localization: Updated Chinese (Simplified + Traditional) (thanks @changanmoon) * (macOS) Add UTM Server feature * (iOS) Fixed the icon name for UTM SE erroneously set to UTM in translation (#5968) * (iOS) Disable logging of keyboard keys when Debug Logs are enabled. They aren't helpful for any issue debugging and poses a privacy issue. * (iOS) Reworked automatic resolution changing when SPICE tools are installed * (iOS) Fix crash due to race when re-sizing while a view is being destroyed * (visionOS) Move toolbar to top of window and support hiding * (visionOS) Make VM windows less rounded * (visionOS) Integrate new keyboard view ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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. 2. Enabling JIT may require a separate JIT enabler such as [Jitterbug][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## Highlights * **UTM Remote server for macOS** On macOS 13+, you can enable UTM Server from the new option on the home screen or from Window -> UTM Server. Once enabled, you can stream QEMU backend VMs to supported clients. The preferences page includes additional options including auto-starting the server and allowing external connections so it can be used outside of the local network. New documentation pages will be added in the future. * **UTM Remote client for iOS and visionOS** When UTM Server is enabled on macOS, you can connect to it with the new UTM Remote client which uses the same frontend as UTM for iOS/visionOS but without any of the QEMU backend. TestFlight will be available as soon as it is approved and the plans are to release it as a free app in the App Store. ## Notes * (macOS) The automation URI scheme has been removed due to potential security issues if the user clicks a malicious link that sends an input to the VM. Most of the URI scheme functionality has moved to [the scripting interface](https://docs.getutm.app/scripting/scripting/). ## Changes (v4.5.1) * Fixed an issue with file locking resulting in VMs refusing to boot (#5757, #5830) * Fixed incorrect VM size calculation (#6166) * Show confirmation popup for VM downloads (#6156) * Removed automation URI scheme due to potential security issues (#6155) * Fixed display of newly selected custom icon (#6137) * Wizard: allow completely deleting RAM and storage size (#5885) * Scripting: Fixed file and process commands not working due to incorrect object life cycle (#5963) * Localization: Updated Japanese (thanks @MMP0) * Localization: Updated Polish (thanks @mavethee) * Localization: Updated Chinese (Simplified + Traditional) (thanks @changanmoon) * (iOS) Fixed zooming with pinch (#6179) * (macOS) Fixed USB icon always disabled (#6222) * (macOS) Fixed a crash when removing a device while a text field is highlighted (#5901) * (macOS) Fixed error message when double-clicking on a headless VM which has already been started (#5972) * (macOS) AVF: New display option to disable dynamic resolution in macOS 14+ VMs (#5873) * (macOS) Remove "VM display size is fixed" global setting because it was confusing and does not do the right thing * (macOS) Fixed incorrect display scaling when host screen resolution is smaller than VM display size (#6214) ## Changes (v4.5.0) * Updated ANGLE to latest Safari version * Fixed a crash due to screenshot being saved while the image was being destroyed (#4009) * Fixed a memory leak caused by a retain cycle while observing changes in the VM state * Localization: Added Italian (thanks @garamb1) * Localization: Updated Japanese (thanks @MMP0) * Localization: Updated Polish (thanks @mavethee) * Localization: Updated Chinese (Simplified + Traditional) (thanks @changanmoon) * (macOS) Add UTM Server feature * (iOS) Fixed the icon name for UTM SE erroneously set to UTM in translation (#5968) * (iOS) Disable logging of keyboard keys when Debug Logs are enabled. They aren't helpful for any issue debugging and poses a privacy issue. * (iOS) Reworked automatic resolution changing when SPICE tools are installed * (iOS) Fix crash due to race when re-sizing while a view is being destroyed * (visionOS) Move toolbar to top of window and support hiding * (visionOS) Make VM windows less rounded * (visionOS) Integrate new keyboard view ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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. 2. Enabling JIT may require a separate JIT enabler such as [Jitterbug][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## Highlights * **UTM Remote server for macOS** On macOS 13+, you can enable UTM Server from the new option on the home screen or from Window -> UTM Server. Once enabled, you can stream QEMU backend VMs to supported clients. The preferences page includes additional options including auto-starting the server and allowing external connections so it can be used outside of the local network. New documentation pages will be added in the future. * **UTM Remote client for iOS and visionOS** When UTM Server is enabled on macOS, you can connect to it with the new UTM Remote client which uses the same frontend as UTM for iOS/visionOS but without any of the QEMU backend. TestFlight will be available as soon as it is approved and the plans are to release it as a free app in the App Store. ## Changes (v4.5.0) * Updated ANGLE to latest Safari version * Fixed a crash due to screenshot being saved while the image was being destroyed (#4009) * Fixed a memory leak caused by a retain cycle while observing changes in the VM state * Localization: Added Italian (thanks @garamb1) * Localization: Updated Japanese (thanks @MMP0) * Localization: Updated Polish (thanks @mavethee) * Localization: Updated Chinese (Simplified + Traditional) (thanks @changanmoon) * (macOS) Add UTM Server feature * (iOS) Fixed the icon name for UTM SE erroneously set to UTM in translation (#5968) * (iOS) Disable logging of keyboard keys when Debug Logs are enabled. They aren't helpful for any issue debugging and poses a privacy issue. * (iOS) Reworked automatic resolution changing when SPICE tools are installed * (iOS) Fix crash due to race when re-sizing while a view is being destroyed * (visionOS) Move toolbar to top of window and support hiding * (visionOS) Make VM windows less rounded * (visionOS) Integrate new keyboard view ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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. 2. Enabling JIT may require a separate JIT enabler such as [Jitterbug][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

**macOS Users:** there is no difference between v4.4.4 and v4.4.5. You do not need to update. ## Highlights * **macOS Sonoma support** New Apple Virtualization features include save/restore VM state and dynamic resolution for macOS Sonoma guests. Note that currently, you must remove the Sound and Entropy device in order to use save/restore VM state. * **Automatically save state when you close a VM** This will only work on VMs that support save states. If your VM does not support it, you will get an error message with an explanation. * (macOS) **USB commands in utmctl** You can now use `utmctl usb` commands to connect and disconnect USB devices from a running VM. * (iOS) **TrollStore support for newer iOS** With the release of [TrollStore 2](https://github.com/opa334/TrollStore), this update brings JIT support for all iOS device that can run TrollStore. If (and only if) you are on at most iOS 16.3.1 AND your device is M1, M2, or A16, then you can also use the virtualization option. No other device or higher iOS version will likely ever be supported due to Apple [removing Hypervisor in iOS 16.4](http://twitter.com/utmapp/status/1708907045314035986). The only way around this is if Apple un-deletes the code (unlikely) or a jailbreak powerful enough to run a custom kernel is released (even more unlikely as this has never been done on a modern iOS device). ## Notes * (macOS) If you are running a virtualized VM on an Intel Mac with TPM enabled and the guest freezes on startup, you will need to temporarily disable Hypervisor (Settings -> QEMU -> Use Hypervisor), boot into Windows, and then re-enable Hypervisor after shutting down. The TPM device changed in v4.4.1 and this causes an issue on existing VMs. * (macOS) When entering full-screen, auto-capture of system keys in AVF (introduced in v4.3.2) and of mouse in QEMU (introduced in v4.4.0) is no longer default. You can enable the option in preferences (Cmd+,) under the Input tab. * Linux guests: Mesa 23.2.1 introduced a bug that will crash UTM with the error `GL_ARB_clear_texture`. If you experience this bug, temporarily disable GPU acceleration, then downgrade your Mesa package (or update to the next version when it comes out/nightly build), and the switch back to GPU acceleration. * Windows guests: the guest tools have been updated to fix the double cursor bug as well as some driver signing issues when Secure Boot is enabled. To update the guest tools, make sure you have ejected any mounted ISO and then use the CD icon and select "Install Windows Guest Tools". This should automatically download and mount the latest tools. ## Changes (v4.4.5) * Fixed a "device not found" error when starting a VM with an empty interface (#5845) * Fixed JIT for TrollStore builds (#5216) (thanks @crstestacc) * Added support for virtualization on iOS 16.3.1 and lower (M1, M2, A16 only) (thanks @xliuxu) ## Changes (v4.4.4) * (macOS) AVF: Fixed keyboard device not showing up on older macOS guests (#5814) ## Changes (v4.4.3) * Guest Tools: supports caching the latest version and will only re-download when a newer version is available (#5692) * Fixed a bug where a suspended QEMU VM with a locked CD drive will refuse to resume * Localization: Updated Russian (thanks @s0rd3s) * (visionOS) Fixed display scaling sometimes not applying * (visionOS) Reimplemented multiple-window support with newer APIs and fixes an issue where the main window is resized on startup to the last VM display size * (visionOS) Process gaze touch events as indirect input * (visionOS) Fixed an issue where the keyboard button was not opening the keyboard and sometimes causes the keyboard to keep popping up after being closed * (macOS) Fixed an issue where `efi_vars.fd` is locked when the QEMU process deadlocks (#5769) ## Changes (v4.4.2) * Added some default devices for PPC64 (#5737, #5734) * Fixed an issue where some VMs refuse to boot (#5745) * QEMUKit: Fixed a memory leak due to a retain cycle * Fixed an issue where ejecting an ISO or removing a shared directory does not sync after saving (#5708) * Localization: Added Russian (thanks @s0rd3s) * Localization: Added Chinese (Hong Kong) (thanks @changanmoon) * Localization: Updated Chinese (Traditional) (thanks @PeterDaveHello) * (visionOS) Added button to open preferences * (visionOS) Removed unused options from preferences * (macOS) Fixed crash when closing terminal too early (#5660) * (macOS) Fixed duplicate windows opening when suspending a VM with multiple windows and restarting it * (macOS) Fixed some resource leak issues when suspending a VM on close * (macOS) AVF: Added MacBook Air M2 resolutions to the predefined list (#5716) * (macOS) AVF: Fixed an error on deleting "vmstate" when force stopping a VM (#5758) ## Changes (v4.4.1) * Hide keystroke data from debug logs (#5651) * Scripting: add new `usb devices` element * utmctl: add new `usb` command * Fixed an issue where bookmarks to removable drives and shares were not being saved (#5615) * Fixed an issue where some VMs failed to boot due to suspend support probing (#5624) * Fixed TPM support for x86_64/i386 VMs (#5619) * Fixed an issue where starting a VM fails when a removable floppy disk is used * Fixed an issue where the PTTY address is not shown * Fixed an issue where new lines could be inserted into the VM name through copy and paste (#5627) * Localization: Updated Japanese (thanks @MMP0) * (iOS) Wizard: do not disable the emulation button even if JIT is not enabled * (visionOS) Fixed build issues due to API changes in the latest Xcode * (visionOS) Fixed display of release notes * (macOS) Allow clearing of installer IPSW from settings (#5611) * (macOS) Moved auto-capture of mouse/keyboard in full screen as a preference and do not enable it by default (#5633) * (macOS) AVF: File sizes displayed are now the size occupied on disk to be more consistent with QEMU VMs (#5637) * (macOS) AVF: Fixed macOS installer not working when a shared directory is selected (#5634) * (macOS) AVF: Fixed an issue where shared directory cannot be selected from the home screen (#5617) * (macOS) AVF: Fixed an issue where the cursor could disappear after a VM is stopped (#5607) * (macOS 14) Wizard: Excess separators shown by SwiftUI changes are now hidden * (macOS 12+) Settings sheet should have the bottom toolbar stop before the sidebar in compliance with HIG standards ## Changes (v4.4.0) * Fixed an issue where shared directories and removable drives did not persist when UTM is closed (#5531) * Replaced ANGLE with WebKit ANGLE * Fixed an issue in gstreamer which can crash if an error happens before start * Fixed a race condition that broke BIOS loading (#5523) * Fixed the automatic screenshot timer (#5541) * Fixed UI lockup during a long copy operation when moving/exporting VM * Localization: Updated Polish (thanks @ku1ik) * Localization: Updated French (thanks @alex-kinokon) * Localization: Updated Traditional Chinese (thanks @pan93412) * Localization: Updated Simplified Chinese (thanks @changanmoon) * (iOS) Fixed an issue where quickly double tapping on the play button results in various issues * (iOS) Fixed "Retina" mode resizing so the native display dimensions are passed to the guest * (macOS) utmctl: Fixed an issue where the CLI did not work properly if UTM.app was not located in /Applications (#5526) * (macOS) Fixed window resize not automatically updating the guest dynamic resolution if Accessibility APIs are used (#5577) * (macOS) Automatically capture the mouse (after displaying a confirmation message) when entering full screen (#5514) * (macOS) Automatically save state when closing a VM (#5591) * (macOS) AVF: shared directory is now automatically mounted on macOS 13+ (#5571) * (macOS 14) Fixed IPSW selection * (macOS 14) AVF: implemented save/restore VM state * (macOS 14) AVF: enable Rosetta caching if supported by the host * (macOS 14) AVF: automatically re-size macOS 14 guests ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## Highlights * **macOS Sonoma support** New Apple Virtualization features include save/restore VM state and dynamic resolution for macOS Sonoma guests. Note that currently, you must remove the Sound and Entropy device in order to use save/restore VM state. * **Automatically save state when you close a VM** This will only work on VMs that support save states. If your VM does not support it, you will get an error message with an explanation. * (macOS) **USB commands in utmctl** You can now use `utmctl usb` commands to connect and disconnect USB devices from a running VM. ## Notes * (macOS) If you are running a virtualized VM on an Intel Mac with TPM enabled and the guest freezes on startup, you will need to temporarily disable Hypervisor (Settings -> QEMU -> Use Hypervisor), boot into Windows, and then re-enable Hypervisor after shutting down. The TPM device changed in v4.4.1 and this causes an issue on existing VMs. * (macOS) When entering full-screen, auto-capture of system keys in AVF (introduced in v4.3.2) and of mouse in QEMU (introduced in v4.4.0) is no longer default. You can enable the option in preferences (Cmd+,) under the Input tab. * Linux guests: Mesa 23.2.1 introduced a bug that will crash UTM with the error `GL_ARB_clear_texture`. If you experience this bug, temporarily disable GPU acceleration, then downgrade your Mesa package (or update to the next version when it comes out/nightly build), and the switch back to GPU acceleration. * Windows guests: the guest tools have been updated to fix the double cursor bug as well as some driver signing issues when Secure Boot is enabled. To update the guest tools, make sure you have ejected any mounted ISO and then use the CD icon and select "Install Windows Guest Tools". This should automatically download and mount the latest tools. ## Changes (v4.4.4) * (macOS) AVF: Fixed keyboard device not showing up on older macOS guests (#5814) ## Changes (v4.4.3) * Guest Tools: supports caching the latest version and will only re-download when a newer version is available (#5692) * Fixed a bug where a suspended QEMU VM with a locked CD drive will refuse to resume * Localization: Updated Russian (thanks @s0rd3s) * (visionOS) Fixed display scaling sometimes not applying * (visionOS) Reimplemented multiple-window support with newer APIs and fixes an issue where the main window is resized on startup to the last VM display size * (visionOS) Process gaze touch events as indirect input * (visionOS) Fixed an issue where the keyboard button was not opening the keyboard and sometimes causes the keyboard to keep popping up after being closed * (macOS) Fixed an issue where `efi_vars.fd` is locked when the QEMU process deadlocks (#5769) ## Changes (v4.4.2) * Added some default devices for PPC64 (#5737, #5734) * Fixed an issue where some VMs refuse to boot (#5745) * QEMUKit: Fixed a memory leak due to a retain cycle * Fixed an issue where ejecting an ISO or removing a shared directory does not sync after saving (#5708) * Localization: Added Russian (thanks @s0rd3s) * Localization: Added Chinese (Hong Kong) (thanks @changanmoon) * Localization: Updated Chinese (Traditional) (thanks @PeterDaveHello) * (visionOS) Added button to open preferences * (visionOS) Removed unused options from preferences * (macOS) Fixed crash when closing terminal too early (#5660) * (macOS) Fixed duplicate windows opening when suspending a VM with multiple windows and restarting it * (macOS) Fixed some resource leak issues when suspending a VM on close * (macOS) AVF: Added MacBook Air M2 resolutions to the predefined list (#5716) * (macOS) AVF: Fixed an error on deleting "vmstate" when force stopping a VM (#5758) ## Changes (v4.4.1) * Hide keystroke data from debug logs (#5651) * Scripting: add new `usb devices` element * utmctl: add new `usb` command * Fixed an issue where bookmarks to removable drives and shares were not being saved (#5615) * Fixed an issue where some VMs failed to boot due to suspend support probing (#5624) * Fixed TPM support for x86_64/i386 VMs (#5619) * Fixed an issue where starting a VM fails when a removable floppy disk is used * Fixed an issue where the PTTY address is not shown * Fixed an issue where new lines could be inserted into the VM name through copy and paste (#5627) * Localization: Updated Japanese (thanks @MMP0) * (iOS) Wizard: do not disable the emulation button even if JIT is not enabled * (visionOS) Fixed build issues due to API changes in the latest Xcode * (visionOS) Fixed display of release notes * (macOS) Allow clearing of installer IPSW from settings (#5611) * (macOS) Moved auto-capture of mouse/keyboard in full screen as a preference and do not enable it by default (#5633) * (macOS) AVF: File sizes displayed are now the size occupied on disk to be more consistent with QEMU VMs (#5637) * (macOS) AVF: Fixed macOS installer not working when a shared directory is selected (#5634) * (macOS) AVF: Fixed an issue where shared directory cannot be selected from the home screen (#5617) * (macOS) AVF: Fixed an issue where the cursor could disappear after a VM is stopped (#5607) * (macOS 14) Wizard: Excess separators shown by SwiftUI changes are now hidden * (macOS 12+) Settings sheet should have the bottom toolbar stop before the sidebar in compliance with HIG standards ## Changes (v4.4.0) * Fixed an issue where shared directories and removable drives did not persist when UTM is closed (#5531) * Replaced ANGLE with WebKit ANGLE * Fixed an issue in gstreamer which can crash if an error happens before start * Fixed a race condition that broke BIOS loading (#5523) * Fixed the automatic screenshot timer (#5541) * Fixed UI lockup during a long copy operation when moving/exporting VM * Localization: Updated Polish (thanks @ku1ik) * Localization: Updated French (thanks @alex-kinokon) * Localization: Updated Traditional Chinese (thanks @pan93412) * Localization: Updated Simplified Chinese (thanks @changanmoon) * (iOS) Fixed an issue where quickly double tapping on the play button results in various issues * (iOS) Fixed "Retina" mode resizing so the native display dimensions are passed to the guest * (macOS) utmctl: Fixed an issue where the CLI did not work properly if UTM.app was not located in /Applications (#5526) * (macOS) Fixed window resize not automatically updating the guest dynamic resolution if Accessibility APIs are used (#5577) * (macOS) Automatically capture the mouse (after displaying a confirmation message) when entering full screen (#5514) * (macOS) Automatically save state when closing a VM (#5591) * (macOS) AVF: shared directory is now automatically mounted on macOS 13+ (#5571) * (macOS 14) Fixed IPSW selection * (macOS 14) AVF: implemented save/restore VM state * (macOS 14) AVF: enable Rosetta caching if supported by the host * (macOS 14) AVF: automatically re-size macOS 14 guests ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## Highlights * **macOS Sonoma support** New Apple Virtualization features include save/restore VM state and dynamic resolution for macOS Sonoma guests. Note that currently, you must remove the Sound and Entropy device in order to use save/restore VM state. * **visionOS support** UTM is now working on visionOS but until we get our hands on a real device, it is TBD on how to actually run it. If you are a lucky owner of a development unit, you can try it out yourself with the provided IPAs. * **Automatically save state when you close a VM** This will only work on VMs that support save states. If your VM does not support it, you will get an error message with an explanation. * (macOS) **USB commands in utmctl** You can now use `utmctl usb` commands to connect and disconnect USB devices from a running VM. ## Notes * (macOS) If you are running a virtualized VM on an Intel Mac with TPM enabled and the guest freezes on startup, you will need to temporarily disable Hypervisor (Settings -> QEMU -> Use Hypervisor), boot into Windows, and then re-enable Hypervisor after shutting down. The TPM device changed in v4.4.1 and this causes an issue on existing VMs. * (macOS) When entering full-screen, auto-capture of system keys in AVF (introduced in v4.3.2) and of mouse in QEMU (introduced in v4.4.0) is no longer default. You can enable the option in preferences (Cmd+,) under the Input tab. * Linux guests: Mesa 23.2.1 introduced a bug that will crash UTM with the error `GL_ARB_clear_texture`. If you experience this bug, temporarily disable GPU acceleration, then downgrade your Mesa package (or update to the next version when it comes out/nightly build), and the switch back to GPU acceleration. ## Changes (v4.4.3) * Guest Tools: supports caching the latest version and will only re-download when a newer version is available (#5692) * Fixed a bug where a suspended QEMU VM with a locked CD drive will refuse to resume * Localization: Updated Russian (thanks @s0rd3s) * (visionOS) Fixed display scaling sometimes not applying * (visionOS) Reimplemented multiple-window support with newer APIs and fixes an issue where the main window is resized on startup to the last VM display size * (visionOS) Process gaze touch events as indirect input * (visionOS) Fixed an issue where the keyboard button was not opening the keyboard and sometimes causes the keyboard to keep popping up after being closed * (macOS) Fixed an issue where `efi_vars.fd` is locked when the QEMU process deadlocks (#5769) ## Changes (v4.4.2) * Added some default devices for PPC64 (#5737, #5734) * Fixed an issue where some VMs refuse to boot (#5745) * QEMUKit: Fixed a memory leak due to a retain cycle * Fixed an issue where ejecting an ISO or removing a shared directory does not sync after saving (#5708) * Localization: Added Russian (thanks @s0rd3s) * Localization: Added Chinese (Hong Kong) (thanks @changanmoon) * Localization: Updated Chinese (Traditional) (thanks @PeterDaveHello) * (visionOS) Added button to open preferences * (visionOS) Removed unused options from preferences * (macOS) Fixed crash when closing terminal too early (#5660) * (macOS) Fixed duplicate windows opening when suspending a VM with multiple windows and restarting it * (macOS) Fixed some resource leak issues when suspending a VM on close * (macOS) AVF: Added MacBook Air M2 resolutions to the predefined list (#5716) * (macOS) AVF: Fixed an error on deleting "vmstate" when force stopping a VM (#5758) ## Changes (v4.4.1) * Hide keystroke data from debug logs (#5651) * Scripting: add new `usb devices` element * utmctl: add new `usb` command * Fixed an issue where bookmarks to removable drives and shares were not being saved (#5615) * Fixed an issue where some VMs failed to boot due to suspend support probing (#5624) * Fixed TPM support for x86_64/i386 VMs (#5619) * Fixed an issue where starting a VM fails when a removable floppy disk is used * Fixed an issue where the PTTY address is not shown * Fixed an issue where new lines could be inserted into the VM name through copy and paste (#5627) * Localization: Updated Japanese (thanks @MMP0) * (iOS) Wizard: do not disable the emulation button even if JIT is not enabled * (visionOS) Fixed build issues due to API changes in the latest Xcode * (visionOS) Fixed display of release notes * (macOS) Allow clearing of installer IPSW from settings (#5611) * (macOS) Moved auto-capture of mouse/keyboard in full screen as a preference and do not enable it by default (#5633) * (macOS) AVF: File sizes displayed are now the size occupied on disk to be more consistent with QEMU VMs (#5637) * (macOS) AVF: Fixed macOS installer not working when a shared directory is selected (#5634) * (macOS) AVF: Fixed an issue where shared directory cannot be selected from the home screen (#5617) * (macOS) AVF: Fixed an issue where the cursor could disappear after a VM is stopped (#5607) * (macOS 14) Wizard: Excess separators shown by SwiftUI changes are now hidden * (macOS 12+) Settings sheet should have the bottom toolbar stop before the sidebar in compliance with HIG standards ## Changes (v4.4.0) * Fixed an issue where shared directories and removable drives did not persist when UTM is closed (#5531) * Replaced ANGLE with WebKit ANGLE * Fixed an issue in gstreamer which can crash if an error happens before start * Fixed a race condition that broke BIOS loading (#5523) * Fixed the automatic screenshot timer (#5541) * Fixed UI lockup during a long copy operation when moving/exporting VM * Localization: Updated Polish (thanks @ku1ik) * Localization: Updated French (thanks @alex-kinokon) * Localization: Updated Traditional Chinese (thanks @pan93412) * Localization: Updated Simplified Chinese (thanks @changanmoon) * (iOS) Fixed an issue where quickly double tapping on the play button results in various issues * (iOS) Fixed "Retina" mode resizing so the native display dimensions are passed to the guest * (macOS) utmctl: Fixed an issue where the CLI did not work properly if UTM.app was not located in /Applications (#5526) * (macOS) Fixed window resize not automatically updating the guest dynamic resolution if Accessibility APIs are used (#5577) * (macOS) Automatically capture the mouse (after displaying a confirmation message) when entering full screen (#5514) * (macOS) Automatically save state when closing a VM (#5591) * (macOS) AVF: shared directory is now automatically mounted on macOS 13+ (#5571) * (macOS 14) Fixed IPSW selection * (macOS 14) AVF: implemented save/restore VM state * (macOS 14) AVF: enable Rosetta caching if supported by the host * (macOS 14) AVF: automatically re-size macOS 14 guests ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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-visionOS.ipa | visionOS version (sideloading) | Custom resigning | ? | No | No | | UTM-SE-visionOS.ipa | visionOS version (sideloading) | Custom resigning | No | No | No | 1. Hypervisor on iOS requires an M1 iPad. 2. Enabling JIT may require a separate JIT enabler such as [Jitterbug][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## Highlights * **macOS Sonoma support** New Apple Virtualization features include save/restore VM state and dynamic resolution for macOS Sonoma guests. Note that currently, you must remove the Sound and Entropy device in order to use save/restore VM state. * **visionOS support** UTM is now working on visionOS but until we get our hands on a real device, it is TBD on how to actually run it. If you are a lucky owner of a development unit, you can try it out yourself with the provided IPAs. * **Automatically save state when you close a VM** This will only work on VMs that support save states. If your VM does not support it, you will get an error message with an explanation. * (macOS) **USB commands in utmctl** You can now use `utmctl usb` commands to connect and disconnect USB devices from a running VM. ## Notes * (macOS) If you are running a virtualized VM on an Intel Mac with TPM enabled and the guest freezes on startup, you will need to temporarily disable Hypervisor (Settings -> QEMU -> Use Hypervisor), boot into Windows, and then re-enable Hypervisor after shutting down. The TPM device changed in v4.4.1 and this causes an issue on existing VMs. * (macOS) When entering full-screen, auto-capture of system keys in AVF (introduced in v4.3.2) and of mouse in QEMU (introduced in v4.4.0) is no longer default. You can enable the option in preferences (Cmd+,) under the Input tab. ## Changes (v4.4.2) * Added some default devices for PPC64 (#5737, #5734) * Fixed an issue where some VMs refuse to boot (#5745) * QEMUKit: Fixed a memory leak due to a retain cycle * Fixed an issue where ejecting an ISO or removing a shared directory does not sync after saving (#5708) * Localization: Added Russian (thanks @s0rd3s) * Localization: Added Chinese (Hong Kong) (thanks @changanmoon) * Localization: Updated Chinese (Traditional) (thanks @PeterDaveHello) * (visionOS) Added button to open preferences * (visionOS) Removed unused options from preferences * (macOS) Fixed crash when closing terminal too early (#5660) * (macOS) Fixed duplicate windows opening when suspending a VM with multiple windows and restarting it * (macOS) Fixed some resource leak issues when suspending a VM on close * (macOS) AVF: Added MacBook Air M2 resolutions to the predefined list (#5716) * (macOS) AVF: Fixed an error on deleting "vmstate" when force stopping a VM (#5758) ## Changes (v4.4.1) * Hide keystroke data from debug logs (#5651) * Scripting: add new `usb devices` element * utmctl: add new `usb` command * Fixed an issue where bookmarks to removable drives and shares were not being saved (#5615) * Fixed an issue where some VMs failed to boot due to suspend support probing (#5624) * Fixed TPM support for x86_64/i386 VMs (#5619) * Fixed an issue where starting a VM fails when a removable floppy disk is used * Fixed an issue where the PTTY address is not shown * Fixed an issue where new lines could be inserted into the VM name through copy and paste (#5627) * Localization: Updated Japanese (thanks @MMP0) * (iOS) Wizard: do not disable the emulation button even if JIT is not enabled * (visionOS) Fixed build issues due to API changes in the latest Xcode * (visionOS) Fixed display of release notes * (macOS) Allow clearing of installer IPSW from settings (#5611) * (macOS) Moved auto-capture of mouse/keyboard in full screen as a preference and do not enable it by default (#5633) * (macOS) AVF: File sizes displayed are now the size occupied on disk to be more consistent with QEMU VMs (#5637) * (macOS) AVF: Fixed macOS installer not working when a shared directory is selected (#5634) * (macOS) AVF: Fixed an issue where shared directory cannot be selected from the home screen (#5617) * (macOS) AVF: Fixed an issue where the cursor could disappear after a VM is stopped (#5607) * (macOS 14) Wizard: Excess separators shown by SwiftUI changes are now hidden * (macOS 12+) Settings sheet should have the bottom toolbar stop before the sidebar in compliance with HIG standards ## Changes (v4.4.0) * Fixed an issue where shared directories and removable drives did not persist when UTM is closed (#5531) * Replaced ANGLE with WebKit ANGLE * Fixed an issue in gstreamer which can crash if an error happens before start * Fixed a race condition that broke BIOS loading (#5523) * Fixed the automatic screenshot timer (#5541) * Fixed UI lockup during a long copy operation when moving/exporting VM * Localization: Updated Polish (thanks @ku1ik) * Localization: Updated French (thanks @alex-kinokon) * Localization: Updated Traditional Chinese (thanks @pan93412) * Localization: Updated Simplified Chinese (thanks @changanmoon) * (iOS) Fixed an issue where quickly double tapping on the play button results in various issues * (iOS) Fixed "Retina" mode resizing so the native display dimensions are passed to the guest * (macOS) utmctl: Fixed an issue where the CLI did not work properly if UTM.app was not located in /Applications (#5526) * (macOS) Fixed window resize not automatically updating the guest dynamic resolution if Accessibility APIs are used (#5577) * (macOS) Automatically capture the mouse (after displaying a confirmation message) when entering full screen (#5514) * (macOS) Automatically save state when closing a VM (#5591) * (macOS) AVF: shared directory is now automatically mounted on macOS 13+ (#5571) * (macOS 14) Fixed IPSW selection * (macOS 14) AVF: implemented save/restore VM state * (macOS 14) AVF: enable Rosetta caching if supported by the host * (macOS 14) AVF: automatically re-size macOS 14 guests ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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-visionOS.ipa | visionOS version (sideloading) | Custom resigning | ? | No | No | | UTM-SE-visionOS.ipa | visionOS version (sideloading) | Custom resigning | No | No | No | 1. Hypervisor on iOS requires an M1 iPad. 2. Enabling JIT may require a separate JIT enabler such as [Jitterbug][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## Highlights * **macOS Sonoma support** New Apple Virtualization features include save/restore VM state and dynamic resolution for macOS Sonoma guests. Note that currently, you must remove the Sound and Entropy device in order to use save/restore VM state. * **visionOS support** UTM is now working on visionOS but until we get our hands on a real device, it is TBD on how to actually run it. If you are a lucky owner of a development unit, you can try it out yourself with the provided IPAs. * **Automatically save state when you close a VM** This will only work on VMs that support save states. If your VM does not support it, you will get an error message with an explanation. * (macOS) **USB commands in utmctl** You can now use `utmctl usb` commands to connect and disconnect USB devices from a running VM. ## Notes * (macOS) If you are running a virtualized VM on an Intel Mac with TPM enabled and the guest freezes on startup, you will need to temporarily disable Hypervisor (Settings -> QEMU -> Use Hypervisor), boot into Windows, and then re-enable Hypervisor after shutting down. The TPM device changed in v4.4.1 and this causes an issue on existing VMs. * (macOS) When entering full-screen, auto-capture of system keys in AVF (introduced in v4.3.2) and of mouse in QEMU (introduced in v4.4.0) is no longer default. You can enable the option in preferences (Cmd+,) under the Input tab. ## Changes (v4.4.1) * Hide keystroke data from debug logs (#5651) * Scripting: add new `usb devices` element * utmctl: add new `usb` command * Fixed an issue where bookmarks to removable drives and shares were not being saved (#5615) * Fixed an issue where some VMs failed to boot due to suspend support probing (#5624) * Fixed TPM support for x86_64/i386 VMs (#5619) * Fixed an issue where starting a VM fails when a removable floppy disk is used * Fixed an issue where the PTTY address is not shown * Fixed an issue where new lines could be inserted into the VM name through copy and paste (#5627) * Localization: Updated Japanese (thanks @MMP0) * (iOS) Wizard: do not disable the emulation button even if JIT is not enabled * (visionOS) Fixed build issues due to API changes in the latest Xcode * (visionOS) Fixed display of release notes * (macOS) Allow clearing of installer IPSW from settings (#5611) * (macOS) Moved auto-capture of mouse/keyboard in full screen as a preference and do not enable it by default (#5633) * (macOS) AVF: File sizes displayed are now the size occupied on disk to be more consistent with QEMU VMs (#5637) * (macOS) AVF: Fixed macOS installer not working when a shared directory is selected (#5634) * (macOS) AVF: Fixed an issue where shared directory cannot be selected from the home screen (#5617) * (macOS) AVF: Fixed an issue where the cursor could disappear after a VM is stopped (#5607) * (macOS 14) Wizard: Excess separators shown by SwiftUI changes are now hidden * (macOS 12+) Settings sheet should have the bottom toolbar stop before the sidebar in compliance with HIG standards ## Changes (v4.4.0) * Fixed an issue where shared directories and removable drives did not persist when UTM is closed (#5531) * Replaced ANGLE with WebKit ANGLE * Fixed an issue in gstreamer which can crash if an error happens before start * Fixed a race condition that broke BIOS loading (#5523) * Fixed the automatic screenshot timer (#5541) * Fixed UI lockup during a long copy operation when moving/exporting VM * Localization: Updated Polish (thanks @ku1ik) * Localization: Updated French (thanks @alex-kinokon) * Localization: Updated Traditional Chinese (thanks @pan93412) * Localization: Updated Simplified Chinese (thanks @changanmoon) * (iOS) Fixed an issue where quickly double tapping on the play button results in various issues * (iOS) Fixed "Retina" mode resizing so the native display dimensions are passed to the guest * (macOS) utmctl: Fixed an issue where the CLI did not work properly if UTM.app was not located in /Applications (#5526) * (macOS) Fixed window resize not automatically updating the guest dynamic resolution if Accessibility APIs are used (#5577) * (macOS) Automatically capture the mouse (after displaying a confirmation message) when entering full screen (#5514) * (macOS) Automatically save state when closing a VM (#5591) * (macOS) AVF: shared directory is now automatically mounted on macOS 13+ (#5571) * (macOS 14) Fixed IPSW selection * (macOS 14) AVF: implemented save/restore VM state * (macOS 14) AVF: enable Rosetta caching if supported by the host * (macOS 14) AVF: automatically re-size macOS 14 guests ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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-visionOS.ipa | visionOS version (sideloading) | Custom resigning | ? | No | No | | UTM-SE-visionOS.ipa | visionOS version (sideloading) | Custom resigning | No | No | No | 1. Hypervisor on iOS requires an M1 iPad. 2. Enabling JIT may require a separate JIT enabler such as [Jitterbug][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## Highlights * **macOS Sonoma support** New Apple Virtualization features include save/restore VM state and dynamic resolution for macOS Sonoma guests. Note that currently, you must remove the Sound and Entropy device in order to use save/restore VM state. * **visionOS support** UTM is now working on visionOS but until we get our hands on a real device, it is TBD on how to actually run it. If you are a lucky owner of a development unit, you can try it out yourself with the provided IPAs. * **Automatically save state when you close a VM** This will only work on VMs that support save states. If your VM does not support it, you will get an error message with an explanation. ## Changes (v4.4.0) * Fixed an issue where shared directories and removable drives did not persist when UTM is closed (#5531) * Replaced ANGLE with WebKit ANGLE * Fixed an issue in gstreamer which can crash if an error happens before start * Fixed a race condition that broke BIOS loading (#5523) * Fixed the automatic screenshot timer (#5541) * Fixed UI lockup during a long copy operation when moving/exporting VM * Localization: Updated Polish (thanks @ku1ik) * Localization: Updated French (thanks @alex-kinokon) * Localization: Updated Traditional Chinese (thanks @pan93412) * Localization: Updated Simplified Chinese (thanks @changanmoon) * (iOS) Fixed an issue where quickly double tapping on the play button results in various issues * (iOS) Fixed "Retina" mode resizing so the native display dimensions are passed to the guest * (macOS) utmctl: Fixed an issue where the CLI did not work properly if UTM.app was not located in /Applications (#5526) * (macOS) Fixed window resize not automatically updating the guest dynamic resolution if Accessibility APIs are used (#5577) * (macOS) Automatically capture the mouse (after displaying a confirmation message) when entering full screen (#5514) * (macOS) Automatically save state when closing a VM (#5591) * (macOS) AVF: shared directory is now automatically mounted on macOS 13+ (#5571) * (macOS 14) Fixed IPSW selection * (macOS 14) AVF: implemented save/restore VM state * (macOS 14) AVF: enable Rosetta caching if supported by the host * (macOS 14) AVF: automatically re-size macOS 14 guests ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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-visionOS.ipa | visionOS version (sideloading) | Custom resigning | ? | No | No | | UTM-SE-visionOS.ipa | visionOS version (sideloading) | Custom resigning | No | No | No | 1. Hypervisor on iOS requires an M1 iPad. 2. Enabling JIT may require a separate JIT enabler such as [Jitterbug][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## Highlights * **Rewrite of QEMU support internals.** Much of the code to support QEMU has been refactored into a new project, [QEMUKit](https://github.com/utmapp/QEMUKit), which will make it easier to support QEMU changes as well as support for new platforms. * **TPM 2.0 and Secure Boot** This is required for Windows 11 updates to 22H2. To enable TPM on an existing virtual machine (only x86_64, i386, and ARM64 architectures are supported), open the VM settings, go to the QEMU page and select "UEFI Boot", "TPM 2.0 Device", and "Reset UEFI Variables." Any new VM created through the wizard will have TPM 2.0 and Secure Boot enabled by default if Windows 10+ support is checked. * **Download Windows installer with a new utility.** We know that creating a Windows installer can be a hassle which is why we are releasing a new free tool called CrystalFetch which can be found on [GitHub](https://github.com/TuringSoftware/CrystalFetch) as well as free on the [Mac App Store](https://apps.apple.com/app/crystalfetch-iso-downloader/id6454431289). This companion to UTM will allow you to generate a Windows 11 ISO with a few clicks (no Terminal, Homebrew, or scripts required). Note that just like before, you still need a valid license from Microsoft to use Windows. ## Notes * On i386 and x86_64 machines, HPET is now disabled by default. This improves performance (slightly) on some guests and also addresses boot issues with OpenIndiana. This change means that suspended VM state from previous versions are not compatible, so please shut down those VMs before updating. If you require HPET to be enabled for any reason, go into the VM's settings and under QEMU → QEMU Machine Properties, add the text `hpet=on`. * In v4.3.5, we rolled back backend updates to QEMU and EDK2 due to a critical issue that prevented VMs from booting. While the issue is investigated, the last stable version will be used and once the issue is resolved, a new update will be released. * If you suspended an Apple Virtualization VM in v4.4 and then downgrade to v4.3, you will not be able to resume the VM or start it at all. Please make sure you shut down any such VMs before downgrading or you may suffer data loss. ## Changes (v4.3.5) * Rollback QEMU version to 7.2.0 * Rollback EDK2 firmware to edk2-stable202102 * Reduced amount of logging when Debug Log is not checked * (macOS) Wizard: Fixed boot ISO not saving for AVF (#5517) ## Changes (v4.3.4) * Localization: Updated Japanese (thanks @MMP0) * Fixed WebDAV shared directory not setup on start (#5506) * (macOS) Improved debug logging by showing more verbose logging for SPICE. If "Enable Debug Log" is selected, more verbose logging will be activated. * (macOS) Fixed an issue where the VM freezes or shows "port not connected" when the computer is under memory pressure (#5489) * (macOS 11) Disabled options in the context menu which had broken UI leading to freezes or crashes (#5147) * (macOS 12) Wizard: Fixed a crash when selecting a file with VoiceOver (#5250) * (macOS 12+) Settings: new table view for QEMU custom arguments ## Changes (v4.3.3) * Fixed a crash when selecting a VM (#5481) * Fixed a crash when starting a VM and an error occurred when creating display/serial devices (#5472) * Fixed boot issues when trying to load OpenIndiana by disabling HPET timers by default (#2394) * Fixed an issue where selected removable drive image and shared directory are not syncing correctly * QEMUKit: Fixed race condition when multiple RPC commands are sent (#5477) * EDK2: Fixed an issue preventing some versions of Windows 11 from booting (#5495) * utmctl: Add a more verbose error message when utmctl fails because it is launched from an SSH session or before logging in (#5499) * Wizard: Fixed selected boot ISO not saving (#5471) * Wizard: Link to CrystalFetch when Windows is selected * (macOS) AVF: Automatically un-capture system keys when VM terminates ## Changes (v4.3.2) * The last update introduced two units per bus for IDE devices. However, some machines do not support this configuration, so now two units per bus will only be enabled for supported machines. Other machines will retain pre v4.3.1 behaviour. * Fixed some state tracking issues leading to various errors when a VM is quickly stopped and started again. * Changed the style of the icons on various VM operations in the home screen and context menu (iOS) (thanks @jnsdrtlf) (#5441, #4759) * Fixed an issue where serial device hardware was not saved * Fixed the error that shows up when trying to rename a VM (#5444) * Fixed a crash on startup due to mishandling of VM parsing (#5424) * Fixed debug logging not working due to backend changes in v4.3.1 * Fixed a crash when QEMU tries to output non-printable characters * Add support for SWTPM for TPM 2.0 emulation * Add Secure Boot firmware for ARM64. Only the Secure Boot firmwares have TPM 2.0 support built in, so when TPM 2.0 and UEFI are enabled, UTM will automatically select the Secure Boot firmware. By default the UTM platform keys and Microsoft key exchange keys are enrolled. You can manually set up your own keys from the UEFI menu. * Updated the EDK2 UEFI firmware to the 202305 release * Debug logs will no longer be deleted when a VM configuration is saved and debug log is not disabled * Fixed an issue where the mouse cursor stopped working due to backend changes in v4.3.1 * If the Documents directory does not exist in UTM's container, it will now be created automatically. This addresses an error that shows up if the Documents directory does not get created properly by macOS. (#5419) * Localization: Updated Japanese (thanks @MMP0) * (iOS) Fixed an issue where TSO setting was not saved * (macOS) Fixed an issue where every time a VM is started with a terminal window, the width of the window gets a bit larger * (macOS) Fixed an issue where starting a stopped VM does not change the display scale * (macOS) AVM: System keys will be captured automatically when entering full screen and released when exiting full screen (#3668) * (macOS) AVM: Fixed the request stop method in both the GUI and scripting interfaces (#5425) ## Changes (v4.3.1) * Updated QEMU backend to v8.0.2 * Refactored QEMU support to a new project: [QEMUKit](https://github.com/utmapp/QEMUKit) * Machines with IDE interface (i44FX/PIIX) will now support two units per bus. Previously, we mapped IDE devices to one unit per bus. This means on some machines, the limit was two devices maximum. Now, we map two units per IDE bus which should increase the limit to four devices. Existing VMs will _not_ get this change automatically in order to maintain compatibility. You can choose to opt-in to this new mapping by pressing the “Update Interface” button on each IDE drive in the VM settings. (#5358) * Localization: Updated Japanese (thanks @MMP0 and @studio1a9) * (macOS) Fixed crash when AVM window is closed (#5347) * (macOS) New option “Automatic” for bridged network connection which will use the bridge the first active connection on the host. Both AVM and QEMU backends are supported. (#5410) * (macOS) Fixed trackpad setting not saving (#5369) ## Changes (v4.3.0) * Updated QEMU backend to v8.0.0 * Changed audio backend from CoreAudio back to SPICE (as it was before v4.2.x). Clarify that CoreAudio backend does not support microphone (#5253) * Add support for mouse buttons 4 and 5 (#5295) * Wizard: Properly display an error message when there is a failure writing to disk (#5271) * Fixed an issue where ISAPC emulation target cannot be started (#5280) * Fixed CoreAudio being instantiated even when audio is disabled * Fixed an issue where legacy VMs with AC97 sound card has an empty name in settings * Fixed an QEMU issue where the `ucomiss` instruction causes a crash in some applications (#5294) * Fixed an issue preventing VMs with commas in their name from starting (note only new VMs will be fixed) (#5332) * (macOS) AVM: Support canceling macOS installation * (macOS) utmctl: Added `delete` command (#5290) * (macOS) Fixed an issue creating a shortcut from drag & drop as well as double clicking from Finder (#5310, #5311) * (macOS) Added DHCP start/end settings for vmnet (#5301) * (macOS) Added automatically syncing of system clock when macOS wakes up from sleep (when QEMU guest agent is installed) (#5252) ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

This version is broken due to a bug which prevents VMs from starting. Please update UTM to the latest version. If you obtained UTM from the Mac App Store, you may need to open the [App Store](itms-apps://apps.apple.com/updates) to the Updates tab to see it. ## Highlights (Original) * **QEMU backend updated to v8.0.2** * **Rewrite of QEMU support internals.** Much of the code to support QEMU has been refactored into a new project, [QEMUKit](https://github.com/utmapp/QEMUKit), which will make it easier to support QEMU changes as well as support for new platforms. * **TPM 2.0 and Secure Boot** This is required for Windows 11 updates to 22H2. To enable TPM on an existing virtual machine (only x86_64, i386, and ARM64 architectures are supported), open the VM settings, go to the QEMU page and select "UEFI Boot", "TPM 2.0 Device", and "Reset UEFI Variables." Any new VM created through the wizard will have TPM 2.0 and Secure Boot enabled by default if Windows 10+ support is checked. * **Download Windows installer with a new utility.** We know that creating a Windows installer can be a hassle which is why we are releasing a new free tool called CrystalFetch which can be found on [GitHub](https://github.com/TuringSoftware/CrystalFetch) as well as free on the [Mac App Store](https://apps.apple.com/app/crystalfetch-iso-downloader/id6454431289). This companion to UTM will allow you to generate a Windows 11 ISO with a few clicks (no Terminal, Homebrew, or scripts required). Note that just like before, you still need a valid license from Microsoft to use Windows. ## Notes On i386 and x86_64 machines, HPET is now disabled by default. This improves performance (slightly) on some guests and also addresses boot issues with OpenIndiana. This change means that suspended VM state from previous versions are not compatible, so please shut down those VMs before updating. If you require HPET to be enabled for any reason, go into the VM's settings and under QEMU → QEMU Machine Properties, add the text `hpet=on`. ## Changes (v4.3.4) * Localization: Updated Japanese (thanks @MMP0) * Fixed WebDAV shared directory not setup on start (#5506) * (macOS) Improved debug logging by showing more verbose logging for SPICE. If "Enable Debug Log" is selected, more verbose logging will be activated. * (macOS) Fixed an issue where the VM freezes or shows "port not connected" when the computer is under memory pressure (#5489) * (macOS 11) Disabled options in the context menu which had broken UI leading to freezes or crashes (#5147) * (macOS 12) Wizard: Fixed a crash when selecting a file with VoiceOver (#5250) * (macOS 12+) Settings: new table view for QEMU custom arguments ## Changes (v4.3.3) * Fixed a crash when selecting a VM (#5481) * Fixed a crash when starting a VM and an error occurred when creating display/serial devices (#5472) * Fixed boot issues when trying to load OpenIndiana by disabling HPET timers by default (#2394) * Fixed an issue where selected removable drive image and shared directory are not syncing correctly * QEMUKit: Fixed race condition when multiple RPC commands are sent (#5477) * EDK2: Fixed an issue preventing some versions of Windows 11 from booting (#5495) * utmctl: Add a more verbose error message when utmctl fails because it is launched from an SSH session or before logging in (#5499) * Wizard: Fixed selected boot ISO not saving (#5471) * Wizard: Link to CrystalFetch when Windows is selected * (macOS) AVF: Automatically un-capture system keys when VM terminates ## Changes (v4.3.2) * The last update introduced two units per bus for IDE devices. However, some machines do not support this configuration, so now two units per bus will only be enabled for supported machines. Other machines will retain pre v4.3.1 behaviour. * Fixed some state tracking issues leading to various errors when a VM is quickly stopped and started again. * Changed the style of the icons on various VM operations in the home screen and context menu (iOS) (thanks @jnsdrtlf) (#5441, #4759) * Fixed an issue where serial device hardware was not saved * Fixed the error that shows up when trying to rename a VM (#5444) * Fixed a crash on startup due to mishandling of VM parsing (#5424) * Fixed debug logging not working due to backend changes in v4.3.1 * Fixed a crash when QEMU tries to output non-printable characters * Add support for SWTPM for TPM 2.0 emulation * Add Secure Boot firmware for ARM64. Only the Secure Boot firmwares have TPM 2.0 support built in, so when TPM 2.0 and UEFI are enabled, UTM will automatically select the Secure Boot firmware. By default the UTM platform keys and Microsoft key exchange keys are enrolled. You can manually set up your own keys from the UEFI menu. * Updated the EDK2 UEFI firmware to the 202305 release * Debug logs will no longer be deleted when a VM configuration is saved and debug log is not disabled * Fixed an issue where the mouse cursor stopped working due to backend changes in v4.3.1 * If the Documents directory does not exist in UTM's container, it will now be created automatically. This addresses an error that shows up if the Documents directory does not get created properly by macOS. (#5419) * Localization: Updated Japanese (thanks @MMP0) * (iOS) Fixed an issue where TSO setting was not saved * (macOS) Fixed an issue where every time a VM is started with a terminal window, the width of the window gets a bit larger * (macOS) Fixed an issue where starting a stopped VM does not change the display scale * (macOS) AVM: System keys will be captured automatically when entering full screen and released when exiting full screen (#3668) * (macOS) AVM: Fixed the request stop method in both the GUI and scripting interfaces (#5425) ## Changes (v4.3.1) * Updated QEMU backend to v8.0.2 * Refactored QEMU support to a new project: [QEMUKit](https://github.com/utmapp/QEMUKit) * Machines with IDE interface (i44FX/PIIX) will now support two units per bus. Previously, we mapped IDE devices to one unit per bus. This means on some machines, the limit was two devices maximum. Now, we map two units per IDE bus which should increase the limit to four devices. Existing VMs will _not_ get this change automatically in order to maintain compatibility. You can choose to opt-in to this new mapping by pressing the “Update Interface” button on each IDE drive in the VM settings. (#5358) * Localization: Updated Japanese (thanks @MMP0 and @studio1a9) * (macOS) Fixed crash when AVM window is closed (#5347) * (macOS) New option “Automatic” for bridged network connection which will use the bridge the first active connection on the host. Both AVM and QEMU backends are supported. (#5410) * (macOS) Fixed trackpad setting not saving (#5369) ## Changes (v4.3.0) * Updated QEMU backend to v8.0.0 * Changed audio backend from CoreAudio back to SPICE (as it was before v4.2.x). Clarify that CoreAudio backend does not support microphone (#5253) * Add support for mouse buttons 4 and 5 (#5295) * Wizard: Properly display an error message when there is a failure writing to disk (#5271) * Fixed an issue where ISAPC emulation target cannot be started (#5280) * Fixed CoreAudio being instantiated even when audio is disabled * Fixed an issue where legacy VMs with AC97 sound card has an empty name in settings * Fixed an QEMU issue where the `ucomiss` instruction causes a crash in some applications (#5294) * Fixed an issue preventing VMs with commas in their name from starting (note only new VMs will be fixed) (#5332) * (macOS) AVM: Support canceling macOS installation * (macOS) utmctl: Added `delete` command (#5290) * (macOS) Fixed an issue creating a shortcut from drag & drop as well as double clicking from Finder (#5310, #5311) * (macOS) Added DHCP start/end settings for vmnet (#5301) * (macOS) Added automatically syncing of system clock when macOS wakes up from sleep (when QEMU guest agent is installed) (#5252) ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## Highlights * **QEMU backend updated to v8.0.2** * **Rewrite of QEMU support internals.** Much of the code to support QEMU has been refactored into a new project, [QEMUKit](https://github.com/utmapp/QEMUKit), which will make it easier to support QEMU changes as well as support for new platforms. This means that v4.3.1 may contain a lot of UI bugs as testing is needed to make sure the new internals match up with the existing UI. Please help us by reporting any such issue you stumble upon. * **TPM 2.0 and Secure Boot** This is required for Windows 11 updates to 22H2. To enable TPM on an existing virtual machine (only x86_64, i386, and ARM64 architectures are supported), open the VM settings, go to the QEMU page and select "UEFI Boot", "TPM 2.0 Device", and "Reset UEFI Variables." Any new VM created through the wizard will have TPM 2.0 and Secure Boot enabled by default if Windows 10+ support is checked. * **Download Windows installer with a new utility.** We know that creating a Windows installer can be a hassle which is why we are releasing a new free tool called CrystalFetch which can be found on [GitHub](https://github.com/TuringSoftware/CrystalFetch) as well as free on the [Mac App Store](https://apps.apple.com/app/crystalfetch-iso-downloader/id6454431289). This companion to UTM will allow you to generate a Windows 11 ISO with a few clicks (no Terminal, Homebrew, or scripts required). Note that just like before, you still need a valid license from Microsoft to use Windows. ## Notes On i386 and x86_64 machines, HPET is now disabled by default. This improves performance (slightly) on some guests and also addresses boot issues with OpenIndiana. This change means that suspended VM state from previous versions are not compatible, so please shut down those VMs before updating. If you require HPET to be enabled for any reason, go into the VM's settings and under QEMU → QEMU Machine Properties, add the text `hpet=on`. ## Changes (v4.3.3) * Fixed a crash when selecting a VM (#5481) * Fixed a crash when starting a VM and an error occurred when creating display/serial devices (#5472) * Fixed boot issues when trying to load OpenIndiana by disabling HPET timers by default (#2394) * Fixed an issue where selected removable drive image and shared directory are not syncing correctly * QEMUKit: Fixed race condition when multiple RPC commands are sent (#5477) * EDK2: Fixed an issue preventing some versions of Windows 11 from booting (#5495) * utmctl: Add a more verbose error message when utmctl fails because it is launched from an SSH session or before logging in (#5499) * Wizard: Fixed selected boot ISO not saving (#5471) * Wizard: Link to CrystalFetch when Windows is selected * (macOS) AVF: Automatically un-capture system keys when VM terminates ## Changes (v4.3.2) * The last update introduced two units per bus for IDE devices. However, some machines do not support this configuration, so now two units per bus will only be enabled for supported machines. Other machines will retain pre v4.3.1 behaviour. * Fixed some state tracking issues leading to various errors when a VM is quickly stopped and started again. * Changed the style of the icons on various VM operations in the home screen and context menu (iOS) (thanks @jnsdrtlf) (#5441, #4759) * Fixed an issue where serial device hardware was not saved * Fixed the error that shows up when trying to rename a VM (#5444) * Fixed a crash on startup due to mishandling of VM parsing (#5424) * Fixed debug logging not working due to backend changes in v4.3.1 * Fixed a crash when QEMU tries to output non-printable characters * Add support for SWTPM for TPM 2.0 emulation * Add Secure Boot firmware for ARM64. Only the Secure Boot firmwares have TPM 2.0 support built in, so when TPM 2.0 and UEFI are enabled, UTM will automatically select the Secure Boot firmware. By default the UTM platform keys and Microsoft key exchange keys are enrolled. You can manually set up your own keys from the UEFI menu. * Updated the EDK2 UEFI firmware to the 202305 release * Debug logs will no longer be deleted when a VM configuration is saved and debug log is not disabled * Fixed an issue where the mouse cursor stopped working due to backend changes in v4.3.1 * If the Documents directory does not exist in UTM's container, it will now be created automatically. This addresses an error that shows up if the Documents directory does not get created properly by macOS. (#5419) * Localization: Updated Japanese (thanks @MMP0) * (iOS) Fixed an issue where TSO setting was not saved * (macOS) Fixed an issue where every time a VM is started with a terminal window, the width of the window gets a bit larger * (macOS) Fixed an issue where starting a stopped VM does not change the display scale * (macOS) AVM: System keys will be captured automatically when entering full screen and released when exiting full screen (#3668) * (macOS) AVM: Fixed the request stop method in both the GUI and scripting interfaces (#5425) ## Changes (v4.3.1) * Updated QEMU backend to v8.0.2 * Refactored QEMU support to a new project: [QEMUKit](https://github.com/utmapp/QEMUKit) * Machines with IDE interface (i44FX/PIIX) will now support two units per bus. Previously, we mapped IDE devices to one unit per bus. This means on some machines, the limit was two devices maximum. Now, we map two units per IDE bus which should increase the limit to four devices. Existing VMs will _not_ get this change automatically in order to maintain compatibility. You can choose to opt-in to this new mapping by pressing the “Update Interface” button on each IDE drive in the VM settings. (#5358) * Localization: Updated Japanese (thanks @MMP0 and @studio1a9) * (macOS) Fixed crash when AVM window is closed (#5347) * (macOS) New option “Automatic” for bridged network connection which will use the bridge the first active connection on the host. Both AVM and QEMU backends are supported. (#5410) * (macOS) Fixed trackpad setting not saving (#5369) ## Changes (v4.3.0) * Updated QEMU backend to v8.0.0 * Changed audio backend from CoreAudio back to SPICE (as it was before v4.2.x). Clarify that CoreAudio backend does not support microphone (#5253) * Add support for mouse buttons 4 and 5 (#5295) * Wizard: Properly display an error message when there is a failure writing to disk (#5271) * Fixed an issue where ISAPC emulation target cannot be started (#5280) * Fixed CoreAudio being instantiated even when audio is disabled * Fixed an issue where legacy VMs with AC97 sound card has an empty name in settings * Fixed an QEMU issue where the `ucomiss` instruction causes a crash in some applications (#5294) * Fixed an issue preventing VMs with commas in their name from starting (note only new VMs will be fixed) (#5332) * (macOS) AVM: Support canceling macOS installation * (macOS) utmctl: Added `delete` command (#5290) * (macOS) Fixed an issue creating a shortcut from drag & drop as well as double clicking from Finder (#5310, #5311) * (macOS) Added DHCP start/end settings for vmnet (#5301) * (macOS) Added automatically syncing of system clock when macOS wakes up from sleep (when QEMU guest agent is installed) (#5252) ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## Highlights * **QEMU backend updated to v8.0.2** * **Rewrite of QEMU support internals.** Much of the code to support QEMU has been refactored into a new project, [QEMUKit](https://github.com/utmapp/QEMUKit), which will make it easier to support QEMU changes as well as support for new platforms. This means that v4.3.1 may contain a lot of UI bugs as testing is needed to make sure the new internals match up with the existing UI. Please help us by reporting any such issue you stumble upon. * **TPM 2.0 and Secure Boot** This is required for Windows 11 updates to 22H2. To enable TPM on an existing virtual machine (only x86_64, i386, and ARM64 architectures are supported), open the VM settings, go to the QEMU page and select "UEFI Boot", "TPM 2.0 Device", and "Reset UEFI Variables." Any new VM created through the wizard will have TPM 2.0 and Secure Boot enabled by default if Windows 10+ support is checked. ## Changes (v4.3.2) * The last update introduced two units per bus for IDE devices. However, some machines do not support this configuration, so now two units per bus will only be enabled for supported machines. Other machines will retain pre v4.3.1 behaviour. * Fixed some state tracking issues leading to various errors when a VM is quickly stopped and started again. * Changed the style of the icons on various VM operations in the home screen and context menu (iOS) (thanks @jnsdrtlf) (#5441, #4759) * Fixed an issue where serial device hardware was not saved * Fixed the error that shows up when trying to rename a VM (#5444) * Fixed a crash on startup due to mishandling of VM parsing (#5424) * Fixed debug logging not working due to backend changes in v4.3.1 * Fixed a crash when QEMU tries to output non-printable characters * Add support for SWTPM for TPM 2.0 emulation * Add Secure Boot firmware for ARM64. Only the Secure Boot firmwares have TPM 2.0 support built in, so when TPM 2.0 and UEFI are enabled, UTM will automatically select the Secure Boot firmware. By default the UTM platform keys and Microsoft key exchange keys are enrolled. You can manually set up your own keys from the UEFI menu. * Updated the EDK2 UEFI firmware to the 202305 release * Debug logs will no longer be deleted when a VM configuration is saved and debug log is not disabled * Fixed an issue where the mouse cursor stopped working due to backend changes in v4.3.1 * If the Documents directory does not exist in UTM's container, it will now be created automatically. This addresses an error that shows up if the Documents directory does not get created properly by macOS. (#5419) * Localization: Updated Japanese (thanks @MMP0) * (iOS) Fixed an issue where TSO setting was not saved * (macOS) Fixed an issue where every time a VM is started with a terminal window, the width of the window gets a bit larger * (macOS) Fixed an issue where starting a stopped VM does not change the display scale * (macOS) AVM: System keys will be captured automatically when entering full screen and released when exiting full screen (#3668) * (macOS) AVM: Fixed the request stop method in both the GUI and scripting interfaces (#5425) ## Changes (v4.3.1) * Updated QEMU backend to v8.0.2 * Refactored QEMU support to a new project: [QEMUKit](https://github.com/utmapp/QEMUKit) * Machines with IDE interface (i44FX/PIIX) will now support two units per bus. Previously, we mapped IDE devices to one unit per bus. This means on some machines, the limit was two devices maximum. Now, we map two units per IDE bus which should increase the limit to four devices. Existing VMs will _not_ get this change automatically in order to maintain compatibility. You can choose to opt-in to this new mapping by pressing the “Update Interface” button on each IDE drive in the VM settings. (#5358) * Localization: Updated Japanese (thanks @MMP0 and @studio1a9) * (macOS) Fixed crash when AVM window is closed (#5347) * (macOS) New option “Automatic” for bridged network connection which will use the bridge the first active connection on the host. Both AVM and QEMU backends are supported. (#5410) * (macOS) Fixed trackpad setting not saving (#5369) ## Changes (v4.3.0) * Updated QEMU backend to v8.0.0 * Changed audio backend from CoreAudio back to SPICE (as it was before v4.2.x). Clarify that CoreAudio backend does not support microphone (#5253) * Add support for mouse buttons 4 and 5 (#5295) * Wizard: Properly display an error message when there is a failure writing to disk (#5271) * Fixed an issue where ISAPC emulation target cannot be started (#5280) * Fixed CoreAudio being instantiated even when audio is disabled * Fixed an issue where legacy VMs with AC97 sound card has an empty name in settings * Fixed an QEMU issue where the `ucomiss` instruction causes a crash in some applications (#5294) * Fixed an issue preventing VMs with commas in their name from starting (note only new VMs will be fixed) (#5332) * (macOS) AVM: Support canceling macOS installation * (macOS) utmctl: Added `delete` command (#5290) * (macOS) Fixed an issue creating a shortcut from drag & drop as well as double clicking from Finder (#5310, #5311) * (macOS) Added DHCP start/end settings for vmnet (#5301) * (macOS) Added automatically syncing of system clock when macOS wakes up from sleep (when QEMU guest agent is installed) (#5252) ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## Highlights * **QEMU backend updated to v8.0.2** * **Rewrite of QEMU support internals.** Much of the code to support QEMU has been refactored into a new project, [QEMUKit](https://github.com/utmapp/QEMUKit), which will make it easier to support QEMU changes as well as support for new platforms. This means that v4.3.1 may contain a lot of UI bugs as testing is needed to make sure the new internals match up with the existing UI. Please help us by reporting any such issue you stumble upon. ## Changes (v4.3.1) * Updated QEMU backend to v8.0.2 * Refactored QEMU support to a new project: [QEMUKit](https://github.com/utmapp/QEMUKit) * Machines with IDE interface (i44FX/PIIX) will now support two units per bus. Previously, we mapped IDE devices to one unit per bus. This means on some machines, the limit was two devices maximum. Now, we map two units per IDE bus which should increase the limit to four devices. Existing VMs will _not_ get this change automatically in order to maintain compatibility. You can choose to opt-in to this new mapping by pressing the “Update Interface” button on each IDE drive in the VM settings. (#5358) * Localization: Updated Japanese (thanks @MMP0 and @studio1a9) * (macOS) Fixed crash when AVM window is closed (#5347) * (macOS) New option “Automatic” for bridged network connection which will use the bridge the first active connection on the host. Both AVM and QEMU backends are supported. (#5410) * (macOS) Fixed trackpad setting not saving (#5369) ## Changes (v4.3.0) * Updated QEMU backend to v8.0.0 * Changed audio backend from CoreAudio back to SPICE (as it was before v4.2.x). Clarify that CoreAudio backend does not support microphone (#5253) * Add support for mouse buttons 4 and 5 (#5295) * Wizard: Properly display an error message when there is a failure writing to disk (#5271) * Fixed an issue where ISAPC emulation target cannot be started (#5280) * Fixed CoreAudio being instantiated even when audio is disabled * Fixed an issue where legacy VMs with AC97 sound card has an empty name in settings * Fixed an QEMU issue where the `ucomiss` instruction causes a crash in some applications (#5294) * Fixed an issue preventing VMs with commas in their name from starting (note only new VMs will be fixed) (#5332) * (macOS) AVM: Support canceling macOS installation * (macOS) utmctl: Added `delete` command (#5290) * (macOS) Fixed an issue creating a shortcut from drag & drop as well as double clicking from Finder (#5310, #5311) * (macOS) Added DHCP start/end settings for vmnet (#5301) * (macOS) Added automatically syncing of system clock when macOS wakes up from sleep (when QEMU guest agent is installed) (#5252) ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## Highlights * **QEMU backend updated to v8.0.0.** ## Changes (v4.3.0) * Updated QEMU backend to v8.0.0 * Changed audio backend from CoreAudio back to SPICE (as it was before v4.2.x). Clarify that CoreAudio backend does not support microphone (#5253) * Add support for mouse buttons 4 and 5 (#5295) * Wizard: Properly display an error message when there is a failure writing to disk (#5271) * Fixed an issue where ISAPC emulation target cannot be started (#5280) * Fixed CoreAudio being instantiated even when audio is disabled * Fixed an issue where legacy VMs with AC97 sound card has an empty name in settings * Fixed an QEMU issue where the `ucomiss` instruction causes a crash in some applications (#5294) * Fixed an issue preventing VMs with commas in their name from starting (note only new VMs will be fixed) (#5332) * (macOS) AVM: Support canceling macOS installation * (macOS) utmctl: Added `delete` command (#5290) * (macOS) Fixed an issue creating a shortcut from drag & drop as well as double clicking from Finder (#5310, #5311) * (macOS) Added DHCP start/end settings for vmnet (#5301) * (macOS) Added automatically syncing of system clock when macOS wakes up from sleep (when QEMU guest agent is installed) (#5252) ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## 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](https://docs.getutm.app/scripting/reference/) for more details and [the cheat sheet](https://docs.getutm.app/scripting/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). ## Changes (v4.2.5) * Reverted ANGLE to an older version which includes the fix detailed in v4.2.4 but also does not break the Metal backend (#5238) * Translation: updated Polish (thanks @matgaj, @mavethee) * (macOS) Fixed an issue where the pointer device stopped working on macOS Monterey guests (#5237) * (macOS) AVM: Added option to use emulated trackpad (requires macOS Ventura guest) ## Changes (v4.2.4) * UTM will now display the release notes the first time a new version is launched * Updated ANGLE which should fix some GPU acceleration issues on Linux (please see known issues below for unresolved issues) * Fixed an issue where a removable drive or VirtIO shared directory was set up when QEMUHelper was already running and therefore was not able to create a bookmark and an "access denied" error shows up on startup * Introduced a new preference setting for using the Option key as Meta in the built in console. This was on by default in previous versions and is not off by default which should allow international text to be entered properly (#5202) * Wizard: Make virtio-gpu-pci default for Linux (again) which was reverted a few releases ago in order to address some GPU issues * Translation: updated Polish (thanks @matgaj) * (iOS) Fixed built in terminal overlapping in the safe area ## 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. (#5079) * Removable USB devices will no longer show up as a CD drive if the image type is set to "Disk" (#5171) * Reverted a change from v4.2.0 where virtio bus devices were removed (this broke some people's configurations) (#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 (#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) (#5170) * (macOS) Fixed an issue where incorrect subnet parameters are generated for vmnet advanced settings (#5128) * (macOS) CLI: Added a new `clone` command (#5004) ## Changes (v4.2.2) * Fixed an issue where a VM that is moved manually (e.g. with Finder) cannot be started (#5121) * Fixed an issue where the cursor disappears after resuming a suspended VM (#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) (#5125) ## Changes (v4.2.1) * QEMU: Support more than 8 cores for ARM64 targets (#4847) * Synchronize time on resume when QEMU guest agent is installed which should fix clock drift issues (#3218) * (iOS SE) Updated TCTI to latest branch from @ktemkin which has support for vector instructions (#4865) * (macOS) Switch to emulated trackpad when guest+host are macOS 13+ (second attempt for #4636 and #4645) * (macOS) Fixed the "raw image" checkbox when creating a new drive (#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 (#4910) * ~~Remove virtio-bus devices (they didn't work) (#4893)~~ * Support drag and drop to import an .utm package (#3599) * Support copying sparse images across different volumes (thanks @ktprograms) * Fixed tearing/performance issue for non-GL accelerated displays when under graphics load (#5049) * Fixed error when importing a new drive with the same name as an existing drive (#5052) * ~~Fixed a crash on startup when multiple audio devices are plugged in (#4629)~~ * Wizard: Generate a working configuration for isapc (#4961) * Settings: Use pretty labels for CPU flags (#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. (#4667) * (macOS) Ignore missing links (drives, shared directory, etc) when saving an Apple VM * (macOS) Preference: added option to force Num Lock on (#4625) * (macOS) Preference: added option to prevent idle sleep while VM is running (#4963) * (macOS) Preference: added option to suppress exit confirmation (#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 (#5025) * (macOS) Fixed an issue where a moved or deleted VM with a stopped window open will attempt to use the old path (#4985) * (macOS) Fixed cursor scrolling and double click issues (#4636, #4645) * (macOS) Support following a change in system default input or output audio 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 (#4938) ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. * There is a known bug in newer versions of Mesa which prevents some Wayland applications (such as Firefox) from launching when GPU acceleration is enabled. One workaround is to switch to Xorg from the log-in screen (typically by clicking on the gear icon) and another is to patch Mesa to a newer version. * Debian 12 fails to load the GUI installer when GPU acceleration is enabled. Please use the text installer instead. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## 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](https://docs.getutm.app/scripting/reference/) for more details and [the cheat sheet](https://docs.getutm.app/scripting/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). ## Changes (v4.2.4) * UTM will now display the release notes the first time a new version is launched * Updated ANGLE which should fix some GPU acceleration issues on Linux (please see known issues below for unresolved issues) * Fixed an issue where a removable drive or VirtIO shared directory was set up when QEMUHelper was already running and therefore was not able to create a bookmark and an "access denied" error shows up on startup * Introduced a new preference setting for using the Option key as Meta in the built in console. This was on by default in previous versions and is not off by default which should allow international text to be entered properly (#5202) * Wizard: Make virtio-gpu-pci default for Linux (again) which was reverted a few releases ago in order to address some GPU issues * Translation: updated Polish (thanks @matgaj) * (iOS) Fixed built in terminal overlapping in the safe area ## 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. (#5079) * Removable USB devices will no longer show up as a CD drive if the image type is set to "Disk" (#5171) * Reverted a change from v4.2.0 where virtio bus devices were removed (this broke some people's configurations) (#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 (#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) (#5170) * (macOS) Fixed an issue where incorrect subnet parameters are generated for vmnet advanced settings (#5128) * (macOS) CLI: Added a new `clone` command (#5004) ## Changes (v4.2.2) * Fixed an issue where a VM that is moved manually (e.g. with Finder) cannot be started (#5121) * Fixed an issue where the cursor disappears after resuming a suspended VM (#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) (#5125) ## Changes (v4.2.1) * QEMU: Support more than 8 cores for ARM64 targets (#4847) * Synchronize time on resume when QEMU guest agent is installed which should fix clock drift issues (#3218) * (iOS SE) Updated TCTI to latest branch from @ktemkin which has support for vector instructions (#4865) * (macOS) Switch to emulated trackpad when guest+host are macOS 13+ (second attempt for #4636 and #4645) * (macOS) Fixed the "raw image" checkbox when creating a new drive (#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 (#4910) * ~~Remove virtio-bus devices (they didn't work) (#4893)~~ * Support drag and drop to import an .utm package (#3599) * Support copying sparse images across different volumes (thanks @ktprograms) * Fixed tearing/performance issue for non-GL accelerated displays when under graphics load (#5049) * Fixed error when importing a new drive with the same name as an existing drive (#5052) * ~~Fixed a crash on startup when multiple audio devices are plugged in (#4629)~~ * Wizard: Generate a working configuration for isapc (#4961) * Settings: Use pretty labels for CPU flags (#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. (#4667) * (macOS) Ignore missing links (drives, shared directory, etc) when saving an Apple VM * (macOS) Preference: added option to force Num Lock on (#4625) * (macOS) Preference: added option to prevent idle sleep while VM is running (#4963) * (macOS) Preference: added option to suppress exit confirmation (#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 (#5025) * (macOS) Fixed an issue where a moved or deleted VM with a stopped window open will attempt to use the old path (#4985) * (macOS) Fixed cursor scrolling and double click issues (#4636, #4645) * (macOS) Support following a change in system default input or output audio 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 (#4938) ## Issues Please check the full list on [Github](https://github.com/utmapp/UTM/issues) and help report any bug you find that is not listed. * There is a known bug in newer versions of Mesa which prevents some Wayland applications (such as Firefox) from launching when GPU acceleration is enabled. One workaround is to switch to Xorg from the log-in screen (typically by clicking on the gear icon) and another is to patch Mesa to a newer version. * Debian 12 fails to load the GUI installer when GPU acceleration is enabled. Please use the text installer instead. * The Metal renderer backend is broken on macOS, please change your renderer to OpenGL or "Default" ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][2] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/osy/Jitterbug

## 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](https://docs.getutm.app/scripting/reference/) for more details and [the cheat sheet](https://docs.getutm.app/scripting/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. (#5079) * Removable USB devices will no longer show up as a CD drive if the image type is set to "Disk" (#5171) * Reverted a change from v4.2.0 where virtio bus devices were removed (this broke some people's configurations) (#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 (#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) (#5170) * (macOS) Fixed an issue where incorrect subnet parameters are generated for vmnet advanced settings (#5128) * (macOS) CLI: Added a new `clone` command (#5004) ## Changes (v4.2.2) * Fixed an issue where a VM that is moved manually (e.g. with Finder) cannot be started (#5121) * Fixed an issue where the cursor disappears after resuming a suspended VM (#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) (#5125) ## Changes (v4.2.1) * QEMU: Support more than 8 cores for ARM64 targets (#4847) * Synchronize time on resume when QEMU guest agent is installed which should fix clock drift issues (#3218) * (iOS SE) Updated TCTI to latest branch from @ktemkin which has support for vector instructions (#4865) * (macOS) Switch to emulated trackpad when guest+host are macOS 13+ (second attempt for #4636 and #4645) * (macOS) Fixed the "raw image" checkbox when creating a new drive (#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 (#4910) * ~~Remove virtio-bus devices (they didn't work) (#4893)~~ * Support drag and drop to import an .utm package (#3599) * Support copying sparse images across different volumes (thanks @ktprograms) * Fixed tearing/performance issue for non-GL accelerated displays when under graphics load (#5049) * Fixed error when importing a new drive with the same name as an existing drive (#5052) * ~~Fixed a crash on startup when multiple audio devices are plugged in (#4629)~~ * Wizard: Generate a working configuration for isapc (#4961) * Settings: Use pretty labels for CPU flags (#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. (#4667) * (macOS) Ignore missing links (drives, shared directory, etc) when saving an Apple VM * (macOS) Preference: added option to force Num Lock on (#4625) * (macOS) Preference: added option to prevent idle sleep while VM is running (#4963) * (macOS) Preference: added option to suppress exit confirmation (#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 (#5025) * (macOS) Fixed an issue where a moved or deleted VM with a stopped window open will attempt to use the old path (#4985) * (macOS) Fixed cursor scrolling and double click issues (#4636, #4645) * (macOS) Support following a change in system default input or output audio 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 (#4938) ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][3] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://github.com/osy/Jitterbug

## 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](https://docs.getutm.app/scripting/reference/) for more details and [the cheat sheet](https://docs.getutm.app/scripting/cheat-sheet/) for example usage. ## 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.2) * Fixed an issue where a VM that is moved manually (e.g. with Finder) cannot be started (#5121) * Fixed an issue where the cursor disappears after resuming a suspended VM (#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) (#5125) ## Changes (v4.2.1) * QEMU: Support more than 8 cores for ARM64 targets (#4847) * Synchronize time on resume when QEMU guest agent is installed which should fix clock drift issues (#3218) * (iOS SE) Updated TCTI to latest branch from @ktemkin which has support for vector instructions (#4865) * (macOS) Switch to emulated trackpad when guest+host are macOS 13+ (second attempt for #4636 and #4645) * (macOS) Fixed the "raw image" checkbox when creating a new drive (#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 (#4910) * Remove virtio-bus devices (they didn't work) (#4893) * Support drag and drop to import an .utm package (#3599) * Support copying sparse images across different volumes (thanks @ktprograms) * Fixed tearing/performance issue for non-GL accelerated displays when under graphics load (#5049) * Fixed error when importing a new drive with the same name as an existing drive (#5052) * ~~Fixed a crash on startup when multiple audio devices are plugged in (#4629)~~ * Wizard: Generate a working configuration for isapc (#4961) * Settings: Use pretty labels for CPU flags (#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. (#4667) * (macOS) Ignore missing links (drives, shared directory, etc) when saving an Apple VM * (macOS) Preference: added option to force Num Lock on (#4625) * (macOS) Preference: added option to prevent idle sleep while VM is running (#4963) * (macOS) Preference: added option to suppress exit confirmation (#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 (#5025) * (macOS) Fixed an issue where a moved or deleted VM with a stopped window open will attempt to use the old path (#4985) * (macOS) Fixed cursor scrolling and double click issues (#4636, #4645) * (macOS) Support following a change in system default input or output audio 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 (#4938) ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][3] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://github.com/osy/Jitterbug

## 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. ## 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.1) * QEMU: Support more than 8 cores for ARM64 targets (#4847) * Synchronize time on resume when QEMU guest agent is installed which should fix clock drift issues (#3218) * (iOS SE) Updated TCTI to latest branch from @ktemkin which has support for vector instructions (#4865) * (macOS) Switch to emulated trackpad when guest+host are macOS 13+ (second attempt for #4636 and #4645) * (macOS) Fixed the "raw image" checkbox when creating a new drive (#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 (#4910) * Remove virtio-bus devices (they didn't work) (#4893) * Support drag and drop to import an .utm package (#3599) * Support copying sparse images across different volumes (thanks @ktprograms) * Fixed tearing/performance issue for non-GL accelerated displays when under graphics load (#5049) * Fixed error when importing a new drive with the same name as an existing drive (#5052) * ~~Fixed a crash on startup when multiple audio devices are plugged in (#4629)~~ * Wizard: Generate a working configuration for isapc (#4961) * Settings: Use pretty labels for CPU flags (#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. (#4667) * (macOS) Ignore missing links (drives, shared directory, etc) when saving an Apple VM * (macOS) Preference: added option to force Num Lock on (#4625) * (macOS) Preference: added option to prevent idle sleep while VM is running (#4963) * (macOS) Preference: added option to suppress exit confirmation (#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 (#5025) * (macOS) Fixed an issue where a moved or deleted VM with a stopped window open will attempt to use the old path (#4985) * (macOS) Fixed cursor scrolling and double click issues (#4636, #4645) * (macOS) Support following a change in system default input or output audio 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 (#4938) ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][3] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://github.com/osy/Jitterbug

## Highlights 🌲 ## 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.0) * Updated virglrenderer to latest (27/02/2023) commit * Automatically revert CPU to "default" if model is missing due to updated QEMU (#4910) * Remove virtio-bus devices (they didn't work) (#4893) * Support drag and drop to import an .utm package (#3599) * Support copying sparse images across different volumes (thanks @ktprograms) * Fixed tearing/performance issue for non-GL accelerated displays when under graphics load (#5049) * Fixed error when importing a new drive with the same name as an existing drive (#5052) * Fixed a crash on startup when multiple audio devices are plugged in (#4629) * Wizard: Generate a working configuration for isapc (#4961) * Settings: Use pretty labels for CPU flags (#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. (#4667) * (macOS) Ignore missing links (drives, shared directory, etc) when saving an Apple VM * (macOS) Preference: added option to force Num Lock on (#4625) * (macOS) Preference: added option to prevent idle sleep while VM is running (#4963) * (macOS) Preference: added option to suppress exit confirmation (#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 (#5025) * (macOS) Fixed an issue where a moved or deleted VM with a stopped window open will attempt to use the old path (#4985) * (macOS) Fixed cursor scrolling and double click issues (#4636, #4645) * (macOS) Support following a change in system default input or output audio 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 (#4938) ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][3] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://github.com/osy/Jitterbug

This is the same release as v4.1.5 but with the change to default enable GPU acceleration for Linux reverted. This is due to a number of guest-side driver issues in the latest version of Mesa (#4983). As a result of these issues, we decided to disable GPU acceleration in Linux by default for new VMs created by the wizard. If you have an existing VM with graphical issues, you can disable GPU acceleration by going into the VM settings, under Display, change the Emulated Display Card to `virtio-gpu-pci` or another card that does not have `-gl` in the name. You can verify that GPU acceleration is disabled when the checkbox below the card is unchecked. ## Highlights * **QEMU backend updated to v7.2.0**. Also updated usbredir (0.13.0), virglrenderer (latest commit), ANGLE (latest commit) * **Improved renderer backend**. Lots of bug fixes and stability improvements to GPU accelerated Linux VMs (most common crashes when GPU acceleration is enabled should be gone now). New option to change the renderer backend to ANGLE Metal and limit FPS (in Preferences). Switching to Metal is highly recommended. * (iOS) **TrollStore build (UTM.HV.ipa) now supports JIT**. Additionally, there is now in-app settings. * (iOS) **TrollStore build now supports TSO (Total Store Ordering)**. TSO is used by Rosetta on the Mac to improve x86_64 emulation on ARM64. It can now be used on M1 iPads with QEMU to improve performance of FEX-Emu or a patched Rosetta. Note that it is recommended that TSO be disabled if you do not need to emulate x86_64 because it can reduce performance of other tasks. * (macOS) **AppleScript (OSA) support and CLI interface**. You can control parts of UTM through the OSA interface. Currently there is support for listing VMs as well as start/stop/suspend operations and the ability to print out the guest serial port connections. More functionality will be added in the future. A command line application is also provided in `UTM.app/Contents/MacOS/utmctl` (which you can symlink to `/usr/local/bin/utmctl` if desired) that can be used for automation tasks without needing to learn AppleScript. * (macOS 13+) **Menu bar extra**. You can enable the menu bar extra icon in Preferences (Cmd+,) as well as disable the dock icon. The menu bar extra provides a minimal interface to start/stop/suspend VMs and is useful when paired with headless VMs (a VM that does not have any display or terminal console installed). ## 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 * ~~Newly created Linux VMs will now use `virtio-gpu-gl-pci` by default. It is recommended that you change the display card of existing QEMU backend Linux VMs to this card in order to take advantage of the improved renderer backend. This should result in improved performance in GUI rendering. Note that some applications (particularly 3D applications) may lock up or crash UTM and if you are experiencing issues, you can go back to `virtio-ramfb` or `virtio-vga`.~~ * Newly created Windows VMs will now use `virtio-ramfb-gl` (Apple Silicon) or `virtio-vga-gl` (Intel) by default. There is NO 3D acceleration drivers for Windows yet, so unlike Linux, this will not improve any compatibility with applications. However, the GL backend can still be beneficial to Windows users because it has smoother animations and less tearing and artifacts. The overall benefits will not be as pronounced as for Linux VMs so it is optional that you change existing VMs to a `-gl` display card. * (iOS) It is recommended that you switch to the Metal backend in Preferences for better performance. However, some applications such as `glxgears` will not work with the Metal backend. ## Changes (v4.1.6) * Wizard: Re-introduced the checkbox for "Hardware OpenGL Acceleration" which is disabled by default due to guest-side issues in the latest Mesa driver ## Changes (v4.1.5) * Improved rendering of non-GL graphics on the new renderer backend. This should reduce some of the tearing seen in earlier updates. For the best performance, it is recommended that a GL backend is selected. * Support read-only disk images in QEMU backend as well as selecting images that are read-only (#4838) Note: all external drive images (ISOs) are now loaded as read-only, this was not enforced in previous versions due to an error in the logic. * Newly created Windows VMs will now use `virtio-ramfb-gl` (Apple Silicon) or `virtio-vga-gl` (Intel) by default. See the Notes section for more information. * Fixed an issue where the incorrect tmp directory path was used by QEMU (#4882) * Scripting: Fixed an issue where the proper error message was not displayed in some cases. * CLI: Improved some help text. * Localization: updated Japanese (thanks @MMP0) ## Changes (v4.1.4) * Fixed slow rendering of GRUB and EFI menus * Introduced new optimizations to renderer: bliting done on GPU instead of CPU now (for non-GL rendering), guest draw calls that are faster than the monitor refresh rate are now consolidated before drawing at vblank, rendering of multiple displays can happen concurrently now * Fixed rendering to multiple displays on the new renderer backend * Fixed an issue in QEMU where the vmnet backend uses 100% of CPU when the VM is suspended (#4803) * (iOS) TrollStore: Fixed JIT enable in the HV builds * (iOS) TrollStore: New option to enable TSO (Total Store Ordering) in QEMU settings (see Highlights for more details) * (iOS) Restored the default renderer backend to GL. This was changed in v4.1.3 because Metal is faster but the new backend can introduce regressions such as `glxgears` not working (#4856). As a result, the new backend is now opt-in but is still highly recommended. * (iOS) Fixed crash when changing VM settings on iOS 14 (#4864) * (iOS) Fixed crash when starting a VM with UTM SE (#4848) * (macOS) A tooltip will now reveal why suspend functionality is disabled ## Changes (v4.1.3) * Updated QEMU to v7.2.0 * Reworked CocoaSpice renderer to respond faster to GL updates from the guest, should improve frame pacing on GL supported Linux VMs * Added global setting to change renderer backend, introduce ANGLE Metal as an option (and also the new default for iOS) * Added global setting to limit FPS which can be used to improve frame pacing for a smoother rendering experience * Settings: clearly show if the current display hardware supports GPU acceleration * Wizard: GPU acceleration is now enabled by default when Linux is selected as the operating system * Fixed crash due to an error with `GL_DRAW_COOKIE_INVALID` (#4722) * Fixed deadlock on startup caused by gstosxaudio (#2364) * Fixed memory leak when GPU acceleration is enabled (#4449) * Fixed crash in `-[MTLResourceList releaseAllObjectsAndReset]` (#3519) * Fixed Mesa issue causing some GNOME desktop to freeze when GPU acceleration is enabled * Fixed incorrect logic when cloning a VM (#4815) * Fixed some thread scheduling warning (#4352) * Localization: updated French (thanks @FRtranslator) * (iOS) TrollStore build: use `com.apple.private.security.no-sandbox` instead of `com.apple.private.security.no-container` on recommendation of other devs and to align with how other apps perform JIT. * (iOS) Fixed blank screen when choosing "Open" in the wizard (#4842) * (iOS) Fixed toolbar not auto-hiding before first interaction (#4844) * (macOS) New design for global settings (Cmd+,) which better organizes the settings * (macOS) utmctl: Fixed crash when `utmctl help attach` runs (#4817) * (macOS) utmctl: Fixed `utmctl stop` with `--request` and `kill` (#4850) ## Changes (v4.1.2) * Localization: updated Spanish (Latin America) (thanks @JezerM) * Localization: updated Japanese (thanks @MMP0 and @skyarrow87) * Localization: updated Chinese Simplified (thanks @changanmoon) * (iOS) Fix new VM wizard not appearing on < iOS 14.5 (#4776) * (macOS) Implement OSA interface for AppleScript * (macOS) Introduce a CLI application (`UTM.app/Contents/MacOS/utmctl`) that wraps around the OSA interface for automation * (macOS 13+) New settings option to enable a menu bar extra icon for controlling VMs * (macOS 13+) New settings option to disable the dock icon * (macOS) Fix various alignment issues in settings (#4596) (thanks @JezerM) * (macOS) Fix a crash when the pasteboard is updated (#4745) * (macOS) Support custom resolutions for Apple Virtualization VMs * (macOS) Fixed a UI freeze when canceling out of the settings for an Apple Virtualization VM ## Changes (v4.1.1) * Fixed launching SPARC machines (#4575) * Fixed an error when attempting to save a VM where one of its removable drives is linked to a file that has been deleted * Fixed IPSW/.utm download failing when the device goes to sleep (the download should resume after wake up) * Restored scroll bars when system is set to always show scroll bars. Added a new SwiftUI crash workaround thanks to @evelyneee. * Display all sizes in binary (MiB/GiB) mode in order to be consistent (#4396) * Localization: added Polish (thanks @mavethee) * Localization: updated Japanese (thanks @MMP0) * Localization: updated Spanish (Latin America) (thanks @JezerM) * Localization: updated French (thanks @FRtranslator) * (macOS) Fixed the port forward UI on macOS 11 and introduce a new port forward UI for macOS 12+ (#4690) * (macOS) Fixed "This virtual machine cannot be run on this machine." error on a newly created Apple VM (#4595) * (macOS) Added new 21:9 widescreen resolution for Apple VMs (thanks @Tandolf) * (macOS) Added a clarifying message about shared directory support on older macOS guests (#4594) * (macOS) Added new shutdown options (software request and force kill) which can be toggled by long pressing the power button in the VM window (#4001) * (macOS) Added a confirmation dialog when deleting a drive (#4687) ## Changes (v4.1.0) * Updated QEMU to v7.1.0 * Updated ANGLE and virglrenderer to latest commit * Fixed an issue where user override of machine property settings was not applied properly * Localization: updated Japanese (thanks @MMP0) * Localization: updated Spanish (Latin America) (thanks @JezerM) * (iOS) Added in-app settings popover which synchronizes with the Settings app (useful for TrollStore installs where the Settings app page is inaccessible) (#4446) * (iOS) TrollStore: support JIT without needing a separate JIT enabler (thanks @PojavLauncherTeam for the idea) ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][3] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://github.com/osy/Jitterbug

## Highlights * **QEMU backend updated to v7.2.0**. Also updated usbredir (0.13.0), virglrenderer (latest commit), ANGLE (latest commit) * **Improved renderer backend**. Lots of bug fixes and stability improvements to GPU accelerated Linux VMs (most common crashes when GPU acceleration is enabled should be gone now). New option to change the renderer backend to ANGLE Metal and limit FPS (in Preferences). Switching to Metal is highly recommended. * (iOS) **TrollStore build (UTM.HV.ipa) now supports JIT**. Additionally, there is now in-app settings. * (iOS) **TrollStore build now supports TSO (Total Store Ordering)**. TSO is used by Rosetta on the Mac to improve x86_64 emulation on ARM64. It can now be used on M1 iPads with QEMU to improve performance of FEX-Emu or a patched Rosetta. Note that it is recommended that TSO be disabled if you do not need to emulate x86_64 because it can reduce performance of other tasks. * (macOS) **AppleScript (OSA) support and CLI interface**. You can control parts of UTM through the OSA interface. Currently there is support for listing VMs as well as start/stop/suspend operations and the ability to print out the guest serial port connections. More functionality will be added in the future. A command line application is also provided in `UTM.app/Contents/MacOS/utmctl` (which you can symlink to `/usr/local/bin/utmctl` if desired) that can be used for automation tasks without needing to learn AppleScript. * (macOS 13+) **Menu bar extra**. You can enable the menu bar extra icon in Preferences (Cmd+,) as well as disable the dock icon. The menu bar extra provides a minimal interface to start/stop/suspend VMs and is useful when paired with headless VMs (a VM that does not have any display or terminal console installed). ## 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 * Newly created Linux VMs will now use `virtio-gpu-gl-pci` by default. It is recommended that you change the display card of existing QEMU backend Linux VMs to this card in order to take advantage of the improved renderer backend. This should result in improved performance in GUI rendering. Note that some applications (particularly 3D applications) may lock up or crash UTM and if you are experiencing issues, you can go back to `virtio-ramfb` or `virtio-vga`. * Newly created Windows VMs will now use `virtio-ramfb-gl` (Apple Silicon) or `virtio-vga-gl` (Intel) by default. There is NO 3D acceleration drivers for Windows yet, so unlike Linux, this will not improve any compatibility with applications. However, the GL backend can still be beneficial to Windows users because it has smoother animations and less tearing and artifacts. The overall benefits will not be as pronounced as for Linux VMs so it is optional that you change existing VMs to a `-gl` display card. * (iOS) It is recommended that you switch to the Metal backend in Preferences for better performance. However, some applications such as `glxgears` will not work with the Metal backend. ## Changes (v4.1.5) * Improved rendering of non-GL graphics on the new renderer backend. This should reduce some of the tearing seen in earlier updates. For the best performance, it is recommended that a GL backend is selected. * Support read-only disk images in QEMU backend as well as selecting images that are read-only (#4838) Note: all external drive images (ISOs) are now loaded as read-only, this was not enforced in previous versions due to an error in the logic. * Newly created Windows VMs will now use `virtio-ramfb-gl` (Apple Silicon) or `virtio-vga-gl` (Intel) by default. See the Notes section for more information. * Fixed an issue where the incorrect tmp directory path was used by QEMU (#4882) * Scripting: Fixed an issue where the proper error message was not displayed in some cases. * CLI: Improved some help text. * Localization: updated Japanese (thanks @MMP0) ## Changes (v4.1.4) * Fixed slow rendering of GRUB and EFI menus * Introduced new optimizations to renderer: bliting done on GPU instead of CPU now (for non-GL rendering), guest draw calls that are faster than the monitor refresh rate are now consolidated before drawing at vblank, rendering of multiple displays can happen concurrently now * Fixed rendering to multiple displays on the new renderer backend * Fixed an issue in QEMU where the vmnet backend uses 100% of CPU when the VM is suspended (#4803) * (iOS) TrollStore: Fixed JIT enable in the HV builds * (iOS) TrollStore: New option to enable TSO (Total Store Ordering) in QEMU settings (see Highlights for more details) * (iOS) Restored the default renderer backend to GL. This was changed in v4.1.3 because Metal is faster but the new backend can introduce regressions such as `glxgears` not working (#4856). As a result, the new backend is now opt-in but is still highly recommended. * (iOS) Fixed crash when changing VM settings on iOS 14 (#4864) * (iOS) Fixed crash when starting a VM with UTM SE (#4848) * (macOS) A tooltip will now reveal why suspend functionality is disabled ## Changes (v4.1.3) * Updated QEMU to v7.2.0 * Reworked CocoaSpice renderer to respond faster to GL updates from the guest, should improve frame pacing on GL supported Linux VMs * Added global setting to change renderer backend, introduce ANGLE Metal as an option (and also the new default for iOS) * Added global setting to limit FPS which can be used to improve frame pacing for a smoother rendering experience * Settings: clearly show if the current display hardware supports GPU acceleration * Wizard: GPU acceleration is now enabled by default when Linux is selected as the operating system * Fixed crash due to an error with `GL_DRAW_COOKIE_INVALID` (#4722) * Fixed deadlock on startup caused by gstosxaudio (#2364) * Fixed memory leak when GPU acceleration is enabled (#4449) * Fixed crash in `-[MTLResourceList releaseAllObjectsAndReset]` (#3519) * Fixed Mesa issue causing some GNOME desktop to freeze when GPU acceleration is enabled * Fixed incorrect logic when cloning a VM (#4815) * Fixed some thread scheduling warning (#4352) * Localization: updated French (thanks @FRtranslator) * (iOS) TrollStore build: use `com.apple.private.security.no-sandbox` instead of `com.apple.private.security.no-container` on recommendation of other devs and to align with how other apps perform JIT. * (iOS) Fixed blank screen when choosing "Open" in the wizard (#4842) * (iOS) Fixed toolbar not auto-hiding before first interaction (#4844) * (macOS) New design for global settings (Cmd+,) which better organizes the settings * (macOS) utmctl: Fixed crash when `utmctl help attach` runs (#4817) * (macOS) utmctl: Fixed `utmctl stop` with `--request` and `kill` (#4850) ## Changes (v4.1.2) * Localization: updated Spanish (Latin America) (thanks @JezerM) * Localization: updated Japanese (thanks @MMP0 and @skyarrow87) * Localization: updated Chinese Simplified (thanks @changanmoon) * (iOS) Fix new VM wizard not appearing on < iOS 14.5 (#4776) * (macOS) Implement OSA interface for AppleScript * (macOS) Introduce a CLI application (`UTM.app/Contents/MacOS/utmctl`) that wraps around the OSA interface for automation * (macOS 13+) New settings option to enable a menu bar extra icon for controlling VMs * (macOS 13+) New settings option to disable the dock icon * (macOS) Fix various alignment issues in settings (#4596) (thanks @JezerM) * (macOS) Fix a crash when the pasteboard is updated (#4745) * (macOS) Support custom resolutions for Apple Virtualization VMs * (macOS) Fixed a UI freeze when canceling out of the settings for an Apple Virtualization VM ## Changes (v4.1.1) * Fixed launching SPARC machines (#4575) * Fixed an error when attempting to save a VM where one of its removable drives is linked to a file that has been deleted * Fixed IPSW/.utm download failing when the device goes to sleep (the download should resume after wake up) * Restored scroll bars when system is set to always show scroll bars. Added a new SwiftUI crash workaround thanks to @evelyneee. * Display all sizes in binary (MiB/GiB) mode in order to be consistent (#4396) * Localization: added Polish (thanks @mavethee) * Localization: updated Japanese (thanks @MMP0) * Localization: updated Spanish (Latin America) (thanks @JezerM) * Localization: updated French (thanks @FRtranslator) * (macOS) Fixed the port forward UI on macOS 11 and introduce a new port forward UI for macOS 12+ (#4690) * (macOS) Fixed "This virtual machine cannot be run on this machine." error on a newly created Apple VM (#4595) * (macOS) Added new 21:9 widescreen resolution for Apple VMs (thanks @Tandolf) * (macOS) Added a clarifying message about shared directory support on older macOS guests (#4594) * (macOS) Added new shutdown options (software request and force kill) which can be toggled by long pressing the power button in the VM window (#4001) * (macOS) Added a confirmation dialog when deleting a drive (#4687) ## Changes (v4.1.0) * Updated QEMU to v7.1.0 * Updated ANGLE and virglrenderer to latest commit * Fixed an issue where user override of machine property settings was not applied properly * Localization: updated Japanese (thanks @MMP0) * Localization: updated Spanish (Latin America) (thanks @JezerM) * (iOS) Added in-app settings popover which synchronizes with the Settings app (useful for TrollStore installs where the Settings app page is inaccessible) (#4446) * (iOS) TrollStore: support JIT without needing a separate JIT enabler (thanks @PojavLauncherTeam for the idea) ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][3] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://github.com/osy/Jitterbug

🎊Happy New Year!🎊 ## Highlights * **QEMU backend updated to v7.2.0**. Also updated usbredir (0.13.0), virglrenderer (latest commit), ANGLE (latest commit) * **Improved renderer backend**. Lots of bug fixes and stability improvements to GPU accelerated Linux VMs (most common crashes when GPU acceleration is enabled should be gone now). New option to change the renderer backend to ANGLE Metal and limit FPS (in Preferences). Switching to Metal is highly recommended. * (iOS) **TrollStore build (UTM.HV.ipa) now supports JIT**. Additionally, there is now in-app settings. * (iOS) **TrollStore build now supports TSO (Total Store Ordering)**. TSO is used by Rosetta on the Mac to improve x86_64 emulation on ARM64. It can now be used on M1 iPads with QEMU to improve performance of FEX-Emu or a patched Rosetta. Note that it is recommended that TSO be disabled if you do not need to emulate x86_64 because it can reduce performance of other tasks. * (macOS) **AppleScript (OSA) support and CLI interface**. You can control parts of UTM through the OSA interface. Currently there is support for listing VMs as well as start/stop/suspend operations and the ability to print out the guest serial port connections. More functionality will be added in the future. A command line application is also provided in `UTM.app/Contents/MacOS/utmctl` (which you can symlink to `/usr/local/bin/utmctl` if desired) that can be used for automation tasks without needing to learn AppleScript. * (macOS 13+) **Menu bar extra**. You can enable the menu bar extra icon in Preferences (Cmd+,) as well as disable the dock icon. The menu bar extra provides a minimal interface to start/stop/suspend VMs and is useful when paired with headless VMs (a VM that does not have any display or terminal console installed). ## 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 * The configuration backend has been massively rewritten. **Please backup all VMs prior to updating as you will not be able to re-open VMs saved by UTM v4 on older versions of UTM if you decide to downgrade.** ## Changes (v4.1.4) * Fixed slow rendering of GRUB and EFI menus * Introduced new optimizations to renderer: bliting done on GPU instead of CPU now (for non-GL rendering), guest draw calls that are faster than the monitor refresh rate are now consolidated before drawing at vblank, rendering of multiple displays can happen concurrently now * Fixed rendering to multiple displays on the new renderer backend * Fixed an issue in QEMU where the vmnet backend uses 100% of CPU when the VM is suspended (#4803) * (iOS) TrollStore: Fixed JIT enable in the HV builds * (iOS) TrollStore: New option to enable TSO (Total Store Ordering) in QEMU settings (see Highlights for more details) * (iOS) Restored the default renderer backend to GL. This was changed in v4.1.3 because Metal is faster but the new backend can introduce regressions such as `glxgears` not working (#4856). As a result, the new backend is now opt-in but is still highly recommended. * (iOS) Fixed crash when changing VM settings on iOS 14 (#4864) * (iOS) Fixed crash when starting a VM with UTM SE (#4848) * (macOS) A tooltip will now reveal why suspend functionality is disabled ## Changes (v4.1.3) * Updated QEMU to v7.2.0 * Reworked CocoaSpice renderer to respond faster to GL updates from the guest, should improve frame pacing on GL supported Linux VMs * Added global setting to change renderer backend, introduce ANGLE Metal as an option (and also the new default for iOS) * Added global setting to limit FPS which can be used to improve frame pacing for a smoother rendering experience * Settings: clearly show if the current display hardware supports GPU acceleration * Wizard: GPU acceleration is now enabled by default when Linux is selected as the operating system * Fixed crash due to an error with `GL_DRAW_COOKIE_INVALID` (#4722) * Fixed deadlock on startup caused by gstosxaudio (#2364) * Fixed memory leak when GPU acceleration is enabled (#4449) * Fixed crash in `-[MTLResourceList releaseAllObjectsAndReset]` (#3519) * Fixed Mesa issue causing some GNOME desktop to freeze when GPU acceleration is enabled * Fixed incorrect logic when cloning a VM (#4815) * Fixed some thread scheduling warning (#4352) * Localization: updated French (thanks @FRtranslator) * (iOS) TrollStore build: use `com.apple.private.security.no-sandbox` instead of `com.apple.private.security.no-container` on recommendation of other devs and to align with how other apps perform JIT. * (iOS) Fixed blank screen when choosing "Open" in the wizard (#4842) * (iOS) Fixed toolbar not auto-hiding before first interaction (#4844) * (macOS) New design for global settings (Cmd+,) which better organizes the settings * (macOS) utmctl: Fixed crash when `utmctl help attach` runs (#4817) * (macOS) utmctl: Fixed `utmctl stop` with `--request` and `kill` (#4850) ## Changes (v4.1.2) * Localization: updated Spanish (Latin America) (thanks @JezerM) * Localization: updated Japanese (thanks @MMP0 and @skyarrow87) * Localization: updated Chinese Simplified (thanks @changanmoon) * (iOS) Fix new VM wizard not appearing on < iOS 14.5 (#4776) * (macOS) Implement OSA interface for AppleScript * (macOS) Introduce a CLI application (`UTM.app/Contents/MacOS/utmctl`) that wraps around the OSA interface for automation * (macOS 13+) New settings option to enable a menu bar extra icon for controlling VMs * (macOS 13+) New settings option to disable the dock icon * (macOS) Fix various alignment issues in settings (#4596) (thanks @JezerM) * (macOS) Fix a crash when the pasteboard is updated (#4745) * (macOS) Support custom resolutions for Apple Virtualization VMs * (macOS) Fixed a UI freeze when canceling out of the settings for an Apple Virtualization VM ## Changes (v4.1.1) * Fixed launching SPARC machines (#4575) * Fixed an error when attempting to save a VM where one of its removable drives is linked to a file that has been deleted * Fixed IPSW/.utm download failing when the device goes to sleep (the download should resume after wake up) * Restored scroll bars when system is set to always show scroll bars. Added a new SwiftUI crash workaround thanks to @evelyneee. * Display all sizes in binary (MiB/GiB) mode in order to be consistent (#4396) * Localization: added Polish (thanks @mavethee) * Localization: updated Japanese (thanks @MMP0) * Localization: updated Spanish (Latin America) (thanks @JezerM) * Localization: updated French (thanks @FRtranslator) * (macOS) Fixed the port forward UI on macOS 11 and introduce a new port forward UI for macOS 12+ (#4690) * (macOS) Fixed "This virtual machine cannot be run on this machine." error on a newly created Apple VM (#4595) * (macOS) Added new 21:9 widescreen resolution for Apple VMs (thanks @Tandolf) * (macOS) Added a clarifying message about shared directory support on older macOS guests (#4594) * (macOS) Added new shutdown options (software request and force kill) which can be toggled by long pressing the power button in the VM window (#4001) * (macOS) Added a confirmation dialog when deleting a drive (#4687) ## Changes (v4.1.0) * Updated QEMU to v7.1.0 * Updated ANGLE and virglrenderer to latest commit * Fixed an issue where user override of machine property settings was not applied properly * Localization: updated Japanese (thanks @MMP0) * Localization: updated Spanish (Latin America) (thanks @JezerM) * (iOS) Added in-app settings popover which synchronizes with the Settings app (useful for TrollStore installs where the Settings app page is inaccessible) (#4446) * (iOS) TrollStore: support JIT without needing a separate JIT enabler (thanks @PojavLauncherTeam for the idea) ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][3] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://github.com/osy/Jitterbug

## Highlights * **QEMU backend updated to v7.2.0**. Also updated usbredir (0.13.0), virglrenderer (latest commit), ANGLE (latest commit) * **Improved renderer backend**. Lots of bug fixes and stability improvements to GPU accelerated Linux VMs (most common crashes when GPU acceleration is enabled should be gone now). New option to change the renderer backend to ANGLE Metal (which is also the default for iOS now) and limit FPS. * (iOS) **TrollStore build (UTM.HV.ipa) now supports JIT**. Additionally, there is now in-app settings. * (macOS) **AppleScript (OSA) support and CLI interface**. You can control parts of UTM through the OSA interface. Currently there is support for listing VMs as well as start/stop/suspend operations and the ability to print out the guest serial port connections. More functionality will be added in the future. A command line application is also provided in `UTM.app/Contents/MacOS/utmctl` (which you can symlink to `/usr/local/bin/utmctl` if desired) that can be used for automation tasks without needing to learn AppleScript. * (macOS 13+) **Menu bar extra**. You can enable the menu bar extra icon in Preferences (Cmd+,) as well as disable the dock icon. The menu bar extra provides a minimal interface to start/stop/suspend VMs and is useful when paired with headless VMs (a VM that does not have any display or terminal console installed). ## 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 * The configuration backend has been massively rewritten. **Please backup all VMs prior to updating as you will not be able to re-open VMs saved by UTM v4 on older versions of UTM if you decide to downgrade.** ## Changes (v4.1.3) * Updated QEMU to v7.2.0 * Reworked CocoaSpice renderer to respond faster to GL updates from the guest, should improve frame pacing on GL supported Linux VMs * Added global setting to change renderer backend, introduce ANGLE Metal as an option (and also the new default for iOS) * Added global setting to limit FPS which can be used to improve frame pacing for a smoother rendering experience * Settings: clearly show if the current display hardware supports GPU acceleration * Wizard: GPU acceleration is now enabled by default when Linux is selected as the operating system * Fixed crash due to an error with `GL_DRAW_COOKIE_INVALID` (#4722) * Fixed deadlock on startup caused by gstosxaudio (#2364) * Fixed memory leak when GPU acceleration is enabled (#4449) * Fixed crash in `-[MTLResourceList releaseAllObjectsAndReset]` (#3519) * Fixed Mesa issue causing some GNOME desktop to freeze when GPU acceleration is enabled * Fixed incorrect logic when cloning a VM (#4815) * Fixed some thread scheduling warning (#4352) * Localization: updated French (thanks @FRtranslator) * (iOS) TrollStore build: use `com.apple.private.security.no-sandbox` instead of `com.apple.private.security.no-container` on recommendation of other devs and to align with how other apps perform JIT. * (iOS) Fixed blank screen when choosing "Open" in the wizard (#4842) * (iOS) Fixed toolbar not auto-hiding before first interaction (#4844) * (macOS) New design for global settings (Cmd+,) which better organizes the settings * (macOS) utmctl: Fixed crash when `utmctl help attach` runs (#4817) * (macOS) utmctl: Fixed `utmctl stop` with `--request` and `kill` (#4850) ## Changes (v4.1.2) * Localization: updated Spanish (Latin America) (thanks @JezerM) * Localization: updated Japanese (thanks @MMP0 and @skyarrow87) * Localization: updated Chinese Simplified (thanks @changanmoon) * (iOS) Fix new VM wizard not appearing on < iOS 14.5 (#4776) * (macOS) Implement OSA interface for AppleScript * (macOS) Introduce a CLI application (`UTM.app/Contents/MacOS/utmctl`) that wraps around the OSA interface for automation * (macOS 13+) New settings option to enable a menu bar extra icon for controlling VMs * (macOS 13+) New settings option to disable the dock icon * (macOS) Fix various alignment issues in settings (#4596) (thanks @JezerM) * (macOS) Fix a crash when the pasteboard is updated (#4745) * (macOS) Support custom resolutions for Apple Virtualization VMs * (macOS) Fixed a UI freeze when canceling out of the settings for an Apple Virtualization VM ## Changes (v4.1.1) * Fixed launching SPARC machines (#4575) * Fixed an error when attempting to save a VM where one of its removable drives is linked to a file that has been deleted * Fixed IPSW/.utm download failing when the device goes to sleep (the download should resume after wake up) * Restored scroll bars when system is set to always show scroll bars. Added a new SwiftUI crash workaround thanks to @evelyneee. * Display all sizes in binary (MiB/GiB) mode in order to be consistent (#4396) * Localization: added Polish (thanks @mavethee) * Localization: updated Japanese (thanks @MMP0) * Localization: updated Spanish (Latin America) (thanks @JezerM) * Localization: updated French (thanks @FRtranslator) * (macOS) Fixed the port forward UI on macOS 11 and introduce a new port forward UI for macOS 12+ (#4690) * (macOS) Fixed "This virtual machine cannot be run on this machine." error on a newly created Apple VM (#4595) * (macOS) Added new 21:9 widescreen resolution for Apple VMs (thanks @Tandolf) * (macOS) Added a clarifying message about shared directory support on older macOS guests (#4594) * (macOS) Added new shutdown options (software request and force kill) which can be toggled by long pressing the power button in the VM window (#4001) * (macOS) Added a confirmation dialog when deleting a drive (#4687) ## Changes (v4.1.0) * Updated QEMU to v7.1.0 * Updated ANGLE and virglrenderer to latest commit * Fixed an issue where user override of machine property settings was not applied properly * Localization: updated Japanese (thanks @MMP0) * Localization: updated Spanish (Latin America) (thanks @JezerM) * (iOS) Added in-app settings popover which synchronizes with the Settings app (useful for TrollStore installs where the Settings app page is inaccessible) (#4446) * (iOS) TrollStore: support JIT without needing a separate JIT enabler (thanks @PojavLauncherTeam for the idea) ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. * **UTM SE is currently not working!** (#4848) ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][3] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://github.com/osy/Jitterbug

## Highlights * **QEMU backend updated to v7.1.0** * (iOS) **TrollStore build (UTM.HV.ipa) now supports JIT**. Additionally, there is now in-app settings. * (macOS) **AppleScript (OSA) support and CLI interface**. You can control parts of UTM through the OSA interface. Currently there is support for listing VMs as well as start/stop/suspend operations and the ability to print out the guest serial port connections. More functionality will be added in the future. A command line application is also provided in `UTM.app/Contents/MacOS/utmctl` (which you can symlink to `/usr/local/bin/utmctl` if desired) that can be used for automation tasks without needing to learn AppleScript. * (macOS 13+) **Menu bar extra**. You can enable the menu bar extra icon in Preferences (Cmd+,) as well as disable the dock icon. The menu bar extra provides a minimal interface to start/stop/suspend VMs and is useful when paired with headless VMs (a VM that does not have any display or terminal console installed). ## 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 * The configuration backend has been massively rewritten. **Please backup all VMs prior to updating as you will not be able to re-open VMs saved by UTM v4 on older versions of UTM if you decide to downgrade.** ## Changes (v4.1.2) * Localization: updated Spanish (Latin America) (thanks @JezerM) * Localization: updated Japanese (thanks @MMP0 and @skyarrow87) * Localization: updated Chinese Simplified (thanks @changanmoon) * (iOS) Fix new VM wizard not appearing on < iOS 14.5 (#4776) * (macOS) Implement OSA interface for AppleScript * (macOS) Introduce a CLI application (`UTM.app/Contents/MacOS/utmctl`) that wraps around the OSA interface for automation * (macOS 13+) New settings option to enable a menu bar extra icon for controlling VMs * (macOS 13+) New settings option to disable the dock icon * (macOS) Fix various alignment issues in settings (#4596) (thanks @JezerM) * (macOS) Fix a crash when the pasteboard is updated (#4745) * (macOS) Support custom resolutions for Apple Virtualization VMs * (macOS) Fixed a UI freeze when canceling out of the settings for an Apple Virtualization VM ## Changes (v4.1.1) * Fixed launching SPARC machines (#4575) * Fixed an error when attempting to save a VM where one of its removable drives is linked to a file that has been deleted * Fixed IPSW/.utm download failing when the device goes to sleep (the download should resume after wake up) * Restored scroll bars when system is set to always show scroll bars. Added a new SwiftUI crash workaround thanks to @evelyneee. * Display all sizes in binary (MiB/GiB) mode in order to be consistent (#4396) * Localization: added Polish (thanks @mavethee) * Localization: updated Japanese (thanks @MMP0) * Localization: updated Spanish (Latin America) (thanks @JezerM) * Localization: updated French (thanks @FRtranslator) * (macOS) Fixed the port forward UI on macOS 11 and introduce a new port forward UI for macOS 12+ (#4690) * (macOS) Fixed "This virtual machine cannot be run on this machine." error on a newly created Apple VM (#4595) * (macOS) Added new 21:9 widescreen resolution for Apple VMs (thanks @Tandolf) * (macOS) Added a clarifying message about shared directory support on older macOS guests (#4594) * (macOS) Added new shutdown options (software request and force kill) which can be toggled by long pressing the power button in the VM window (#4001) * (macOS) Added a confirmation dialog when deleting a drive (#4687) ## Changes (v4.1.0) * Updated QEMU to v7.1.0 * Updated ANGLE and virglrenderer to latest commit * Fixed an issue where user override of machine property settings was not applied properly * Localization: updated Japanese (thanks @MMP0) * Localization: updated Spanish (Latin America) (thanks @JezerM) * (iOS) Added in-app settings popover which synchronizes with the Settings app (useful for TrollStore installs where the Settings app page is inaccessible) (#4446) * (iOS) TrollStore: support JIT without needing a separate JIT enabler (thanks @PojavLauncherTeam for the idea) ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][3] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://github.com/osy/Jitterbug

## Highlights * **QEMU backend updated to v7.1.0** * (iOS) **TrollStore build (UTM.HV.ipa) now supports JIT**. Additionally, there is now in-app 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 * The configuration backend has been massively rewritten. **Please backup all VMs prior to updating as you will not be able to re-open VMs saved by UTM v4 on older versions of UTM if you decide to downgrade.** ## Changes (v4.1.1) * Fixed launching SPARC machines (#4575) * Fixed an error when attempting to save a VM where one of its removable drives is linked to a file that has been deleted * Fixed IPSW/.utm download failing when the device goes to sleep (the download should resume after wake up) * Restored scroll bars when system is set to always show scroll bars. Added a new SwiftUI crash workaround thanks to @evelyneee. * Display all sizes in binary (MiB/GiB) mode in order to be consistent (#4396) * Localization: added Polish (thanks @mavethee) * Localization: updated Japanese (thanks @MMP0) * Localization: updated Spanish (Latin America) (thanks @JezerM) * Localization: updated French (thanks @FRtranslator) * (macOS) Fixed the port forward UI on macOS 11 and introduce a new port forward UI for macOS 12+ (#4690) * (macOS) Fixed "This virtual machine cannot be run on this machine." error on a newly created Apple VM (#4595) * (macOS) Added new 21:9 widescreen resolution for Apple VMs (thanks @Tandolf) * (macOS) Added a clarifying message about shared directory support on older macOS guests (#4594) * (macOS) Added new shutdown options (software request and force kill) which can be toggled by long pressing the power button in the VM window (#4001) * (macOS) Added a confirmation dialog when deleting a drive (#4687) ## Changes (v4.1.0) * Updated QEMU to v7.1.0 * Updated ANGLE and virglrenderer to latest commit * Fixed an issue where user override of machine property settings was not applied properly * Localization: updated Japanese (thanks @MMP0) * Localization: updated Spanish (Latin America) (thanks @JezerM) * (iOS) Added in-app settings popover which synchronizes with the Settings app (useful for TrollStore installs where the Settings app page is inaccessible) (#4446) * (iOS) TrollStore: support JIT without needing a separate JIT enabler (thanks @PojavLauncherTeam for the idea) ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][3] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://github.com/osy/Jitterbug

## Highlights * **QEMU backend updated to v7.1.0** * (iOS) **TrollStore build (UTM.HV.ipa) now supports JIT**. Additionally, there is now in-app 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 * The configuration backend has been massively rewritten. **Please backup all VMs prior to updating as you will not be able to re-open VMs saved by UTM v4 on older versions of UTM if you decide to downgrade.** ## Changes (v4.1.0) * Updated QEMU to v7.1.0 * Updated ANGLE and virglrenderer to latest commit * Fixed an issue where user override of machine property settings was not applied properly * Localization: updated Japanese (thanks @MMP0) * Localization: updated Spanish (Latin America) (thanks @JezerM) * (iOS) Added in-app settings popover which synchronizes with the Settings app (useful for TrollStore installs where the Settings app page is inaccessible) (#4446) * (iOS) TrollStore: support JIT without needing a separate JIT enabler (thanks @PojavLauncherTeam for the idea) ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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][3] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://github.com/osy/Jitterbug

## Highlights * **Multiple display and headless display is now supported for QEMU machines.** You can configure 0 or more displays as well as 0 or more builtin terminal consoles. On macOS, a new window will be created for each display and builtin terminal. On iOS, you can create multiple windows (iPad) as well as plug in an external display or AirPlay (iPad or iPhone) and assign outputs to each window. * **Ventura updates to Virtualization.** macOS Ventura introduces new features that is now integrated into UTM. You can now create GUI Linux VMs with EFI boot. Directory sharing now works with macOS Ventura guests. Rosetta x86_64 emulation is supported for Linux VMs on Apple Silicon. Check out https://docs.getutm.app/guides/debian/ for an installation guide. Note that base M1 chip users may experience issues that will be addressed in a future update. * **VirtFS sharing for QEMU.** This alternative directory sharing backend is supported by Linux and can have better performance. Note that macOS UID are numbered differently than Linux so you may have to run `chown` in the guest. Check out https://docs.getutm.app/guest-support/linux/ for more details. * **Easier Windows 10/11 installation and Windows guest tools downloader.** You can now download and mount the Windows drivers and guest tools ISO image with a single click (macOS: disk icon in VM window, iOS: 3D touch context menu on home screen). Additionally, the ISO now include an "Autounattend.xml" which is recognized by the Windows 10/11 installer. When mounted to a second CD drive, the installer will install the correct drivers, bypass secure boot/TPM requirements, and launch the SPICE tools installer on first login. * (macOS) **Resize QEMU disk images.** In the drives settings page, you can now expand the size of the QCOW2 disk image. * (iOS) **QEMU Virtualization for M1 iPad.** With the release of [TrollStore](https://github.com/opa334/TrollStore), you can now enable Hypervisor on iOS. Note that only M1 hardware and kernel have support for Hypervisor. iOS 14.4.2-14.5.1 is supported only on M1 iPad Pro jailbroken with fugu14/unc0ver. iOS 14.0-15.5b4 is supported on any M1 iPad running TrollStore. * **New documentation site.** https://docs.getutm.app/ is the home of the official UTM documentation. * **New localization.** Thanks to various community members, UTM is now translated to: Chinese (Simplified), Chinese (Traditional), Finnish, French, German, Japanese, Korean, and Spanish (Latin America) ## Notes * **iOS 14 and macOS 11.3** are the new minimum supported systems. Please use UTM v3.x for support down to iOS 11 and macOS 11 * The configuration backend has been massively rewritten. **Please backup all VMs prior to updating as you will not be able to re-open VMs saved by UTM v4 on older versions of UTM if you decide to downgrade.** * Since v4.0.6, the order of generated devices has changed to always create network devices first. This is to address an issue on some distributions (such as Ubuntu) where adding a device (drive, display, etc) would require re-configurating the network because the device name changed. Unfortunately, this change will cause the configuration issue to occur once more on any existing VM that is susceptible to the network issue. On Ubuntu, this will require you to modify `/etc/netplan/00-installer-config.yaml` and change the adapter name from `enp0s9` (or whatever it is currently) to `enp0s1` (which reflects the new device ordering). Other Linux distributions may require a similar change. However, after updating the guest network configuration, you should no longer have issues with networking when making device changes to the VM. ## Changes (v4.0.9) * Fixed some broken links to documentation (#4529) * Fixed an issue where running ARM64 emulation on ARM64 gives an error "The ‘host’ CPU type can only be used with KVM or HVF" (#4528) * Fixed a regression where S390x and SPARC VMs cannot start due to missing USB bus * (iOS) Fixed UTM SE cannot launch any VMs (#4516) ## Changes (v4.0.8) * Translation: Updated Japanese (thanks @MMP0) * Translation: Updated French (thanks @FRtranslator and @alexis-martel) * Translation: Added German (thanks @conath) * (macOS) Disable resize button in GUI Apple VM window * (macOS) Reverted some SwiftUI issue workarounds that are no longer present in Ventura RC ## Changes (v4.0.7) * Fixed renamed VM not appearing on next launch (#4469) * Fixed TCP server not working (#4479) * Fixed random network issues caused by invalid MAC address generation (you must re-generate MAC to apply the change if your VM created in UTM v4 does not have working network) (#4477) * Fixed a crash when trying to boot Kali Linux with terminal enabled * Fixed hypervisor on iOS 14.6-14.8 * Added new setting for serial device in TCP server mode to listen on remote/local interfaces (#4483) * Fixed URL automation sending text to terminal * Translation: Updated Japanese (thanks @MMP0) * Translation: Updated French (thanks @FRtranslator) * Wizard: Link to new documentation site (#4443, #4445) * (iOS) Fixed disponible run option not appearing * (macOS) Fixed settings getting stuck at information page (#4465) * (macOS) Updated display menu option to match title bar when multiple displays are used (#4484) * (macOS) Fixed no mouse/keyboard on Intel Apple Virtualization (#4409) * (macOS) Fixed no audio input device on Linux running on Apple Virtualization (#4409) * (macOS) Fixed auto-quit when all windows are closed happening when headless VM is still running ## Changes (v4.0.6) * Fixed an issue in argument generation where PS/2 input was forced even when USB was enabled (#4424) * Validate settings on save before closing the settings dialog * Network devices are now created first before all other devices. Note this means that networking will be broken on some existing VMs and must be re-configured! (See notes above) * Fixed a deadlock issue when saving settings * Fixed an error when saving a VM with an external drive selected * Translation: Updated Japanese (thanks @MMP0) * Translation: Updated French (thanks @FRtranslator) * Wizard: The Windows guest tools auto-installer currently only works on Windows 10 and above. A new option is added in the wizard to make this explicit. (#4440) * Wizard: Use VirtFS sharing by default when Linux is selected * (iOS) Default to emulated network instead of failing when importing a VM created on macOS * (macOS) Fixed an issue where opening a new display window from a serial window did not work * (macOS) Fixed logic on macOS 11 where serial window was not created * (macOS) Fixed a crash on macOS 11 when saving settings while the QEMU tab is selected * (macOS 13) Support clipboard sharing on Linux with Apple Virtualization when `spice-vdagent` is installed * (macOS) Fixed an issue changing the boot OS where the incorrect image type is prompted * (macOS) Perform settings validation when launching an Apple Virtualization VM to ensure selected features are available * (macOS 12+) Set a machine identifier when launching an Apple Virtualization VM * (macOS 13) Emulate trackpad on macOS guests with Apple Virtualization * (macOS) Fixed an issue when a newly created VM will not launch on macOS 11 ## Changes (v4.0.5) * Fixed moving an existing VM with Hypervisor enabled to a device on a different architecture. The VM will fallback to TCG and the option to disable hypervisor in settings is allowed. (#4407) * Translation: Updated Japanese (thanks @MMP0) * (iOS) Fixed an issue that prevented external keyboards from working (#4399) * (iOS) Detect Hypervisor support on jailbroken devices so the option is not inadvertently enabled on non-supported devices * (iOS) Support Hypervisor on M1 iPad running jailbroken iOS 14.5 ## Changes (v4.0.4) * Fixed in issue generating configuration for IDE drives leading to PPC not booting and I/O errors on PC (#4372, #4376, others) * Moved the SPICE tools download directory to "GuestSupportTools" under "Application Support" (previously it was just under "Application Support") * Fixed creating a VM with illegal path characters in the name (#4385) * Translation: Updated Japanese (thanks @MMP0) * Translation: Updated French (thanks @FRtranslator) * Wizard: No longer tries to download the Windows guest tools when selecting a non-Windows OS * (iOS) Enable build with Hypervisor.framework (support limited to M1 iPad) * (iOS) Fixed a crash when switching display in a window * (iOS) On jailbroken devices, the memory limit will automatically be increased to the maximum, preventing the Jetsam system from terminating UTM for memory usage * (iOS) Fixed a regression which caused the home indicator to not be hidden (#4390) * (iOS) Fixed a regression which caused the cursor to not be captured (#4390) * (iOS) When switching display, notification handlers are properly cleaned up (example: cursor capture and console on screen keyboard events) * (iOS) Show the device cursor when VM is paused * (iOS) Fixed a regression where external keyboard events are not captured * (iOS) Fixed an error where extraneous stale VM entries show up after the container name changes (#4392) * (iOS) Fixed a crash on iOS 14 when opening a terminal view due to SwiftTerm handling the colour configuration * (macOS) Fixed a layout issue of the compress/resize buttons * (macOS) Forgot to actually enable compression for the drive setting button (#4377) * (macOS) Fixed some settings layout issue on < macOS 13 (#4374) ## Changes (v4.0.3) * Fixed an issue where changing external drive/shared directory for a QEMU VM -> exit UTM -> reopen UTM and start the VM results in the drive/share not being restored * Disable changing a VirtFS share from the home window (this is not an supported operation) * Better detection of UUID collision which addresses an issue where VMs with the same UUID do not show up on the home screen and other VMs show up as duplicates and clicking on any of them results in a freeze * Fixed floppy drive argument not being correctly generated (#4362) * Fixed an issue where ejecting an external drive or shared directory does not persist * Fixed a memory issue when stopping or closing VMs causing UTM to crash * Fixed a regression where an access error occurs after moving a VM * Added the ability to download the Windows SPICE tools and drivers automatically (#4364) * Added support for more than 2 IDE drives in PC emulation * Restored the setting to turn off blinking cursor (#4296) * Translation: Updated Japanese (thanks @MMP0) * Wizard: Reworked some of the UI, text, and file selection * Wizard: Add option to auto download and mount the SPICE tools to a second CD drive * Wizard: Fixed an issue where the selected boot image and shared directory was not saved on the new VM * Wizard: Recommend UUP built ISO over the VHDX by default * Wizard: New "confused user" check will catch trying to mount an "amd64" ISO on an "arm64" guest or vice versa * (iOS 16) Use the new NavigationSplitView for a slightly polished look * (iOS 16) Fixed an issue where the bottom toolbar does not show up (#4325) * (iOS) Fixed an issue where the file importer was not opening (#4365) * (iOS 14) Fixed an issue in the settings screen where multiple drives were occupying a single cell * (iOS 14) Fixed an issue where UTM may crash when adding a drive or hardware * (macOS) Added the ability to re-open closed windows for a given VM (#4351) * (macOS) Fixed an issue where restarting a VM results in duplicate windows (#4367) * (macOS) Save the size of terminal windows (#4296) * (macOS) Add resize QCOW2 image feature (thanks @stewartsmith) ## Changes (v4.0.2) * Removed "view.plist" for host-specific configuration settings (i.e. bookmarks to removable drives and window options) and replaced it with a new "registry" that is stored outside of the .utm bundle. Old "view.plist" settings and bookmarks will be migrated to the registry on first launch and the file will be deleted from the .utm bundle. For Apple VMs, the bookmarks will no longer be stored in config.plist and the settings will be migrated to the registry as well. * VirtFS no longer requires SPICE to be enabled (thanks @tie) * Fixed an issue with PPC VMs not showing 256 colours correctly (#4277) * Fixed incorrect parsing of CPU flags (#4282) * Do not save screenshots when running in disposable mode * Translation: Added Spanish (Latin America) (thanks @JezerM) * Translation: Added Finnish (thanks @marcusziade) * Translation: Updated Japanese (thanks @MMP0) * Translation: Updated Chinese (Simplified) (thanks @ty-yqs) * Translation: Updated French (thanks @FRtranslator) * (iOS) Per-display window settings (zoom, position, keyboard visibility, etc) will be stored in the new registry * (iOS) Prefer JitStreamer over AltJit when both are available (thanks @ktprograms) * (macOS) Fixed saving removable drives and shared directories for Apple VMs * (macOS) Fixed missing audio entitlements (#4342) * (macOS) Fixed QEMULauncher process not terminating when a VM is force quit * (macOS) Fixed issue selecting text in SwiftTerm (#4297) ## Changes (v4.0.1) * Fixed an issue where an UEFI BIOS error was reported when the target does not use UEFI (#4265) * Added Elementary OS icon (thanks @Unbinilium) * Updated ja localization (thanks @MMP0) * Updated fr localization (thanks @FRtranslator) * Changed the icon for "Serial" so it appears on iOS 14 and macOS 11 as well * Fixed custom icon not showing up for "legacy" configurations * Fixed an error trying to migrate "legacy" configuration when "Images" does not exist (#4266) * Fixed USB redirection (#4263) * (iOS) Fixed a toolbar issue where USB button overflowed on screen. * (iOS) Fixed resume button not appearing on < iOS 16 * (iOS) Attempt to close the download progress pop-up after download completes (#4261) * (iOS) "Open" popover refuses to show up again after swiping down (#4260) * (iOS) Hide "Add" text on iOS 14 settings * (iOS) Fixed crash on iOS 14 settings when attempting to use the picker (#4270) * (iOS) Fixed an issue on iOS 14 where picker selection was being reset * (iOS) Fixed an issue where the USB icon is stuck on busy after a device disconnects * (macOS) Fixed a crash trying to change shared directory for Apple VM (#4271) * (macOS) Wizard created invalid target configuration for virtualized targets (#4274) ## Changes (v4.0.0) * USB redirection support in terminal mode * Configuration file format changed, newly saved VMs will not be compatible with older versions of UTM * Newly imported disk images will be converted to QCOW2 automatically * Settings: new layout with support for multiple {Display, Serial, Network, Sound} devices (#3585) * Support multiple displays (#220) * Added Japanese localization (thanks @MMP0) * Support adding PTTY (macOS only), TCP client, and TCP server serial connections for QEMU machines (address should show up in the home screen) (#3546) * Support headless display (remove all displays and built-in serial ports in the settings) (#2280) * Support redirecting QEMU monitor and GDB stub to a serial port * Support zstd compression for QCOW2 images and use zstd as default for image compression (#4211) * Update ANGLE (GL backend) to latest git commit * Added French localization (thanks @FRtranslator) * Fixed microphone recording silence (#219) * Fixed a crash when attempting to delete a QEMU additional argument * Option in VM settings to use virtfs/9pfs for file sharing (#2184) * Option in VM settings to change VGA RAM size (#4034) * Option in VM settings to enable virtio-balloon driver (#4136) * Invert mouse scrolling is now a global setting rather than a per-vm configuration option * (iOS) Replaced hterm.js with SwiftTerm for terminal mode (#3473) * (iOS) Attach to JitStreamer (set IP address in Settings app and UTM will try to connect automatically on launch) (thanks @ktprograms) * (iOS) Automatically resize the display to fit the screen when the resolution changes if the resize toolbar option is used * (iOS) Reimplemented the USB and Drives menu with a better UI * (iOS) On iPadOS 16, show the menu bar when holding Cmd on the keyboard. On previous versions, an on-screen help will show supported commands * (iOS) Improved audio handling including: output when on silence, mixing with other apps, working when both recording and outputting (including with another app) (#3996) * (iOS) Added a global setting to always prefer the built-in microphone to a bluetooth microphone * (macOS) Fixed running from shortcut in Apple VMs (no longer need to re-import after each launch) * (macOS) Improved IPSW selection interface and support drag and drop (thanks @pointum) * (macOS) Fixed running unsigned builds * (macOS) Removed some deprecated global settings * (macOS) Fixed an error when trying to download an IPSW and the Caches directory does not exist (thanks @LostInCompilation) * (macOS) Fixed an issue where a VM could be started twice if the home screen's toolbar is used leading to data corruption (#4166) * (macOS 13+) Boot into recoveryOS (to disable SIP, etc) by right clicking on the VM and selecting "Run in recovery..." (#3526) * (macOS 13+) Option in VM settings to enable Rosetta for x86_64 emulation (#4100) * (macOS 13+) Option in VM settings to enable clipboard sharing (SPICE support needed on the guest) (#4121) * (macOS 13+) GUI display for Linux VMs (#4120) * (macOS 13+) Add removable drives, will show up as USB mass storage ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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(2) | 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][3] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://github.com/osy/Jitterbug

**Update [20/10/22]**: UTM SE build was removed and replaced with version v3.2.3 because of a bug that prevents any VM from starting up. If you have installed UTM SE v4.0.8, please re-install v3.2.3 or wait for the next update. ## Highlights * **Multiple display and headless display is now supported for QEMU machines.** You can configure 0 or more displays as well as 0 or more builtin terminal consoles. On macOS, a new window will be created for each display and builtin terminal. On iOS, you can create multiple windows (iPad) as well as plug in an external display or AirPlay (iPad or iPhone) and assign outputs to each window. * **Ventura updates to Virtualization.** macOS Ventura introduces new features that is now integrated into UTM. You can now create GUI Linux VMs with EFI boot. Directory sharing now works with macOS Ventura guests. Rosetta x86_64 emulation is supported for Linux VMs on Apple Silicon. Check out https://docs.getutm.app/guides/debian/ for an installation guide. Note that base M1 chip users may experience issues that will be addressed in a future update. * **VirtFS sharing for QEMU.** This alternative directory sharing backend is supported by Linux and can have better performance. Note that macOS UID are numbered differently than Linux so you may have to run `chown` in the guest. Check out https://docs.getutm.app/guest-support/linux/ for more details. * **Easier Windows 10/11 installation and Windows guest tools downloader.** You can now download and mount the Windows drivers and guest tools ISO image with a single click (macOS: disk icon in VM window, iOS: 3D touch context menu on home screen). Additionally, the ISO now include an "Autounattend.xml" which is recognized by the Windows 10/11 installer. When mounted to a second CD drive, the installer will install the correct drivers, bypass secure boot/TPM requirements, and launch the SPICE tools installer on first login. * (macOS) **Resize QEMU disk images.** In the drives settings page, you can now expand the size of the QCOW2 disk image. * (iOS) **QEMU Virtualization for M1 iPad.** With the release of [TrollStore](https://github.com/opa334/TrollStore), you can now enable Hypervisor on iOS. Note that only M1 hardware and kernel have support for Hypervisor. iOS 14.4.2-14.5.1 is supported only on M1 iPad Pro jailbroken with fugu14/unc0ver. iOS 14.0-15.5b4 is supported on any M1 iPad running TrollStore. * **New documentation site.** https://docs.getutm.app/ is the home of the official UTM documentation. * **New localization.** Thanks to various community members, UTM is now translated to: Chinese (Simplified), Chinese (Traditional), Finnish, French, German, Japanese, Korean, and Spanish (Latin America) ## Notes * **iOS 14 and macOS 11.3** are the new minimum supported systems. Please use UTM v3.x for support down to iOS 11 and macOS 11 * The configuration backend has been massively rewritten. **Please backup all VMs prior to updating as you will not be able to re-open VMs saved by UTM v4 on older versions of UTM if you decide to downgrade.** * Since v4.0.6, the order of generated devices has changed to always create network devices first. This is to address an issue on some distributions (such as Ubuntu) where adding a device (drive, display, etc) would require re-configurating the network because the device name changed. Unfortunately, this change will cause the configuration issue to occur once more on any existing VM that is susceptible to the network issue. On Ubuntu, this will require you to modify `/etc/netplan/00-installer-config.yaml` and change the adapter name from `enp0s9` (or whatever it is currently) to `enp0s1` (which reflects the new device ordering). Other Linux distributions may require a similar change. However, after updating the guest network configuration, you should no longer have issues with networking when making device changes to the VM. ## Changes (v4.0.8) * Translation: Updated Japanese (thanks @MMP0) * Translation: Updated French (thanks @FRtranslator and @alexis-martel) * Translation: Added German (thanks @conath) * (macOS) Disable resize button in GUI Apple VM window * (macOS) Reverted some SwiftUI issue workarounds that are no longer present in Ventura RC ## Changes (v4.0.7) * Fixed renamed VM not appearing on next launch (#4469) * Fixed TCP server not working (#4479) * Fixed random network issues caused by invalid MAC address generation (you must re-generate MAC to apply the change if your VM created in UTM v4 does not have working network) (#4477) * Fixed a crash when trying to boot Kali Linux with terminal enabled * Fixed hypervisor on iOS 14.6-14.8 * Added new setting for serial device in TCP server mode to listen on remote/local interfaces (#4483) * Fixed URL automation sending text to terminal * Translation: Updated Japanese (thanks @MMP0) * Translation: Updated French (thanks @FRtranslator) * Wizard: Link to new documentation site (#4443, #4445) * (iOS) Fixed disponible run option not appearing * (macOS) Fixed settings getting stuck at information page (#4465) * (macOS) Updated display menu option to match title bar when multiple displays are used (#4484) * (macOS) Fixed no mouse/keyboard on Intel Apple Virtualization (#4409) * (macOS) Fixed no audio input device on Linux running on Apple Virtualization (#4409) * (macOS) Fixed auto-quit when all windows are closed happening when headless VM is still running ## Changes (v4.0.6) * Fixed an issue in argument generation where PS/2 input was forced even when USB was enabled (#4424) * Validate settings on save before closing the settings dialog * Network devices are now created first before all other devices. Note this means that networking will be broken on some existing VMs and must be re-configured! (See notes above) * Fixed a deadlock issue when saving settings * Fixed an error when saving a VM with an external drive selected * Translation: Updated Japanese (thanks @MMP0) * Translation: Updated French (thanks @FRtranslator) * Wizard: The Windows guest tools auto-installer currently only works on Windows 10 and above. A new option is added in the wizard to make this explicit. (#4440) * Wizard: Use VirtFS sharing by default when Linux is selected * (iOS) Default to emulated network instead of failing when importing a VM created on macOS * (macOS) Fixed an issue where opening a new display window from a serial window did not work * (macOS) Fixed logic on macOS 11 where serial window was not created * (macOS) Fixed a crash on macOS 11 when saving settings while the QEMU tab is selected * (macOS 13) Support clipboard sharing on Linux with Apple Virtualization when `spice-vdagent` is installed * (macOS) Fixed an issue changing the boot OS where the incorrect image type is prompted * (macOS) Perform settings validation when launching an Apple Virtualization VM to ensure selected features are available * (macOS 12+) Set a machine identifier when launching an Apple Virtualization VM * (macOS 13) Emulate trackpad on macOS guests with Apple Virtualization * (macOS) Fixed an issue when a newly created VM will not launch on macOS 11 ## Changes (v4.0.5) * Fixed moving an existing VM with Hypervisor enabled to a device on a different architecture. The VM will fallback to TCG and the option to disable hypervisor in settings is allowed. (#4407) * Translation: Updated Japanese (thanks @MMP0) * (iOS) Fixed an issue that prevented external keyboards from working (#4399) * (iOS) Detect Hypervisor support on jailbroken devices so the option is not inadvertently enabled on non-supported devices * (iOS) Support Hypervisor on M1 iPad running jailbroken iOS 14.5 ## Changes (v4.0.4) * Fixed in issue generating configuration for IDE drives leading to PPC not booting and I/O errors on PC (#4372, #4376, others) * Moved the SPICE tools download directory to "GuestSupportTools" under "Application Support" (previously it was just under "Application Support") * Fixed creating a VM with illegal path characters in the name (#4385) * Translation: Updated Japanese (thanks @MMP0) * Translation: Updated French (thanks @FRtranslator) * Wizard: No longer tries to download the Windows guest tools when selecting a non-Windows OS * (iOS) Enable build with Hypervisor.framework (support limited to M1 iPad) * (iOS) Fixed a crash when switching display in a window * (iOS) On jailbroken devices, the memory limit will automatically be increased to the maximum, preventing the Jetsam system from terminating UTM for memory usage * (iOS) Fixed a regression which caused the home indicator to not be hidden (#4390) * (iOS) Fixed a regression which caused the cursor to not be captured (#4390) * (iOS) When switching display, notification handlers are properly cleaned up (example: cursor capture and console on screen keyboard events) * (iOS) Show the device cursor when VM is paused * (iOS) Fixed a regression where external keyboard events are not captured * (iOS) Fixed an error where extraneous stale VM entries show up after the container name changes (#4392) * (iOS) Fixed a crash on iOS 14 when opening a terminal view due to SwiftTerm handling the colour configuration * (macOS) Fixed a layout issue of the compress/resize buttons * (macOS) Forgot to actually enable compression for the drive setting button (#4377) * (macOS) Fixed some settings layout issue on < macOS 13 (#4374) ## Changes (v4.0.3) * Fixed an issue where changing external drive/shared directory for a QEMU VM -> exit UTM -> reopen UTM and start the VM results in the drive/share not being restored * Disable changing a VirtFS share from the home window (this is not an supported operation) * Better detection of UUID collision which addresses an issue where VMs with the same UUID do not show up on the home screen and other VMs show up as duplicates and clicking on any of them results in a freeze * Fixed floppy drive argument not being correctly generated (#4362) * Fixed an issue where ejecting an external drive or shared directory does not persist * Fixed a memory issue when stopping or closing VMs causing UTM to crash * Fixed a regression where an access error occurs after moving a VM * Added the ability to download the Windows SPICE tools and drivers automatically (#4364) * Added support for more than 2 IDE drives in PC emulation * Restored the setting to turn off blinking cursor (#4296) * Translation: Updated Japanese (thanks @MMP0) * Wizard: Reworked some of the UI, text, and file selection * Wizard: Add option to auto download and mount the SPICE tools to a second CD drive * Wizard: Fixed an issue where the selected boot image and shared directory was not saved on the new VM * Wizard: Recommend UUP built ISO over the VHDX by default * Wizard: New "confused user" check will catch trying to mount an "amd64" ISO on an "arm64" guest or vice versa * (iOS 16) Use the new NavigationSplitView for a slightly polished look * (iOS 16) Fixed an issue where the bottom toolbar does not show up (#4325) * (iOS) Fixed an issue where the file importer was not opening (#4365) * (iOS 14) Fixed an issue in the settings screen where multiple drives were occupying a single cell * (iOS 14) Fixed an issue where UTM may crash when adding a drive or hardware * (macOS) Added the ability to re-open closed windows for a given VM (#4351) * (macOS) Fixed an issue where restarting a VM results in duplicate windows (#4367) * (macOS) Save the size of terminal windows (#4296) * (macOS) Add resize QCOW2 image feature (thanks @stewartsmith) ## Changes (v4.0.2) * Removed "view.plist" for host-specific configuration settings (i.e. bookmarks to removable drives and window options) and replaced it with a new "registry" that is stored outside of the .utm bundle. Old "view.plist" settings and bookmarks will be migrated to the registry on first launch and the file will be deleted from the .utm bundle. For Apple VMs, the bookmarks will no longer be stored in config.plist and the settings will be migrated to the registry as well. * VirtFS no longer requires SPICE to be enabled (thanks @tie) * Fixed an issue with PPC VMs not showing 256 colours correctly (#4277) * Fixed incorrect parsing of CPU flags (#4282) * Do not save screenshots when running in disposable mode * Translation: Added Spanish (Latin America) (thanks @JezerM) * Translation: Added Finnish (thanks @marcusziade) * Translation: Updated Japanese (thanks @MMP0) * Translation: Updated Chinese (Simplified) (thanks @ty-yqs) * Translation: Updated French (thanks @FRtranslator) * (iOS) Per-display window settings (zoom, position, keyboard visibility, etc) will be stored in the new registry * (iOS) Prefer JitStreamer over AltJit when both are available (thanks @ktprograms) * (macOS) Fixed saving removable drives and shared directories for Apple VMs * (macOS) Fixed missing audio entitlements (#4342) * (macOS) Fixed QEMULauncher process not terminating when a VM is force quit * (macOS) Fixed issue selecting text in SwiftTerm (#4297) ## Changes (v4.0.1) * Fixed an issue where an UEFI BIOS error was reported when the target does not use UEFI (#4265) * Added Elementary OS icon (thanks @Unbinilium) * Updated ja localization (thanks @MMP0) * Updated fr localization (thanks @FRtranslator) * Changed the icon for "Serial" so it appears on iOS 14 and macOS 11 as well * Fixed custom icon not showing up for "legacy" configurations * Fixed an error trying to migrate "legacy" configuration when "Images" does not exist (#4266) * Fixed USB redirection (#4263) * (iOS) Fixed a toolbar issue where USB button overflowed on screen. * (iOS) Fixed resume button not appearing on < iOS 16 * (iOS) Attempt to close the download progress pop-up after download completes (#4261) * (iOS) "Open" popover refuses to show up again after swiping down (#4260) * (iOS) Hide "Add" text on iOS 14 settings * (iOS) Fixed crash on iOS 14 settings when attempting to use the picker (#4270) * (iOS) Fixed an issue on iOS 14 where picker selection was being reset * (iOS) Fixed an issue where the USB icon is stuck on busy after a device disconnects * (macOS) Fixed a crash trying to change shared directory for Apple VM (#4271) * (macOS) Wizard created invalid target configuration for virtualized targets (#4274) ## Changes (v4.0.0) * USB redirection support in terminal mode * Configuration file format changed, newly saved VMs will not be compatible with older versions of UTM * Newly imported disk images will be converted to QCOW2 automatically * Settings: new layout with support for multiple {Display, Serial, Network, Sound} devices (#3585) * Support multiple displays (#220) * Added Japanese localization (thanks @MMP0) * Support adding PTTY (macOS only), TCP client, and TCP server serial connections for QEMU machines (address should show up in the home screen) (#3546) * Support headless display (remove all displays and built-in serial ports in the settings) (#2280) * Support redirecting QEMU monitor and GDB stub to a serial port * Support zstd compression for QCOW2 images and use zstd as default for image compression (#4211) * Update ANGLE (GL backend) to latest git commit * Added French localization (thanks @FRtranslator) * Fixed microphone recording silence (#219) * Fixed a crash when attempting to delete a QEMU additional argument * Option in VM settings to use virtfs/9pfs for file sharing (#2184) * Option in VM settings to change VGA RAM size (#4034) * Option in VM settings to enable virtio-balloon driver (#4136) * Invert mouse scrolling is now a global setting rather than a per-vm configuration option * (iOS) Replaced hterm.js with SwiftTerm for terminal mode (#3473) * (iOS) Attach to JitStreamer (set IP address in Settings app and UTM will try to connect automatically on launch) (thanks @ktprograms) * (iOS) Automatically resize the display to fit the screen when the resolution changes if the resize toolbar option is used * (iOS) Reimplemented the USB and Drives menu with a better UI * (iOS) On iPadOS 16, show the menu bar when holding Cmd on the keyboard. On previous versions, an on-screen help will show supported commands * (iOS) Improved audio handling including: output when on silence, mixing with other apps, working when both recording and outputting (including with another app) (#3996) * (iOS) Added a global setting to always prefer the built-in microphone to a bluetooth microphone * (macOS) Fixed running from shortcut in Apple VMs (no longer need to re-import after each launch) * (macOS) Improved IPSW selection interface and support drag and drop (thanks @pointum) * (macOS) Fixed running unsigned builds * (macOS) Removed some deprecated global settings * (macOS) Fixed an error when trying to download an IPSW and the Caches directory does not exist (thanks @LostInCompilation) * (macOS) Fixed an issue where a VM could be started twice if the home screen's toolbar is used leading to data corruption (#4166) * (macOS 13+) Boot into recoveryOS (to disable SIP, etc) by right clicking on the VM and selecting "Run in recovery..." (#3526) * (macOS 13+) Option in VM settings to enable Rosetta for x86_64 emulation (#4100) * (macOS 13+) Option in VM settings to enable clipboard sharing (SPICE support needed on the guest) (#4121) * (macOS 13+) GUI display for Linux VMs (#4120) * (macOS 13+) Add removable drives, will show up as USB mass storage ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ## Installation * [iOS](https://docs.getutm.app/installation/ios/) * [macOS](https://docs.getutm.app/installation/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(2) | 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][3] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://github.com/osy/Jitterbug

## Highlights * **Multiple display and headless display is now supported for QEMU machines.** You can configure 0 or more displays as well as 0 or more builtin terminal consoles. On macOS, a new window will be created for each display and builtin terminal. On iOS, you can create multiple windows (iPad) as well as plug in an external display or AirPlay (iPad or iPhone) and assign outputs to each window. * **Ventura updates to Virtualization.** macOS Ventura introduces new features to Virtualization.framework that is now integrated into UTM. You can now create GUI Linux VMs with EFI boot. Clipboard sharing and directory sharing now works with macOS Ventura guests. Rosetta x86_64 emulation is supported for Linux VMs on Apple Silicon. * **VirtFS sharing for QEMU.** This can be enabled in the VM settings under Sharing. You can mount the tag "share" in the VM. Note that macOS UID are numbered differently than Linux so you may need to set up your guest to have permission to access the shared directory. * **Easier Windows 10/11 installation and Windows guest tools downloader.** You can now download and mount the Windows drivers and guest tools ISO image with a single click (macOS: disk icon in VM window, iOS: 3D touch context menu on home screen). Additionally, the ISO now include an "Autounattend.xml" which is recognized by the Windows 10/11 installer. When mounted to a second CD drive, the installer will install the correct drivers, bypass secure boot/TPM requirements, and launch the SPICE tools installer on first login. * (macOS) **Resize QEMU disk images.** In the drives settings page, you can now expand the size of the QCOW2 disk image. * (iOS) **QEMU Virtualization for M1 iPad.** With the release of [TrollStore](https://github.com/opa334/TrollStore), you can now enable Hypervisor on iOS. Note that only M1 hardware and kernel have support for Hypervisor. iOS 14.4.2-14.5.1 is supported only on M1 iPad Pro jailbroken with fugu14/unc0ver. iOS 14.0-15.5b4 is supported on any M1 iPad running TrollStore. * **New documentation site.** https://docs.getutm.app/ is the home of the official UTM documentation. ## Notes * **iOS 14 and macOS 11.3** are the new minimum supported systems. Please use UTM v3.x for support down to iOS 11 and macOS 11 * The configuration backend has been massively rewritten. **Please backup all VMs prior to updating as you will not be able to re-open VMs saved by UTM v4 on older versions of UTM if you decide to downgrade.** * Since v4.0.6, the order of generated devices has changed to always create network devices first. This is to address an issue on some distributions (such as Ubuntu) where adding a device (drive, display, etc) would require re-configurating the network because the device name changed. Unfortunately, this change will cause the configuration issue to occur once more on any existing VM that is susceptible to the network issue. On Ubuntu, this will require you to modify `/etc/netplan/00-installer-config.yaml` and change the adapter name from `enp0s9` (or whatever it is currently) to `enp0s1` (which reflects the new device ordering). Other Linux distributions may require a similar change. However, after updating the guest network configuration, you should no longer have issues with networking when making device changes to the VM. ## Changes (v4.0.7) * Fixed renamed VM not appearing on next launch (#4469) * Fixed TCP server not working (#4479) * Fixed random network issues caused by invalid MAC address generation (you must re-generate MAC to apply the change if your VM created in UTM v4 does not have working network) (#4477) * Fixed a crash when trying to boot Kali Linux with terminal enabled * Fixed hypervisor on iOS 14.6-14.8 * Added new setting for serial device in TCP server mode to listen on remote/local interfaces (#4483) * Fixed URL automation sending text to terminal * Translation: Updated Japanese (thanks @MMP0) * Translation: Updated French (thanks @FRtranslator) * Wizard: Link to new documentation site (#4443, #4445) * (iOS) Fixed disponible run option not appearing * (macOS) Fixed settings getting stuck at information page (#4465) * (macOS) Updated display menu option to match title bar when multiple displays are used (#4484) * (macOS) Fixed no mouse/keyboard on Intel Apple Virtualization (#4409) * (macOS) Fixed no audio input device on Linux running on Apple Virtualization (#4409) * (macOS) Fixed auto-quit when all windows are closed happening when headless VM is still running ## Changes (v4.0.6) * Fixed an issue in argument generation where PS/2 input was forced even when USB was enabled (#4424) * Validate settings on save before closing the settings dialog * Network devices are now created first before all other devices. Note this means that networking will be broken on some existing VMs and must be re-configured! (See notes above) * Fixed a deadlock issue when saving settings * Fixed an error when saving a VM with an external drive selected * Translation: Updated Japanese (thanks @MMP0) * Translation: Updated French (thanks @FRtranslator) * Wizard: The Windows guest tools auto-installer currently only works on Windows 10 and above. A new option is added in the wizard to make this explicit. (#4440) * Wizard: Use VirtFS sharing by default when Linux is selected * (iOS) Default to emulated network instead of failing when importing a VM created on macOS * (macOS) Fixed an issue where opening a new display window from a serial window did not work * (macOS) Fixed logic on macOS 11 where serial window was not created * (macOS) Fixed a crash on macOS 11 when saving settings while the QEMU tab is selected * (macOS 13) Support clipboard sharing on Linux with Apple Virtualization when `spice-vdagent` is installed * (macOS) Fixed an issue changing the boot OS where the incorrect image type is prompted * (macOS) Perform settings validation when launching an Apple Virtualization VM to ensure selected features are available * (macOS 12+) Set a machine identifier when launching an Apple Virtualization VM * (macOS 13) Emulate trackpad on macOS guests with Apple Virtualization * (macOS) Fixed an issue when a newly created VM will not launch on macOS 11 ## Changes (v4.0.5) * Fixed moving an existing VM with Hypervisor enabled to a device on a different architecture. The VM will fallback to TCG and the option to disable hypervisor in settings is allowed. (#4407) * Translation: Updated Japanese (thanks @MMP0) * (iOS) Fixed an issue that prevented external keyboards from working (#4399) * (iOS) Detect Hypervisor support on jailbroken devices so the option is not inadvertently enabled on non-supported devices * (iOS) Support Hypervisor on M1 iPad running jailbroken iOS 14.5 ## Changes (v4.0.4) * Fixed in issue generating configuration for IDE drives leading to PPC not booting and I/O errors on PC (#4372, #4376, others) * Moved the SPICE tools download directory to "GuestSupportTools" under "Application Support" (previously it was just under "Application Support") * Fixed creating a VM with illegal path characters in the name (#4385) * Translation: Updated Japanese (thanks @MMP0) * Translation: Updated French (thanks @FRtranslator) * Wizard: No longer tries to download the Windows guest tools when selecting a non-Windows OS * (iOS) Enable build with Hypervisor.framework (support limited to M1 iPad) * (iOS) Fixed a crash when switching display in a window * (iOS) On jailbroken devices, the memory limit will automatically be increased to the maximum, preventing the Jetsam system from terminating UTM for memory usage * (iOS) Fixed a regression which caused the home indicator to not be hidden (#4390) * (iOS) Fixed a regression which caused the cursor to not be captured (#4390) * (iOS) When switching display, notification handlers are properly cleaned up (example: cursor capture and console on screen keyboard events) * (iOS) Show the device cursor when VM is paused * (iOS) Fixed a regression where external keyboard events are not captured * (iOS) Fixed an error where extraneous stale VM entries show up after the container name changes (#4392) * (iOS) Fixed a crash on iOS 14 when opening a terminal view due to SwiftTerm handling the colour configuration * (macOS) Fixed a layout issue of the compress/resize buttons * (macOS) Forgot to actually enable compression for the drive setting button (#4377) * (macOS) Fixed some settings layout issue on < macOS 13 (#4374) ## Changes (v4.0.3) * Fixed an issue where changing external drive/shared directory for a QEMU VM -> exit UTM -> reopen UTM and start the VM results in the drive/share not being restored * Disable changing a VirtFS share from the home window (this is not an supported operation) * Better detection of UUID collision which addresses an issue where VMs with the same UUID do not show up on the home screen and other VMs show up as duplicates and clicking on any of them results in a freeze * Fixed floppy drive argument not being correctly generated (#4362) * Fixed an issue where ejecting an external drive or shared directory does not persist * Fixed a memory issue when stopping or closing VMs causing UTM to crash * Fixed a regression where an access error occurs after moving a VM * Added the ability to download the Windows SPICE tools and drivers automatically (#4364) * Added support for more than 2 IDE drives in PC emulation * Restored the setting to turn off blinking cursor (#4296) * Translation: Updated Japanese (thanks @MMP0) * Wizard: Reworked some of the UI, text, and file selection * Wizard: Add option to auto download and mount the SPICE tools to a second CD drive * Wizard: Fixed an issue where the selected boot image and shared directory was not saved on the new VM * Wizard: Recommend UUP built ISO over the VHDX by default * Wizard: New "confused user" check will catch trying to mount an "amd64" ISO on an "arm64" guest or vice versa * (iOS 16) Use the new NavigationSplitView for a slightly polished look * (iOS 16) Fixed an issue where the bottom toolbar does not show up (#4325) * (iOS) Fixed an issue where the file importer was not opening (#4365) * (iOS 14) Fixed an issue in the settings screen where multiple drives were occupying a single cell * (iOS 14) Fixed an issue where UTM may crash when adding a drive or hardware * (macOS) Added the ability to re-open closed windows for a given VM (#4351) * (macOS) Fixed an issue where restarting a VM results in duplicate windows (#4367) * (macOS) Save the size of terminal windows (#4296) * (macOS) Add resize QCOW2 image feature (thanks @stewartsmith) ## Changes (v4.0.2) * Removed "view.plist" for host-specific configuration settings (i.e. bookmarks to removable drives and window options) and replaced it with a new "registry" that is stored outside of the .utm bundle. Old "view.plist" settings and bookmarks will be migrated to the registry on first launch and the file will be deleted from the .utm bundle. For Apple VMs, the bookmarks will no longer be stored in config.plist and the settings will be migrated to the registry as well. * VirtFS no longer requires SPICE to be enabled (thanks @tie) * Fixed an issue with PPC VMs not showing 256 colours correctly (#4277) * Fixed incorrect parsing of CPU flags (#4282) * Do not save screenshots when running in disposable mode * Translation: Added Spanish (Latin America) (thanks @JezerM) * Translation: Added Finnish (thanks @marcusziade) * Translation: Updated Japanese (thanks @MMP0) * Translation: Updated Chinese (Simplified) (thanks @ty-yqs) * Translation: Updated French (thanks @FRtranslator) * (iOS) Per-display window settings (zoom, position, keyboard visibility, etc) will be stored in the new registry * (iOS) Prefer JitStreamer over AltJit when both are available (thanks @ktprograms) * (macOS) Fixed saving removable drives and shared directories for Apple VMs * (macOS) Fixed missing audio entitlements (#4342) * (macOS) Fixed QEMULauncher process not terminating when a VM is force quit * (macOS) Fixed issue selecting text in SwiftTerm (#4297) ## Changes (v4.0.1) * Fixed an issue where an UEFI BIOS error was reported when the target does not use UEFI (#4265) * Added Elementary OS icon (thanks @Unbinilium) * Updated ja localization (thanks @MMP0) * Updated fr localization (thanks @FRtranslator) * Changed the icon for "Serial" so it appears on iOS 14 and macOS 11 as well * Fixed custom icon not showing up for "legacy" configurations * Fixed an error trying to migrate "legacy" configuration when "Images" does not exist (#4266) * Fixed USB redirection (#4263) * (iOS) Fixed a toolbar issue where USB button overflowed on screen. * (iOS) Fixed resume button not appearing on < iOS 16 * (iOS) Attempt to close the download progress pop-up after download completes (#4261) * (iOS) "Open" popover refuses to show up again after swiping down (#4260) * (iOS) Hide "Add" text on iOS 14 settings * (iOS) Fixed crash on iOS 14 settings when attempting to use the picker (#4270) * (iOS) Fixed an issue on iOS 14 where picker selection was being reset * (iOS) Fixed an issue where the USB icon is stuck on busy after a device disconnects * (macOS) Fixed a crash trying to change shared directory for Apple VM (#4271) * (macOS) Wizard created invalid target configuration for virtualized targets (#4274) ## Changes (v4.0.0) * USB redirection support in terminal mode * Configuration file format changed, newly saved VMs will not be compatible with older versions of UTM * Newly imported disk images will be converted to QCOW2 automatically * Settings: new layout with support for multiple {Display, Serial, Network, Sound} devices (#3585) * Support multiple displays (#220) * Added Japanese localization (thanks @MMP0) * Support adding PTTY (macOS only), TCP client, and TCP server serial connections for QEMU machines (address should show up in the home screen) (#3546) * Support headless display (remove all displays and built-in serial ports in the settings) (#2280) * Support redirecting QEMU monitor and GDB stub to a serial port * Support zstd compression for QCOW2 images and use zstd as default for image compression (#4211) * Update ANGLE (GL backend) to latest git commit * Added French localization (thanks @FRtranslator) * Fixed microphone recording silence (#219) * Fixed a crash when attempting to delete a QEMU additional argument * Option in VM settings to use virtfs/9pfs for file sharing (#2184) * Option in VM settings to change VGA RAM size (#4034) * Option in VM settings to enable virtio-balloon driver (#4136) * Invert mouse scrolling is now a global setting rather than a per-vm configuration option * (iOS) Replaced hterm.js with SwiftTerm for terminal mode (#3473) * (iOS) Attach to JitStreamer (set IP address in Settings app and UTM will try to connect automatically on launch) (thanks @ktprograms) * (iOS) Automatically resize the display to fit the screen when the resolution changes if the resize toolbar option is used * (iOS) Reimplemented the USB and Drives menu with a better UI * (iOS) On iPadOS 16, show the menu bar when holding Cmd on the keyboard. On previous versions, an on-screen help will show supported commands * (iOS) Improved audio handling including: output when on silence, mixing with other apps, working when both recording and outputting (including with another app) (#3996) * (iOS) Added a global setting to always prefer the built-in microphone to a bluetooth microphone * (macOS) Fixed running from shortcut in Apple VMs (no longer need to re-import after each launch) * (macOS) Improved IPSW selection interface and support drag and drop (thanks @pointum) * (macOS) Fixed running unsigned builds * (macOS) Removed some deprecated global settings * (macOS) Fixed an error when trying to download an IPSW and the Caches directory does not exist (thanks @LostInCompilation) * (macOS) Fixed an issue where a VM could be started twice if the home screen's toolbar is used leading to data corruption (#4166) * (macOS 13+) Boot into recoveryOS (to disable SIP, etc) by right clicking on the VM and selecting "Run in recovery..." (#3526) * (macOS 13+) Option in VM settings to enable Rosetta for x86_64 emulation (#4100) * (macOS 13+) Option in VM settings to enable clipboard sharing (SPICE support needed on the guest) (#4121) * (macOS 13+) GUI display for Linux VMs (#4120) * (macOS 13+) Add removable drives, will show up as USB mass storage ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ## Installation **iOS**: Visit [https://getutm.app/install/][1] for the most up to date installation instructions. **macOS**: Download "UTM.dmg" below and copy the contents to your `/Applications` directory. | 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(2) | 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][3] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://github.com/osy/Jitterbug

**Remember to back up your VMs before running a beta release of UTM!** ## Highlights * **Multiple display and headless display is now supported for QEMU machines.** You can configure 0 or more displays as well as 0 or more builtin terminal consoles. On macOS, a new window will be created for each display and builtin terminal. On iOS, you can create multiple windows (iPad) as well as plug in an external display or AirPlay (iPad or iPhone) and assign outputs to each window. * **Ventura updates to Virtualization.** macOS Ventura introduces new features to Virtualization.framework that is now integrated into UTM. You can now create GUI Linux VMs with EFI boot. Clipboard sharing and directory sharing now works with macOS Ventura guests. Rosetta x86_64 emulation is supported for Linux VMs on Apple Silicon. * **VirtFS sharing for QEMU.** This can be enabled in the VM settings under Sharing. You can mount the tag "share" in the VM. Note that macOS UID are numbered differently than Linux so you may need to set up your guest to have permission to access the shared directory. * **Easier Windows 10/11 installation and Windows guest tools downloader.** You can now download and mount the Windows drivers and guest tools ISO image with a single click (macOS: disk icon in VM window, iOS: 3D touch context menu on home screen). Additionally, the ISO now include an "Autounattend.xml" which is recognized by the Windows 10/11 installer. When mounted to a second CD drive, the installer will install the correct drivers, bypass secure boot/TPM requirements, and launch the SPICE tools installer on first login. * (macOS) **Resize QEMU disk images.** In the drives settings page, you can now expand the size of the QCOW2 disk image. * (iOS) **QEMU Virtualization for M1 iPad.** With the release of [TrollStore](https://github.com/opa334/TrollStore), you can now enable Hypervisor on iOS. Note that only M1 hardware and kernel have support for Hypervisor. iOS 14.4.2-14.5.1 is supported only on M1 iPad Pro jailbroken with fugu14/unc0ver. iOS 15.0-15.1.1 is supported on any M1 iPad running TrollStore. ## Notes * **iOS 14 and macOS 11.3** are the new minimum supported systems. Please use UTM v3.x for support down to iOS 11 and macOS 11 * The configuration backend has been massively rewritten. **Please backup all VMs prior to updating as you will not be able to re-open VMs saved by UTM v4 on older versions of UTM if you decide to downgrade.** * Since v4.0.6, the order of generated devices has changed to always create network devices first. This is to address an issue on some distributions (such as Ubuntu) where adding a device (drive, display, etc) would require re-configurating the network because the device name changed. Unfortunately, this change will cause the configuration issue to occur once more on any existing VM that is susceptible to the network issue. On Ubuntu, this will require you to modify `/etc/netplan/00-installer-config.yaml` and change the adapter name from `enp0s9` (or whatever it is currently) to `enp0s1` (which reflects the new device ordering). Other Linux distributions may require a similar change. However, after updating the guest network configuration, you should no longer have issues with networking when making device changes to the VM. ## Changes (v4.0.6) * Fixed an issue in argument generation where PS/2 input was forced even when USB was enabled (#4424) * Validate settings on save before closing the settings dialog * Network devices are now created first before all other devices. Note this means that networking will be broken on some existing VMs and must be re-configured! (See notes above) * Fixed a deadlock issue when saving settings * Fixed an error when saving a VM with an external drive selected * Translation: Updated Japanese (thanks @MMP0) * Translation: Updated French (thanks @FRtranslator) * Wizard: The Windows guest tools auto-installer currently only works on Windows 10 and above. A new option is added in the wizard to make this explicit. (#4440) * Wizard: Use VirtFS sharing by default when Linux is selected * (iOS) Default to emulated network instead of failing when importing a VM created on macOS * (macOS) Fixed an issue where opening a new display window from a serial window did not work * (macOS) Fixed logic on macOS 11 where serial window was not created * (macOS) Fixed a crash on macOS 11 when saving settings while the QEMU tab is selected * (macOS 13) Support clipboard sharing on Linux with Apple Virtualization when `spice-vdagent` is installed * (macOS) Fixed an issue changing the boot OS where the incorrect image type is prompted * (macOS) Perform settings validation when launching an Apple Virtualization VM to ensure selected features are available * (macOS 12+) Set a machine identifier when launching an Apple Virtualization VM * (macOS 13) Emulate trackpad on macOS guests with Apple Virtualization * (macOS) Fixed an issue when a newly created VM will not launch on macOS 11 ## Changes (v4.0.5) * Fixed moving an existing VM with Hypervisor enabled to a device on a different architecture. The VM will fallback to TCG and the option to disable hypervisor in settings is allowed. (#4407) * Translation: Updated Japanese (thanks @MMP0) * (iOS) Fixed an issue that prevented external keyboards from working (#4399) * (iOS) Detect Hypervisor support on jailbroken devices so the option is not inadvertently enabled on non-supported devices * (iOS) Support Hypervisor on M1 iPad running jailbroken iOS 14.5 ## Changes (v4.0.4) * Fixed in issue generating configuration for IDE drives leading to PPC not booting and I/O errors on PC (#4372, #4376, others) * Moved the SPICE tools download directory to "GuestSupportTools" under "Application Support" (previously it was just under "Application Support") * Fixed creating a VM with illegal path characters in the name (#4385) * Translation: Updated Japanese (thanks @MMP0) * Translation: Updated French (thanks @FRtranslator) * Wizard: No longer tries to download the Windows guest tools when selecting a non-Windows OS * (iOS) Enable build with Hypervisor.framework (support limited to M1 iPad) * (iOS) Fixed a crash when switching display in a window * (iOS) On jailbroken devices, the memory limit will automatically be increased to the maximum, preventing the Jetsam system from terminating UTM for memory usage * (iOS) Fixed a regression which caused the home indicator to not be hidden (#4390) * (iOS) Fixed a regression which caused the cursor to not be captured (#4390) * (iOS) When switching display, notification handlers are properly cleaned up (example: cursor capture and console on screen keyboard events) * (iOS) Show the device cursor when VM is paused * (iOS) Fixed a regression where external keyboard events are not captured * (iOS) Fixed an error where extraneous stale VM entries show up after the container name changes (#4392) * (iOS) Fixed a crash on iOS 14 when opening a terminal view due to SwiftTerm handling the colour configuration * (macOS) Fixed a layout issue of the compress/resize buttons * (macOS) Forgot to actually enable compression for the drive setting button (#4377) * (macOS) Fixed some settings layout issue on < macOS 13 (#4374) ## Changes (v4.0.3) * Fixed an issue where changing external drive/shared directory for a QEMU VM -> exit UTM -> reopen UTM and start the VM results in the drive/share not being restored * Disable changing a VirtFS share from the home window (this is not an supported operation) * Better detection of UUID collision which addresses an issue where VMs with the same UUID do not show up on the home screen and other VMs show up as duplicates and clicking on any of them results in a freeze * Fixed floppy drive argument not being correctly generated (#4362) * Fixed an issue where ejecting an external drive or shared directory does not persist * Fixed a memory issue when stopping or closing VMs causing UTM to crash * Fixed a regression where an access error occurs after moving a VM * Added the ability to download the Windows SPICE tools and drivers automatically (#4364) * Added support for more than 2 IDE drives in PC emulation * Restored the setting to turn off blinking cursor (#4296) * Translation: Updated Japanese (thanks @MMP0) * Wizard: Reworked some of the UI, text, and file selection * Wizard: Add option to auto download and mount the SPICE tools to a second CD drive * Wizard: Fixed an issue where the selected boot image and shared directory was not saved on the new VM * Wizard: Recommend UUP built ISO over the VHDX by default * Wizard: New "confused user" check will catch trying to mount an "amd64" ISO on an "arm64" guest or vice versa * (iOS 16) Use the new NavigationSplitView for a slightly polished look * (iOS 16) Fixed an issue where the bottom toolbar does not show up (#4325) * (iOS) Fixed an issue where the file importer was not opening (#4365) * (iOS 14) Fixed an issue in the settings screen where multiple drives were occupying a single cell * (iOS 14) Fixed an issue where UTM may crash when adding a drive or hardware * (macOS) Added the ability to re-open closed windows for a given VM (#4351) * (macOS) Fixed an issue where restarting a VM results in duplicate windows (#4367) * (macOS) Save the size of terminal windows (#4296) * (macOS) Add resize QCOW2 image feature (thanks @stewartsmith) ## Changes (v4.0.2) * Removed "view.plist" for host-specific configuration settings (i.e. bookmarks to removable drives and window options) and replaced it with a new "registry" that is stored outside of the .utm bundle. Old "view.plist" settings and bookmarks will be migrated to the registry on first launch and the file will be deleted from the .utm bundle. For Apple VMs, the bookmarks will no longer be stored in config.plist and the settings will be migrated to the registry as well. * VirtFS no longer requires SPICE to be enabled (thanks @tie) * Fixed an issue with PPC VMs not showing 256 colours correctly (#4277) * Fixed incorrect parsing of CPU flags (#4282) * Do not save screenshots when running in disposable mode * Translation: Added Spanish (Latin America) (thanks @JezerM) * Translation: Added Finnish (thanks @marcusziade) * Translation: Updated Japanese (thanks @MMP0) * Translation: Updated Chinese (Simplified) (thanks @ty-yqs) * Translation: Updated French (thanks @FRtranslator) * (iOS) Per-display window settings (zoom, position, keyboard visibility, etc) will be stored in the new registry * (iOS) Prefer JitStreamer over AltJit when both are available (thanks @ktprograms) * (macOS) Fixed saving removable drives and shared directories for Apple VMs * (macOS) Fixed missing audio entitlements (#4342) * (macOS) Fixed QEMULauncher process not terminating when a VM is force quit * (macOS) Fixed issue selecting text in SwiftTerm (#4297) ## Changes (v4.0.1) * Fixed an issue where an UEFI BIOS error was reported when the target does not use UEFI (#4265) * Added Elementary OS icon (thanks @Unbinilium) * Updated ja localization (thanks @MMP0) * Updated fr localization (thanks @FRtranslator) * Changed the icon for "Serial" so it appears on iOS 14 and macOS 11 as well * Fixed custom icon not showing up for "legacy" configurations * Fixed an error trying to migrate "legacy" configuration when "Images" does not exist (#4266) * Fixed USB redirection (#4263) * (iOS) Fixed a toolbar issue where USB button overflowed on screen. * (iOS) Fixed resume button not appearing on < iOS 16 * (iOS) Attempt to close the download progress pop-up after download completes (#4261) * (iOS) "Open" popover refuses to show up again after swiping down (#4260) * (iOS) Hide "Add" text on iOS 14 settings * (iOS) Fixed crash on iOS 14 settings when attempting to use the picker (#4270) * (iOS) Fixed an issue on iOS 14 where picker selection was being reset * (iOS) Fixed an issue where the USB icon is stuck on busy after a device disconnects * (macOS) Fixed a crash trying to change shared directory for Apple VM (#4271) * (macOS) Wizard created invalid target configuration for virtualized targets (#4274) ## Changes (v4.0.0) * USB redirection support in terminal mode * Configuration file format changed, newly saved VMs will not be compatible with older versions of UTM * Newly imported disk images will be converted to QCOW2 automatically * Settings: new layout with support for multiple {Display, Serial, Network, Sound} devices (#3585) * Support multiple displays (#220) * Added Japanese localization (thanks @MMP0) * Support adding PTTY (macOS only), TCP client, and TCP server serial connections for QEMU machines (address should show up in the home screen) (#3546) * Support headless display (remove all displays and built-in serial ports in the settings) (#2280) * Support redirecting QEMU monitor and GDB stub to a serial port * Support zstd compression for QCOW2 images and use zstd as default for image compression (#4211) * Update ANGLE (GL backend) to latest git commit * Added French localization (thanks @FRtranslator) * Fixed microphone recording silence (#219) * Fixed a crash when attempting to delete a QEMU additional argument * Option in VM settings to use virtfs/9pfs for file sharing (#2184) * Option in VM settings to change VGA RAM size (#4034) * Option in VM settings to enable virtio-balloon driver (#4136) * Invert mouse scrolling is now a global setting rather than a per-vm configuration option * (iOS) Replaced hterm.js with SwiftTerm for terminal mode (#3473) * (iOS) Attach to JitStreamer (set IP address in Settings app and UTM will try to connect automatically on launch) (thanks @ktprograms) * (iOS) Automatically resize the display to fit the screen when the resolution changes if the resize toolbar option is used * (iOS) Reimplemented the USB and Drives menu with a better UI * (iOS) On iPadOS 16, show the menu bar when holding Cmd on the keyboard. On previous versions, an on-screen help will show supported commands * (iOS) Improved audio handling including: output when on silence, mixing with other apps, working when both recording and outputting (including with another app) (#3996) * (iOS) Added a global setting to always prefer the built-in microphone to a bluetooth microphone * (macOS) Fixed running from shortcut in Apple VMs (no longer need to re-import after each launch) * (macOS) Improved IPSW selection interface and support drag and drop (thanks @pointum) * (macOS) Fixed running unsigned builds * (macOS) Removed some deprecated global settings * (macOS) Fixed an error when trying to download an IPSW and the Caches directory does not exist (thanks @LostInCompilation) * (macOS) Fixed an issue where a VM could be started twice if the home screen's toolbar is used leading to data corruption (#4166) * (macOS 13+) Boot into recoveryOS (to disable SIP, etc) by right clicking on the VM and selecting "Run in recovery..." (#3526) * (macOS 13+) Option in VM settings to enable Rosetta for x86_64 emulation (#4100) * (macOS 13+) Option in VM settings to enable clipboard sharing (SPICE support needed on the guest) (#4121) * (macOS 13+) GUI display for Linux VMs (#4120) * (macOS 13+) Add removable drives, will show up as USB mass storage ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ### Known Issues * Automation URL commands currently do not work completely * (macOS) GUI Linux boot may not be compatible with all distros. Ubuntu Server 22.04 does not install. ## Installation **iOS**: Visit [https://getutm.app/install/][1] for the most up to date installation instructions. **macOS**: Download "UTM.dmg" below and copy the contents to your `/Applications` directory. | 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 | No | 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][3] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://github.com/osy/Jitterbug

**Remember to back up your VMs before running a beta release of UTM!** ## Highlights * **Multiple display and headless display is now supported for QEMU machines.** You can configure 0 or more displays as well as 0 or more builtin terminal consoles. On macOS, a new window will be created for each display and builtin terminal. On iOS, you can create multiple windows (iPad) as well as plug in an external display or AirPlay (iPad or iPhone) and assign outputs to each window. * **Ventura updates to Virtualization.** macOS Ventura introduces new features to Virtualization.framework that is now integrated into UTM. You can now create GUI Linux VMs with EFI boot. Clipboard sharing and directory sharing now works with macOS Ventura guests. Rosetta x86_64 emulation is supported for Linux VMs on Apple Silicon. * **VirtFS sharing for QEMU.** This can be enabled in the VM settings under Sharing. You can mount the tag "share" in the VM. Note that macOS UID are numbered differently than Linux so you may need to set up your guest to have permission to access the shared directory. * **Easier Windows 10/11 installation and Windows guest tools downloader.** You can now download and mount the Windows drivers and guest tools ISO image with a single click (macOS: disk icon in VM window, iOS: 3D touch context menu on home screen). Additionally, the ISO now include an "Autounattend.xml" which is recognized by the Windows 10/11 installer. When mounted to a second CD drive, the installer will install the correct drivers, bypass secure boot/TPM requirements, and launch the SPICE tools installer on first login. * (macOS) **Resize QEMU disk images.** In the drives settings page, you can now expand the size of the QCOW2 disk image. * (iOS) **QEMU Virtualization for M1 iPad.** With the release of [TrollStore](https://github.com/opa334/TrollStore), you can now enable Hypervisor on iOS. Note that only M1 hardware and kernel have support for Hypervisor. iOS 14.4.2-14.5.1 is supported only on M1 iPad Pro jailbroken with fugu14/unc0ver. iOS 15.0-15.1.1 is supported on any M1 iPad running TrollStore. ## Notes * **iOS 14 and macOS 11.3** are the new minimum supported systems. Please use UTM v3.x for support down to iOS 11 and macOS 11 * The configuration backend has been massively rewritten. **Please backup all VMs prior to updating as you will not be able to re-open VMs saved by UTM v4 on older versions of UTM if you decide to downgrade.** ## Changes (v4.0.5) * Fixed moving an existing VM with Hypervisor enabled to a device on a different architecture. The VM will fallback to TCG and the option to disable hypervisor in settings is allowed. (#4407) * Translation: Updated Japanese (thanks @MMP0) * (iOS) Fixed an issue that prevented external keyboards from working (#4399) * (iOS) Detect Hypervisor support on jailbroken devices so the option is not inadvertently enabled on non-supported devices * (iOS) Support Hypervisor on M1 iPad running jailbroken iOS 14.5 ## Changes (v4.0.4) * Fixed in issue generating configuration for IDE drives leading to PPC not booting and I/O errors on PC (#4372, #4376, others) * Moved the SPICE tools download directory to "GuestSupportTools" under "Application Support" (previously it was just under "Application Support") * Fixed creating a VM with illegal path characters in the name (#4385) * Translation: Updated Japanese (thanks @MMP0) * Translation: Updated French (thanks @FRtranslator) * Wizard: No longer tries to download the Windows guest tools when selecting a non-Windows OS * (iOS) Enable build with Hypervisor.framework (support limited to M1 iPad) * (iOS) Fixed a crash when switching display in a window * (iOS) On jailbroken devices, the memory limit will automatically be increased to the maximum, preventing the Jetsam system from terminating UTM for memory usage * (iOS) Fixed a regression which caused the home indicator to not be hidden (#4390) * (iOS) Fixed a regression which caused the cursor to not be captured (#4390) * (iOS) When switching display, notification handlers are properly cleaned up (example: cursor capture and console on screen keyboard events) * (iOS) Show the device cursor when VM is paused * (iOS) Fixed a regression where external keyboard events are not captured * (iOS) Fixed an error where extraneous stale VM entries show up after the container name changes (#4392) * (iOS) Fixed a crash on iOS 14 when opening a terminal view due to SwiftTerm handling the colour configuration * (macOS) Fixed a layout issue of the compress/resize buttons * (macOS) Forgot to actually enable compression for the drive setting button (#4377) * (macOS) Fixed some settings layout issue on < macOS 13 (#4374) ## Changes (v4.0.3) * Fixed an issue where changing external drive/shared directory for a QEMU VM -> exit UTM -> reopen UTM and start the VM results in the drive/share not being restored * Disable changing a VirtFS share from the home window (this is not an supported operation) * Better detection of UUID collision which addresses an issue where VMs with the same UUID do not show up on the home screen and other VMs show up as duplicates and clicking on any of them results in a freeze * Fixed floppy drive argument not being correctly generated (#4362) * Fixed an issue where ejecting an external drive or shared directory does not persist * Fixed a memory issue when stopping or closing VMs causing UTM to crash * Fixed a regression where an access error occurs after moving a VM * Added the ability to download the Windows SPICE tools and drivers automatically (#4364) * Added support for more than 2 IDE drives in PC emulation * Restored the setting to turn off blinking cursor (#4296) * Translation: Updated Japanese (thanks @MMP0) * Wizard: Reworked some of the UI, text, and file selection * Wizard: Add option to auto download and mount the SPICE tools to a second CD drive * Wizard: Fixed an issue where the selected boot image and shared directory was not saved on the new VM * Wizard: Recommend UUP built ISO over the VHDX by default * Wizard: New "confused user" check will catch trying to mount an "amd64" ISO on an "arm64" guest or vice versa * (iOS 16) Use the new NavigationSplitView for a slightly polished look * (iOS 16) Fixed an issue where the bottom toolbar does not show up (#4325) * (iOS) Fixed an issue where the file importer was not opening (#4365) * (iOS 14) Fixed an issue in the settings screen where multiple drives were occupying a single cell * (iOS 14) Fixed an issue where UTM may crash when adding a drive or hardware * (macOS) Added the ability to re-open closed windows for a given VM (#4351) * (macOS) Fixed an issue where restarting a VM results in duplicate windows (#4367) * (macOS) Save the size of terminal windows (#4296) * (macOS) Add resize QCOW2 image feature (thanks @stewartsmith) ## Changes (v4.0.2) * Removed "view.plist" for host-specific configuration settings (i.e. bookmarks to removable drives and window options) and replaced it with a new "registry" that is stored outside of the .utm bundle. Old "view.plist" settings and bookmarks will be migrated to the registry on first launch and the file will be deleted from the .utm bundle. For Apple VMs, the bookmarks will no longer be stored in config.plist and the settings will be migrated to the registry as well. * VirtFS no longer requires SPICE to be enabled (thanks @tie) * Fixed an issue with PPC VMs not showing 256 colours correctly (#4277) * Fixed incorrect parsing of CPU flags (#4282) * Do not save screenshots when running in disposable mode * Translation: Added Spanish (Latin America) (thanks @JezerM) * Translation: Added Finnish (thanks @marcusziade) * Translation: Updated Japanese (thanks @MMP0) * Translation: Updated Chinese (Simplified) (thanks @ty-yqs) * Translation: Updated French (thanks @FRtranslator) * (iOS) Per-display window settings (zoom, position, keyboard visibility, etc) will be stored in the new registry * (iOS) Prefer JitStreamer over AltJit when both are available (thanks @ktprograms) * (macOS) Fixed saving removable drives and shared directories for Apple VMs * (macOS) Fixed missing audio entitlements (#4342) * (macOS) Fixed QEMULauncher process not terminating when a VM is force quit * (macOS) Fixed issue selecting text in SwiftTerm (#4297) ## Changes (v4.0.1) * Fixed an issue where an UEFI BIOS error was reported when the target does not use UEFI (#4265) * Added Elementary OS icon (thanks @Unbinilium) * Updated ja localization (thanks @MMP0) * Updated fr localization (thanks @FRtranslator) * Changed the icon for "Serial" so it appears on iOS 14 and macOS 11 as well * Fixed custom icon not showing up for "legacy" configurations * Fixed an error trying to migrate "legacy" configuration when "Images" does not exist (#4266) * Fixed USB redirection (#4263) * (iOS) Fixed a toolbar issue where USB button overflowed on screen. * (iOS) Fixed resume button not appearing on < iOS 16 * (iOS) Attempt to close the download progress pop-up after download completes (#4261) * (iOS) "Open" popover refuses to show up again after swiping down (#4260) * (iOS) Hide "Add" text on iOS 14 settings * (iOS) Fixed crash on iOS 14 settings when attempting to use the picker (#4270) * (iOS) Fixed an issue on iOS 14 where picker selection was being reset * (iOS) Fixed an issue where the USB icon is stuck on busy after a device disconnects * (macOS) Fixed a crash trying to change shared directory for Apple VM (#4271) * (macOS) Wizard created invalid target configuration for virtualized targets (#4274) ## Changes (v4.0.0) * USB redirection support in terminal mode * Configuration file format changed, newly saved VMs will not be compatible with older versions of UTM * Newly imported disk images will be converted to QCOW2 automatically * Settings: new layout with support for multiple {Display, Serial, Network, Sound} devices (#3585) * Support multiple displays (#220) * Added Japanese localization (thanks @MMP0) * Support adding PTTY (macOS only), TCP client, and TCP server serial connections for QEMU machines (address should show up in the home screen) (#3546) * Support headless display (remove all displays and built-in serial ports in the settings) (#2280) * Support redirecting QEMU monitor and GDB stub to a serial port * Support zstd compression for QCOW2 images and use zstd as default for image compression (#4211) * Update ANGLE (GL backend) to latest git commit * Added French localization (thanks @FRtranslator) * Fixed microphone recording silence (#219) * Fixed a crash when attempting to delete a QEMU additional argument * Option in VM settings to use virtfs/9pfs for file sharing (#2184) * Option in VM settings to change VGA RAM size (#4034) * Option in VM settings to enable virtio-balloon driver (#4136) * Invert mouse scrolling is now a global setting rather than a per-vm configuration option * (iOS) Replaced hterm.js with SwiftTerm for terminal mode (#3473) * (iOS) Attach to JitStreamer (set IP address in Settings app and UTM will try to connect automatically on launch) (thanks @ktprograms) * (iOS) Automatically resize the display to fit the screen when the resolution changes if the resize toolbar option is used * (iOS) Reimplemented the USB and Drives menu with a better UI * (iOS) On iPadOS 16, show the menu bar when holding Cmd on the keyboard. On previous versions, an on-screen help will show supported commands * (iOS) Improved audio handling including: output when on silence, mixing with other apps, working when both recording and outputting (including with another app) (#3996) * (iOS) Added a global setting to always prefer the built-in microphone to a bluetooth microphone * (macOS) Fixed running from shortcut in Apple VMs (no longer need to re-import after each launch) * (macOS) Improved IPSW selection interface and support drag and drop (thanks @pointum) * (macOS) Fixed running unsigned builds * (macOS) Removed some deprecated global settings * (macOS) Fixed an error when trying to download an IPSW and the Caches directory does not exist (thanks @LostInCompilation) * (macOS) Fixed an issue where a VM could be started twice if the home screen's toolbar is used leading to data corruption (#4166) * (macOS 13+) Boot into recoveryOS (to disable SIP, etc) by right clicking on the VM and selecting "Run in recovery..." (#3526) * (macOS 13+) Option in VM settings to enable Rosetta for x86_64 emulation (#4100) * (macOS 13+) Option in VM settings to enable clipboard sharing (SPICE support needed on the guest) (#4121) * (macOS 13+) GUI display for Linux VMs (#4120) * (macOS 13+) Add removable drives, will show up as USB mass storage ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ### Known Issues * Automation URL commands currently do not work completely * (macOS) GUI Linux boot may not be compatible with all distros. Ubuntu Server 22.04 does not install. ## Installation **iOS**: Visit [https://getutm.app/install/][1] for the most up to date installation instructions. **macOS**: Download "UTM.dmg" below and copy the contents to your `/Applications` directory. | 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 | No | 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][3] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://github.com/osy/Jitterbug

**Remember to back up your VMs before running a beta release of UTM!** ## Highlights * **Multiple display and headless display is now supported for QEMU machines.** You can configure 0 or more displays as well as 0 or more builtin terminal consoles. On macOS, a new window will be created for each display and builtin terminal. On iOS, you can create multiple windows (iPad) as well as plug in an external display or AirPlay (iPad or iPhone) and assign outputs to each window. * **Ventura updates to Virtualization.** macOS Ventura introduces new features to Virtualization.framework that is now integrated into UTM. You can now create GUI Linux VMs with EFI boot. Clipboard sharing and directory sharing now works with macOS Ventura guests. Rosetta x86_64 emulation is supported for Linux VMs on Apple Silicon. * **VirtFS sharing for QEMU.** This can be enabled in the VM settings under Sharing. You can mount the tag "share" in the VM. Note that macOS UID are numbered differently than Linux so you may need to set up your guest to have permission to access the shared directory. * **Easier Windows 10/11 installation and Windows guest tools downloader.** You can now download and mount the Windows drivers and guest tools ISO image with a single click (macOS: disk icon in VM window, iOS: 3D touch context menu on home screen). Additionally, the ISO now include an "Autounattend.xml" which is recognized by the Windows 10/11 installer. When mounted to a second CD drive, the installer will install the correct drivers, bypass secure boot/TPM requirements, and launch the SPICE tools installer on first login. * (macOS) **Resize QEMU disk images.** In the drives settings page, you can now expand the size of the QCOW2 disk image. * (iOS) **QEMU Virtualization for M1 iPad.** With the release of [TrollStore](https://github.com/opa334/TrollStore), you can now enable Hypervisor on iOS. Note that only M1 hardware and kernel have support for Hypervisor and it has only been tested on iOS 15. ## Notes * **iOS 14 and macOS 11.3** are the new minimum supported systems. Please use UTM v3.x for support down to iOS 11 and macOS 11 * The configuration backend has been massively rewritten. **Please backup all VMs prior to updating as you will not be able to re-open VMs saved by UTM v4 on older versions of UTM if you decide to downgrade.** ## Changes (v4.0.4) * Fixed in issue generating configuration for IDE drives leading to PPC not booting and I/O errors on PC (#4372, #4376, others) * Moved the SPICE tools download directory to "GuestSupportTools" under "Application Support" (previously it was just under "Application Support") * Fixed creating a VM with illegal path characters in the name (#4385) * Translation: Updated Japanese (thanks @MMP0) * Translation: Updated French (thanks @FRtranslator) * Wizard: No longer tries to download the Windows guest tools when selecting a non-Windows OS * (iOS) Enable build with Hypervisor.framework (support limited to M1 iPad) * (iOS) Fixed a crash when switching display in a window * (iOS) On jailbroken devices, the memory limit will automatically be increased to the maximum, preventing the Jetsam system from terminating UTM for memory usage * (iOS) Fixed a regression which caused the home indicator to not be hidden (#4390) * (iOS) Fixed a regression which caused the cursor to not be captured (#4390) * (iOS) When switching display, notification handlers are properly cleaned up (example: cursor capture and console on screen keyboard events) * (iOS) Show the device cursor when VM is paused * (iOS) Fixed a regression where external keyboard events are not captured * (iOS) Fixed an error where extraneous stale VM entries show up after the container name changes (#4392) * (iOS) Fixed a crash on iOS 14 when opening a terminal view due to SwiftTerm handling the colour configuration * (macOS) Fixed a layout issue of the compress/resize buttons * (macOS) Forgot to actually enable compression for the drive setting button (#4377) * (macOS) Fixed some settings layout issue on < macOS 13 (#4374) ## Changes (v4.0.3) * Fixed an issue where changing external drive/shared directory for a QEMU VM -> exit UTM -> reopen UTM and start the VM results in the drive/share not being restored * Disable changing a VirtFS share from the home window (this is not an supported operation) * Better detection of UUID collision which addresses an issue where VMs with the same UUID do not show up on the home screen and other VMs show up as duplicates and clicking on any of them results in a freeze * Fixed floppy drive argument not being correctly generated (#4362) * Fixed an issue where ejecting an external drive or shared directory does not persist * Fixed a memory issue when stopping or closing VMs causing UTM to crash * Fixed a regression where an access error occurs after moving a VM * Added the ability to download the Windows SPICE tools and drivers automatically (#4364) * Added support for more than 2 IDE drives in PC emulation * Restored the setting to turn off blinking cursor (#4296) * Translation: Updated Japanese (thanks @MMP0) * Wizard: Reworked some of the UI, text, and file selection * Wizard: Add option to auto download and mount the SPICE tools to a second CD drive * Wizard: Fixed an issue where the selected boot image and shared directory was not saved on the new VM * Wizard: Recommend UUP built ISO over the VHDX by default * Wizard: New "confused user" check will catch trying to mount an "amd64" ISO on an "arm64" guest or vice versa * (iOS 16) Use the new NavigationSplitView for a slightly polished look * (iOS 16) Fixed an issue where the bottom toolbar does not show up (#4325) * (iOS) Fixed an issue where the file importer was not opening (#4365) * (iOS 14) Fixed an issue in the settings screen where multiple drives were occupying a single cell * (iOS 14) Fixed an issue where UTM may crash when adding a drive or hardware * (macOS) Added the ability to re-open closed windows for a given VM (#4351) * (macOS) Fixed an issue where restarting a VM results in duplicate windows (#4367) * (macOS) Save the size of terminal windows (#4296) * (macOS) Add resize QCOW2 image feature (thanks @stewartsmith) ## Changes (v4.0.2) * Removed "view.plist" for host-specific configuration settings (i.e. bookmarks to removable drives and window options) and replaced it with a new "registry" that is stored outside of the .utm bundle. Old "view.plist" settings and bookmarks will be migrated to the registry on first launch and the file will be deleted from the .utm bundle. For Apple VMs, the bookmarks will no longer be stored in config.plist and the settings will be migrated to the registry as well. * VirtFS no longer requires SPICE to be enabled (thanks @tie) * Fixed an issue with PPC VMs not showing 256 colours correctly (#4277) * Fixed incorrect parsing of CPU flags (#4282) * Do not save screenshots when running in disposable mode * Translation: Added Spanish (Latin America) (thanks @JezerM) * Translation: Added Finnish (thanks @marcusziade) * Translation: Updated Japanese (thanks @MMP0) * Translation: Updated Chinese (Simplified) (thanks @ty-yqs) * Translation: Updated French (thanks @FRtranslator) * (iOS) Per-display window settings (zoom, position, keyboard visibility, etc) will be stored in the new registry * (iOS) Prefer JitStreamer over AltJit when both are available (thanks @ktprograms) * (macOS) Fixed saving removable drives and shared directories for Apple VMs * (macOS) Fixed missing audio entitlements (#4342) * (macOS) Fixed QEMULauncher process not terminating when a VM is force quit * (macOS) Fixed issue selecting text in SwiftTerm (#4297) ## Changes (v4.0.1) * Fixed an issue where an UEFI BIOS error was reported when the target does not use UEFI (#4265) * Added Elementary OS icon (thanks @Unbinilium) * Updated ja localization (thanks @MMP0) * Updated fr localization (thanks @FRtranslator) * Changed the icon for "Serial" so it appears on iOS 14 and macOS 11 as well * Fixed custom icon not showing up for "legacy" configurations * Fixed an error trying to migrate "legacy" configuration when "Images" does not exist (#4266) * Fixed USB redirection (#4263) * (iOS) Fixed a toolbar issue where USB button overflowed on screen. * (iOS) Fixed resume button not appearing on < iOS 16 * (iOS) Attempt to close the download progress pop-up after download completes (#4261) * (iOS) "Open" popover refuses to show up again after swiping down (#4260) * (iOS) Hide "Add" text on iOS 14 settings * (iOS) Fixed crash on iOS 14 settings when attempting to use the picker (#4270) * (iOS) Fixed an issue on iOS 14 where picker selection was being reset * (iOS) Fixed an issue where the USB icon is stuck on busy after a device disconnects * (macOS) Fixed a crash trying to change shared directory for Apple VM (#4271) * (macOS) Wizard created invalid target configuration for virtualized targets (#4274) ## Changes (v4.0.0) * USB redirection support in terminal mode * Configuration file format changed, newly saved VMs will not be compatible with older versions of UTM * Newly imported disk images will be converted to QCOW2 automatically * Settings: new layout with support for multiple {Display, Serial, Network, Sound} devices (#3585) * Support multiple displays (#220) * Added Japanese localization (thanks @MMP0) * Support adding PTTY (macOS only), TCP client, and TCP server serial connections for QEMU machines (address should show up in the home screen) (#3546) * Support headless display (remove all displays and built-in serial ports in the settings) (#2280) * Support redirecting QEMU monitor and GDB stub to a serial port * Support zstd compression for QCOW2 images and use zstd as default for image compression (#4211) * Update ANGLE (GL backend) to latest git commit * Added French localization (thanks @FRtranslator) * Fixed microphone recording silence (#219) * Fixed a crash when attempting to delete a QEMU additional argument * Option in VM settings to use virtfs/9pfs for file sharing (#2184) * Option in VM settings to change VGA RAM size (#4034) * Option in VM settings to enable virtio-balloon driver (#4136) * Invert mouse scrolling is now a global setting rather than a per-vm configuration option * (iOS) Replaced hterm.js with SwiftTerm for terminal mode (#3473) * (iOS) Attach to JitStreamer (set IP address in Settings app and UTM will try to connect automatically on launch) (thanks @ktprograms) * (iOS) Automatically resize the display to fit the screen when the resolution changes if the resize toolbar option is used * (iOS) Reimplemented the USB and Drives menu with a better UI * (iOS) On iPadOS 16, show the menu bar when holding Cmd on the keyboard. On previous versions, an on-screen help will show supported commands * (iOS) Improved audio handling including: output when on silence, mixing with other apps, working when both recording and outputting (including with another app) (#3996) * (iOS) Added a global setting to always prefer the built-in microphone to a bluetooth microphone * (macOS) Fixed running from shortcut in Apple VMs (no longer need to re-import after each launch) * (macOS) Improved IPSW selection interface and support drag and drop (thanks @pointum) * (macOS) Fixed running unsigned builds * (macOS) Removed some deprecated global settings * (macOS) Fixed an error when trying to download an IPSW and the Caches directory does not exist (thanks @LostInCompilation) * (macOS) Fixed an issue where a VM could be started twice if the home screen's toolbar is used leading to data corruption (#4166) * (macOS 13+) Boot into recoveryOS (to disable SIP, etc) by right clicking on the VM and selecting "Run in recovery..." (#3526) * (macOS 13+) Option in VM settings to enable Rosetta for x86_64 emulation (#4100) * (macOS 13+) Option in VM settings to enable clipboard sharing (SPICE support needed on the guest) (#4121) * (macOS 13+) GUI display for Linux VMs (#4120) * (macOS 13+) Add removable drives, will show up as USB mass storage ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ### Known Issues * Automation URL commands currently do not work completely * (macOS) GUI Linux boot may not be compatible with all distros. Ubuntu Server 22.04 does not install. ## Installation **iOS**: Visit [https://getutm.app/install/][1] for the most up to date installation instructions. **macOS**: Download "UTM.dmg" below and copy the contents to your `/Applications` directory. | 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 | No | 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][3] or Jitstreamer. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://github.com/osy/Jitterbug

**Remember to back up your VMs before running a beta release of UTM!** ## Installation **iOS**: Visit [https://getutm.app/install/][1] for the most up to date installation instructions. **macOS**: Download "UTM.dmg" below and copy the contents to your `/Applications` directory. ## Highlights * **Multiple display and headless display is now supported for QEMU machines.** You can configure 0 or more displays as well as 0 or more builtin terminal consoles. On macOS, a new window will be created for each display and builtin terminal. On iOS, you can create multiple windows (iPad) as well as plug in an external display or AirPlay (iPad or iPhone) and assign outputs to each window. * **Ventura updates to Virtualization.** macOS Ventura introduces new features to Virtualization.framework that is now integrated into UTM. You can now create GUI Linux VMs with EFI boot. Clipboard sharing and directory sharing now works with macOS Ventura guests. Rosetta x86_64 emulation is supported for Linux VMs on Apple Silicon. * **Virtiofs sharing for QEMU.** This can be enabled in the VM settings under Sharing. You can mount the tag "share" in the VM. Note that macOS UID are numbered differently than Linux so you may need to set up your guest to have permission to access the shared directory. * **Easier Windows 10/11 installation and Windows guest tools downloader.** You can now download and mount the Windows drivers and guest tools ISO image with a single click (macOS: disk icon in VM window, iOS: 3D touch context menu on home screen). Additionally, the ISO now include an "Autounattend.xml" which is recognized by the Windows 10/11 installer. When mounted to a second CD drive, the installer will install the correct drivers, bypass secure boot/TPM requirements, and launch the SPICE tools installer on first login. * (macOS) **Resize QEMU disk images.** In the drives settings page, you can now expand the size of the QCOW2 disk image. ## Notes * **iOS 14 and macOS 11.3** are the new minimum supported systems. Please use UTM v3.x for support down to iOS 11 and macOS 11 * The configuration backend has been massively rewritten. **Please backup all VMs prior to updating as you will not be able to re-open VMs saved by UTM v4 on older versions of UTM if you decide to downgrade.** ## Changes (v4.0.3) * Fixed an issue where changing external drive/shared directory for a QEMU VM -> exit UTM -> reopen UTM and start the VM results in the drive/share not being restored * Disable changing a VirtioFS share from the home window (this is not an supported operation) * Better detection of UUID collision which addresses an issue where VMs with the same UUID do not show up on the home screen and other VMs show up as duplicates and clicking on any of them results in a freeze * Fixed floppy drive argument not being correctly generated (#4362) * Fixed an issue where ejecting an external drive or shared directory does not persist * Fixed a memory issue when stopping or closing VMs causing UTM to crash * Fixed a regression where an access error occurs after moving a VM * Added the ability to download the Windows SPICE tools and drivers automatically (#4364) * Added support for more than 2 IDE drives in PC emulation * Restored the setting to turn off blinking cursor (#4296) * Translation: Updated Japanese (thanks @MMP0) * Wizard: Reworked some of the UI, text, and file selection * Wizard: Add option to auto download and mount the SPICE tools to a second CD drive * Wizard: Fixed an issue where the selected boot image and shared directory was not saved on the new VM * Wizard: Recommend UUP built ISO over the VHDX by default * Wizard: New "confused user" check will catch trying to mount an "amd64" ISO on an "arm64" guest or vice versa * (iOS 16) Use the new NavigationSplitView for a slightly polished look * (iOS 16) Fixed an issue where the bottom toolbar does not show up (#4325) * (iOS) Fixed an issue where the file importer was not opening (#4365) * (iOS 14) Fixed an issue in the settings screen where multiple drives were occupying a single cell * (iOS 14) Fixed an issue where UTM may crash when adding a drive or hardware * (macOS) Added the ability to re-open closed windows for a given VM (#4351) * (macOS) Fixed an issue where restarting a VM results in duplicate windows (#4367) * (macOS) Save the size of terminal windows (#4296) * (macOS) Add resize QCOW2 image feature (thanks @stewartsmith) ## Changes (v4.0.2) * Removed "view.plist" for host-specific configuration settings (i.e. bookmarks to removable drives and window options) and replaced it with a new "registry" that is stored outside of the .utm bundle. Old "view.plist" settings and bookmarks will be migrated to the registry on first launch and the file will be deleted from the .utm bundle. For Apple VMs, the bookmarks will no longer be stored in config.plist and the settings will be migrated to the registry as well. * Virtiofs no longer requires SPICE to be enabled (thanks @tie) * Fixed an issue with PPC VMs not showing 256 colours correctly (#4277) * Fixed incorrect parsing of CPU flags (#4282) * Do not save screenshots when running in disposable mode * Translation: Added Spanish (Latin America) (thanks @JezerM) * Translation: Added Finnish (thanks @marcusziade) * Translation: Updated Japanese (thanks @MMP0) * Translation: Updated Chinese (Simplified) (thanks @ty-yqs) * Translation: Updated French (thanks @FRtranslator) * (iOS) Per-display window settings (zoom, position, keyboard visibility, etc) will be stored in the new registry * (iOS) Prefer JitStreamer over AltJit when both are available (thanks @ktprograms) * (macOS) Fixed saving removable drives and shared directories for Apple VMs * (macOS) Fixed missing audio entitlements (#4342) * (macOS) Fixed QEMULauncher process not terminating when a VM is force quit * (macOS) Fixed issue selecting text in SwiftTerm (#4297) ## Changes (v4.0.1) * Fixed an issue where an UEFI BIOS error was reported when the target does not use UEFI (#4265) * Added Elementary OS icon (thanks @Unbinilium) * Updated ja localization (thanks @MMP0) * Updated fr localization (thanks @FRtranslator) * Changed the icon for "Serial" so it appears on iOS 14 and macOS 11 as well * Fixed custom icon not showing up for "legacy" configurations * Fixed an error trying to migrate "legacy" configuration when "Images" does not exist (#4266) * Fixed USB redirection (#4263) * (iOS) Fixed a toolbar issue where USB button overflowed on screen. * (iOS) Fixed resume button not appearing on < iOS 16 * (iOS) Attempt to close the download progress pop-up after download completes (#4261) * (iOS) "Open" popover refuses to show up again after swiping down (#4260) * (iOS) Hide "Add" text on iOS 14 settings * (iOS) Fixed crash on iOS 14 settings when attempting to use the picker (#4270) * (iOS) Fixed an issue on iOS 14 where picker selection was being reset * (iOS) Fixed an issue where the USB icon is stuck on busy after a device disconnects * (macOS) Fixed a crash trying to change shared directory for Apple VM (#4271) * (macOS) Wizard created invalid target configuration for virtualized targets (#4274) ## Changes (v4.0.0) * USB redirection support in terminal mode * Configuration file format changed, newly saved VMs will not be compatible with older versions of UTM * Newly imported disk images will be converted to QCOW2 automatically * Settings: new layout with support for multiple {Display, Serial, Network, Sound} devices (#3585) * Support multiple displays (#220) * Added Japanese localization (thanks @MMP0) * Support adding PTTY (macOS only), TCP client, and TCP server serial connections for QEMU machines (address should show up in the home screen) (#3546) * Support headless display (remove all displays and built-in serial ports in the settings) (#2280) * Support redirecting QEMU monitor and GDB stub to a serial port * Support zstd compression for QCOW2 images and use zstd as default for image compression (#4211) * Update ANGLE (GL backend) to latest git commit * Added French localization (thanks @FRtranslator) * Fixed microphone recording silence (#219) * Fixed a crash when attempting to delete a QEMU additional argument * Option in VM settings to use virtfs/9pfs for file sharing (#2184) * Option in VM settings to change VGA RAM size (#4034) * Option in VM settings to enable virtio-balloon driver (#4136) * Invert mouse scrolling is now a global setting rather than a per-vm configuration option * (iOS) Replaced hterm.js with SwiftTerm for terminal mode (#3473) * (iOS) Attach to JitStreamer (set IP address in Settings app and UTM will try to connect automatically on launch) (thanks @ktprograms) * (iOS) Automatically resize the display to fit the screen when the resolution changes if the resize toolbar option is used * (iOS) Reimplemented the USB and Drives menu with a better UI * (iOS) On iPadOS 16, show the menu bar when holding Cmd on the keyboard. On previous versions, an on-screen help will show supported commands * (iOS) Improved audio handling including: output when on silence, mixing with other apps, working when both recording and outputting (including with another app) (#3996) * (iOS) Added a global setting to always prefer the built-in microphone to a bluetooth microphone * (macOS) Fixed running from shortcut in Apple VMs (no longer need to re-import after each launch) * (macOS) Improved IPSW selection interface and support drag and drop (thanks @pointum) * (macOS) Fixed running unsigned builds * (macOS) Removed some deprecated global settings * (macOS) Fixed an error when trying to download an IPSW and the Caches directory does not exist (thanks @LostInCompilation) * (macOS) Fixed an issue where a VM could be started twice if the home screen's toolbar is used leading to data corruption (#4166) * (macOS 13+) Boot into recoveryOS (to disable SIP, etc) by right clicking on the VM and selecting "Run in recovery..." (#3526) * (macOS 13+) Option in VM settings to enable Rosetta for x86_64 emulation (#4100) * (macOS 13+) Option in VM settings to enable clipboard sharing (SPICE support needed on the guest) (#4121) * (macOS 13+) GUI display for Linux VMs (#4120) * (macOS 13+) Add removable drives, will show up as USB mass storage ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ### Known Issues * Automation URL commands currently do not work completely * (macOS) GUI Linux boot may not be compatible with all distros. Ubuntu Server 22.04 does not install. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

**Remember to back up your VMs before running a beta release of UTM!** ## Installation **iOS**: Visit [https://getutm.app/install/][1] for the most up to date installation instructions. **macOS**: Download "UTM.dmg" below and copy the contents to your `/Applications` directory. ## Highlights * **Multiple display and headless display is now supported for QEMU machines.** You can configure 0 or more displays as well as 0 or more builtin terminal consoles. On macOS, a new window will be created for each display and builtin terminal. On iOS, you can create multiple windows (iPad) as well as plug in an external display or AirPlay (iPad or iPhone) and assign outputs to each window. * **Ventura updates to Virtualization.** macOS Ventura introduces new features to Virtualization.framework that is now integrated into UTM. You can now create GUI Linux VMs with EFI boot. Clipboard sharing and directory sharing now works with macOS Ventura guests. Rosetta x86_64 emulation is supported for Linux VMs on Apple Silicon. * **Virtiofs sharing for QEMU.** This can be enabled in the VM settings under Sharing. You can mount the tag "share" in the VM. Note that macOS UID are numbered differently than Linux so you may need to set up your guest to have permission to access the shared directory. ## Notes * **iOS 14 and macOS 11.3** are the new minimum supported systems. Please use UTM v3.x for support down to iOS 11 and macOS 11 * The configuration backend has been massively rewritten. **Please backup all VMs prior to updating as you will not be able to re-open VMs saved by UTM v4 on older versions of UTM if you decide to downgrade.** ## Changes (v4.0.2) * Removed "view.plist" for host-specific configuration settings (i.e. bookmarks to removable drives and window options) and replaced it with a new "registry" that is stored outside of the .utm bundle. Old "view.plist" settings and bookmarks will be migrated to the registry on first launch and the file will be deleted from the .utm bundle. For Apple VMs, the bookmarks will no longer be stored in config.plist and the settings will be migrated to the registry as well. * Virtiofs no longer requires SPICE to be enabled (thanks @tie) * Fixed an issue with PPC VMs not showing 256 colours correctly (#4277) * Fixed incorrect parsing of CPU flags (#4282) * Do not save screenshots when running in disposable mode * Translation: Added Spanish (Latin America) (thanks @JezerM) * Translation: Added Finnish (thanks @marcusziade) * Translation: Updated Japanese (thanks @MMP0) * Translation: Updated Chinese (Simplified) (thanks @ty-yqs) * Translation: Updated French (thanks @FRtranslator) * (iOS) Per-display window settings (zoom, position, keyboard visibility, etc) will be stored in the new registry * (iOS) Prefer JitStreamer over AltJit when both are available (thanks @ktprograms) * (macOS) Fixed saving removable drives and shared directories for Apple VMs * (macOS) Fixed missing audio entitlements (#4342) * (macOS) Fixed QEMULauncher process not terminating when a VM is force quit * (macOS) Fixed issue selecting text in SwiftTerm (#4297) ## Changes (v4.0.1) * Fixed an issue where an UEFI BIOS error was reported when the target does not use UEFI (#4265) * Added Elementary OS icon (thanks @Unbinilium) * Updated ja localization (thanks @MMP0) * Updated fr localization (thanks @FRtranslator) * Changed the icon for "Serial" so it appears on iOS 14 and macOS 11 as well * Fixed custom icon not showing up for "legacy" configurations * Fixed an error trying to migrate "legacy" configuration when "Images" does not exist (#4266) * Fixed USB redirection (#4263) * (iOS) Fixed a toolbar issue where USB button overflowed on screen. * (iOS) Fixed resume button not appearing on < iOS 16 * (iOS) Attempt to close the download progress pop-up after download completes (#4261) * (iOS) "Open" popover refuses to show up again after swiping down (#4260) * (iOS) Hide "Add" text on iOS 14 settings * (iOS) Fixed crash on iOS 14 settings when attempting to use the picker (#4270) * (iOS) Fixed an issue on iOS 14 where picker selection was being reset * (iOS) Fixed an issue where the USB icon is stuck on busy after a device disconnects * (macOS) Fixed a crash trying to change shared directory for Apple VM (#4271) * (macOS) Wizard created invalid target configuration for virtualized targets (#4274) ## Changes (v4.0.0) * USB redirection support in terminal mode * Configuration file format changed, newly saved VMs will not be compatible with older versions of UTM * Newly imported disk images will be converted to QCOW2 automatically * Settings: new layout with support for multiple {Display, Serial, Network, Sound} devices (#3585) * Support multiple displays (#220) * Added Japanese localization (thanks @MMP0) * Support adding PTTY (macOS only), TCP client, and TCP server serial connections for QEMU machines (address should show up in the home screen) (#3546) * Support headless display (remove all displays and built-in serial ports in the settings) (#2280) * Support redirecting QEMU monitor and GDB stub to a serial port * Support zstd compression for QCOW2 images and use zstd as default for image compression (#4211) * Update ANGLE (GL backend) to latest git commit * Added French localization (thanks @FRtranslator) * Fixed microphone recording silence (#219) * Fixed a crash when attempting to delete a QEMU additional argument * Option in VM settings to use virtfs/9pfs for file sharing (#2184) * Option in VM settings to change VGA RAM size (#4034) * Option in VM settings to enable virtio-balloon driver (#4136) * Invert mouse scrolling is now a global setting rather than a per-vm configuration option * (iOS) Replaced hterm.js with SwiftTerm for terminal mode (#3473) * (iOS) Attach to JitStreamer (set IP address in Settings app and UTM will try to connect automatically on launch) (thanks @ktprograms) * (iOS) Automatically resize the display to fit the screen when the resolution changes if the resize toolbar option is used * (iOS) Reimplemented the USB and Drives menu with a better UI * (iOS) On iPadOS 16, show the menu bar when holding Cmd on the keyboard. On previous versions, an on-screen help will show supported commands * (iOS) Improved audio handling including: output when on silence, mixing with other apps, working when both recording and outputting (including with another app) (#3996) * (iOS) Added a global setting to always prefer the built-in microphone to a bluetooth microphone * (macOS) Fixed running from shortcut in Apple VMs (no longer need to re-import after each launch) * (macOS) Improved IPSW selection interface and support drag and drop (thanks @pointum) * (macOS) Fixed running unsigned builds * (macOS) Removed some deprecated global settings * (macOS) Fixed an error when trying to download an IPSW and the Caches directory does not exist (thanks @LostInCompilation) * (macOS) Fixed an issue where a VM could be started twice if the home screen's toolbar is used leading to data corruption (#4166) * (macOS 13+) Boot into recoveryOS (to disable SIP, etc) by right clicking on the VM and selecting "Run in recovery..." (#3526) * (macOS 13+) Option in VM settings to enable Rosetta for x86_64 emulation (#4100) * (macOS 13+) Option in VM settings to enable clipboard sharing (SPICE support needed on the guest) (#4121) * (macOS 13+) GUI display for Linux VMs (#4120) * (macOS 13+) Add removable drives, will show up as USB mass storage ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ### Known Issues * Automation URL commands currently do not work completely * (macOS) GUI Linux boot may not be compatible with all distros. Ubuntu Server 22.04 does not install. * (macOS) You cannot reopen a window for additional displays after you close them [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

**Remember to back up your VMs before running a beta release of UTM!** ## Installation **iOS**: Visit [https://getutm.app/install/][1] for the most up to date installation instructions. **macOS**: Download "UTM.dmg" below and copy the contents to your `/Applications` directory. ## Highlights * **Multiple display and headless display is now supported for QEMU machines.** You can configure 0 or more displays as well as 0 or more builtin terminal consoles. On macOS, a new window will be created for each display and builtin terminal. On iOS, you can create multiple windows (iPad) as well as plug in an external display or AirPlay (iPad or iPhone) and assign outputs to each window. * **Ventura updates to Virtualization.** macOS Ventura introduces new features to Virtualization.framework that is now integrated into UTM. You can now create GUI Linux VMs with EFI boot. Clipboard sharing and directory sharing now works with macOS Ventura guests. Rosetta x86_64 emulation is supported for Linux VMs on Apple Silicon. * **Virtiofs sharing for QEMU.** This can be enabled in the VM settings under Sharing. You can mount the tag "share" in the VM. Note that macOS UID are numbered differently than Linux so you may need to set up your guest to have permission to access the shared directory. ## Notes * **iOS 14 and macOS 11.3** are the new minimum supported systems. Please use UTM v3.x for support down to iOS 11 and macOS 11 * The configuration backend has been massively rewritten. **Please backup all VMs prior to updating as you will not be able to re-open VMs saved by UTM v4 on older versions of UTM if you decide to downgrade.** ## Changes (v4.0.1) * Fixed an issue where an UEFI BIOS error was reported when the target does not use UEFI (#4265) * Added Elementary OS icon (thanks @Unbinilium) * Updated ja localization (thanks @MMP0) * Updated fr localization (thanks @FRtranslator) * Changed the icon for "Serial" so it appears on iOS 14 and macOS 11 as well * Fixed custom icon not showing up for "legacy" configurations * Fixed an error trying to migrate "legacy" configuration when "Images" does not exist (#4266) * Fixed USB redirection (#4263) * (iOS) Fixed a toolbar issue where USB button overflowed on screen. * (iOS) Fixed resume button not appearing on < iOS 16 * (iOS) Attempt to close the download progress pop-up after download completes (#4261) * (iOS) "Open" popover refuses to show up again after swiping down (#4260) * (iOS) Hide "Add" text on iOS 14 settings * (iOS) Fixed crash on iOS 14 settings when attempting to use the picker (#4270) * (iOS) Fixed an issue on iOS 14 where picker selection was being reset * (iOS) Fixed an issue where the USB icon is stuck on busy after a device disconnects * (macOS) Fixed a crash trying to change shared directory for Apple VM (#4271) * (macOS) Wizard created invalid target configuration for virtualized targets (#4274) ## Changes (v4.0.0) * USB redirection support in terminal mode * Configuration file format changed, newly saved VMs will not be compatible with older versions of UTM * Newly imported disk images will be converted to QCOW2 automatically * Settings: new layout with support for multiple {Display, Serial, Network, Sound} devices (#3585) * Support multiple displays (#220) * Added Japanese localization (thanks @MMP0) * Support adding PTTY (macOS only), TCP client, and TCP server serial connections for QEMU machines (address should show up in the home screen) (#3546) * Support headless display (remove all displays and built-in serial ports in the settings) (#2280) * Support redirecting QEMU monitor and GDB stub to a serial port * Support zstd compression for QCOW2 images and use zstd as default for image compression (#4211) * Update ANGLE (GL backend) to latest git commit * Added French localization (thanks @FRtranslator) * Fixed microphone recording silence (#219) * Fixed a crash when attempting to delete a QEMU additional argument * Option in VM settings to use virtfs/9pfs for file sharing (#2184) * Option in VM settings to change VGA RAM size (#4034) * Option in VM settings to enable virtio-balloon driver (#4136) * Invert mouse scrolling is now a global setting rather than a per-vm configuration option * (iOS) Replaced hterm.js with SwiftTerm for terminal mode (#3473) * (iOS) Attach to JitStreamer (set IP address in Settings app and UTM will try to connect automatically on launch) (thanks @ktprograms) * (iOS) Automatically resize the display to fit the screen when the resolution changes if the resize toolbar option is used * (iOS) Reimplemented the USB and Drives menu with a better UI * (iOS) On iPadOS 16, show the menu bar when holding Cmd on the keyboard. On previous versions, an on-screen help will show supported commands * (iOS) Improved audio handling including: output when on silence, mixing with other apps, working when both recording and outputting (including with another app) (#3996) * (iOS) Added a global setting to always prefer the built-in microphone to a bluetooth microphone * (macOS) Fixed running from shortcut in Apple VMs (no longer need to re-import after each launch) * (macOS) Improved IPSW selection interface and support drag and drop (thanks @pointum) * (macOS) Fixed running unsigned builds * (macOS) Removed some deprecated global settings * (macOS) Fixed an error when trying to download an IPSW and the Caches directory does not exist (thanks @LostInCompilation) * (macOS) Fixed an issue where a VM could be started twice if the home screen's toolbar is used leading to data corruption (#4166) * (macOS 13+) Boot into recoveryOS (to disable SIP, etc) by right clicking on the VM and selecting "Run in recovery..." (#3526) * (macOS 13+) Option in VM settings to enable Rosetta for x86_64 emulation (#4100) * (macOS 13+) Option in VM settings to enable clipboard sharing (SPICE support needed on the guest) (#4121) * (macOS 13+) GUI display for Linux VMs (#4120) * (macOS 13+) Add removable drives, will show up as USB mass storage ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ### Known Issues * Automation URL commands currently do not work completely * Removable drive saving and configuration are not completely working for Apple VMs * (iOS) VM display state (zoom level, keyboard show/hide, etc) are not saved * (macOS) GUI Linux boot may not be compatible with all distros. Ubuntu Server 22.04 does not install. * (macOS) You cannot reopen a window for additional displays after you close them [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

**Remember to back up your VMs before running a beta release of UTM!** ## Installation **iOS**: Visit [https://getutm.app/install/][1] for the most up to date installation instructions. **macOS**: Download "UTM.dmg" below and copy the contents to your `/Applications` directory. ## Highlights * **Multiple display and headless display is now supported for QEMU machines.** You can configure 0 or more displays as well as 0 or more builtin terminal consoles. On macOS, a new window will be created for each display and builtin terminal. On iOS, you can create multiple windows (iPad) as well as plug in an external display or AirPlay (iPad or iPhone) and assign outputs to each window. * **Ventura updates to Virtualization.** macOS Ventura introduces new features to Virtualization.framework that is now integrated into UTM. You can now create GUI Linux VMs with EFI boot. Clipboard sharing and directory sharing now works with macOS Ventura guests. Rosetta x86_64 emulation is supported for Linux VMs on Apple Silicon. * **Virtiofs sharing for QEMU.** This can be enabled in the VM settings under Sharing. You can mount the tag "share" in the VM. Note that macOS UID follow a different format than Linux so you may need to set up your guest to have permission to access the shared directory. ## Notes * **iOS 14 and macOS 11.3** are the new minimum supported systems. Please use UTM v3.x for support down to iOS 11 and macOS 11 * The configuration backend has been massively rewritten and the new configuration format will not work on older versions of UTM. **Please backup all VMs prior to updating as you will not be able to re-open them after using UTM v4.** ## Changes (v4.0.0) * USB redirection support in terminal mode * Configuration file format changed, newly saved VMs will not be compatible with older versions of UTM * Newly imported disk images will be converted to QCOW2 automatically * Settings: new layout with support for multiple {Display, Serial, Network, Sound} devices (#3585) * Support multiple displays (#220) * Added Japanese localization (thanks @MMP0) * Support adding PTTY (macOS only), TCP client, and TCP server serial connections for QEMU machines (address should show up in the home screen) (#3546) * Support headless display (remove all displays and built-in serial ports in the settings) (#2280) * Support redirecting QEMU monitor and GDB stub to a serial port * Support zstd compression for QCOW2 images and use zstd as default for image compression (#4211) * Update ANGLE (GL backend) to latest git commit * Added French localization (thanks @FRtranslator) * Fixed microphone recording silence (#219) * Fixed a crash when attempting to delete a QEMU additional argument * Option in VM settings to use virtfs/9pfs for file sharing (#2184) * Option in VM settings to change VGA RAM size (#4034) * Option in VM settings to enable virtio-balloon driver (#4136) * Invert mouse scrolling is now a global setting rather than a per-vm configuration option * (iOS) Replaced hterm.js with SwiftTerm for terminal mode (#3473) * (iOS) Attach to JitStreamer (set IP address in Settings app and UTM will try to connect automatically on launch) (thanks @ktprograms) * (iOS) Automatically resize the display to fit the screen when the resolution changes if the resize toolbar option is used * (iOS) Reimplemented the USB and Drives menu with a better UI * (iOS) On iPadOS 16, show the menu bar when holding Cmd on the keyboard. On previous versions, an on-screen help will show supported commands * (iOS) Improved audio handling including: output when on silence, mixing with other apps, working when both recording and outputting (including with another app) (#3996) * (iOS) Added a global setting to always prefer the built-in microphone to a bluetooth microphone * (macOS) Fixed running from shortcut in Apple VMs (no longer need to re-import after each launch) * (macOS) Improved IPSW selection interface and support drag and drop (thanks @pointum) * (macOS) Fixed running unsigned builds * (macOS) Removed some deprecated global settings * (macOS) Fixed an error when trying to download an IPSW and the Caches directory does not exist (thanks @LostInCompilation) * (macOS) Fixed an issue where a VM could be started twice if the home screen's toolbar is used leading to data corruption (#4166) * (macOS 13+) Boot into recoveryOS (to disable SIP, etc) by right clicking on the VM and selecting "Run in recovery..." (#3526) * (macOS 13+) Option in VM settings to enable Rosetta for x86_64 emulation (#4100) * (macOS 13+) Option in VM settings to enable clipboard sharing (SPICE support needed on the guest) (#4121) * (macOS 13+) GUI display for Linux VMs (#4120) * (macOS 13+) Add removable drives, will show up as USB mass storage ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ### Known Issues * Automation URL commands currently do not work completely * Removable drive saving and configuration are not completely working for Apple VMs * (iOS) VM display state (zoom level, keyboard show/hide, etc) are not saved * (macOS) GUI Linux boot may not be compatible with all distros. Ubuntu Server 22.04 does not install. * (macOS) You cannot reopen a window for additional displays after you close them [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

## Installation **iOS**: Visit [https://getutm.app/install/][1] for the most up to date installation instructions. **macOS**: Download "UTM.dmg" below and copy the contents to your `/Applications` directory. ## Highlights * **QEMU 7.0.0**: The backend has been updated to the latest release. Check out https://www.qemu.org/2022/04/19/qemu-7-0-0/ for more details. Additionally, other backend components such as SPICE GTK, libusbredir, and more have also been updated. * **Reclaiming space**: the host will attempt to TRIM any page of all zeros when committed to the QCOW2 disk image. Additionally, a new button in disk settings will allow you to re-convert a disk image to reclaim space (of all-zero pages) as well as compress an existing disk image (macOS 12+ only). Note compression is only done statically which means when the guest modifies a sector, it will be stored uncompressed just like before. * **Disposable mode**: right click/long press on a QEMU VM and select "Run without saving changes" to start VM in "disposable mode." In this mode, changes will not be saved to disk and will be discarded once the VM is stopped. (thanks @ktprograms) ## Notes * Reminder: for troubleshooting common Windows install issues (such as no networking), please check out the [guide](https://mac.getutm.app/gallery/windows-10) or [this guide](https://mac.getutm.app/gallery/ubuntu-20-04) for Ubuntu install issues. * If you manually added `highmem=on` or `highmem=off` to your QEMU Machine Properties as a workaround to issues in a previous release, please remove it. * (iOS) **UTM v3.2.x will be the last update to support iOS 11-13.** If you are still running those versions, please make sure you report any issues now so they can be fixed by the final release of v3.2.x. After that, iOS 14+ will be required to run future versions of UTM. ## Changes (v3.2.4) * Fixed isolated network mode with new vmnet backend (#4022) * Fixed some USB devices not showing up for USB capture (#3975) * (iOS) Added tap to click with Apple Pencil (thanks @luken11) * (macOS) Workaround a SwiftUI freeze then crash in the home view when the scrollbar is visible (#3612) * (macOS) Fixed an error loading Apple Virtualization VMs after updating from macOS 11 to macOS 12 (#4023) * (macOS) Fixed secondary click using Control+Click on the VM list (#4018) ## Changes (v3.2.3) * Disabled screenshots for GL virtual machines (workaround for a crash that occurs, this will be re-enabled in a future update once the crash is triaged) * (iOS) Pass through Esc key on external keyboard when VoiceOver is in use (#3940) * (macOS) Use correct scaling when HiDPI is enabled (#3968) * (macOS) Fix toolbar overlapping top of screen when "Automatically hide and show the menu bar in full screen" is unchecked in system preferences (#3919) * (macOS) When bridged networking is selected, default the interface to "en0" (#3945) * (macOS) Wizard: clarify that Linux kernel and initrd must be uncompressed if Apple Virtualization is used ## Changes (v3.2.2) * Add "disposable mode" (see highlights for more information) (thanks @ktprograms) * Do not enable UEFI for unsupported architectures (#3976) * Fix broken play button in sidebar (#3980) * Fix "Error -1 while loading VM state" on resume caused by usbredir (#3979) * Various UI tweaks and typo fixes (#3984) * Fixed pausing without saving state * Fixed showing warning prompt when VM is paused but not saved * (iOS) Detect if UTM is installed without AltStore and AltJIT will not attempt to be used. * (iOS) Reduced build size by 10% (thanks @Halo-Michael) (#3934) * (macOS) Add new preference option to revert Caps Lock behaviour to pre 3.2.0 (#3974) ## Changes (v3.2.1) * Fixed boot of RISC-V virt platform (thanks @wegank) * Remove `highmem=off` default property which is no longer needed on macOS 12.4+ and iOS 15.5+ (it will still be used on lower versions) (#3941, #3946) * Caps lock state will now be synchronized when mouse is captured (note that if mouse is captured before the guest OS has booted up, the state will be out of sync) (#3415) * Re-introduce option to disable auto-resolution when SPICE tools is installed (#3938) * When discarding unsaved settings, do not delete any disk image not created by UTM (#3587) * Fix downloading of UTM zip files when the URL does not end in ".zip" (#3953) * (macOS) When importing a disk image, do not silently overwrite an existing image of the same name (#3866) * (macOS) Added option to reclaim unused space from disk image and to compress a disk image (macOS 12+ only) * (macOS) On the VM list, the start button will now change to a spinner when the VM is starting and will disappear when the VM has started. Also added the ability to start/show a VM by double-clicking on the list item (#3885) ## Changes (v3.2.0) * Checkbox for "Import VHDX Image" in the wizard now works correctly again (#3760) * Fixed various crashes in SPICE webdavd share has been resolved thanks to updated backend (#3633) * Removed "cache=writethrough" argument from block devices since it was added to workaround an issue with VHDX images which we now convert to QCOW2 * Added "discard=unmap,detect-zeroes=unmap" argument to block devices to reclaim unused space (#3460) * When "do not save screenshot to disk" is enabled, any existing screenshot will be deleted the next time the VM is started (#3936) * Fixed an issue in QEMU additional arguments where it sometimes would not appear after setting it (#3895) * Fixed RNG device not appearing in console mode even when enabled in the settings (#3790) * Added support for up to 5 additional mouse buttons (you may need to re-map them in the guest OS as they are automatically set to middle/up/down/side/extra) (#3906) * (iOS) Fixed an issue in the legacy view where "invalid identifier" error may show up on a newly created VM (#3872) * (macOS) Fixed crash when changing display settings while the VM window is open (but stopped) (#3925) * (macOS) Fixed crash when trying to select "Share..." in context menu (#3915) * (macOS) Prevent allowing rapid clicking of pause/resume which may lead to VM corruption (#3629) * (macOS) Show progress indicator while VM is saving to prevent user from terminating the app early and cause corruption (#3752) * (macOS) Block unsupported Apple USB devices from being captured (#3759) ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ### Known Issues * iOS 14 and below: There is a known issue crashing while running under taurine but not unc0ver. (#3628) [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

## Installation **iOS**: Visit [https://getutm.app/install/][1] for the most up to date installation instructions. **macOS**: Download "UTM.dmg" below and copy the contents to your `/Applications` directory. ## Highlights * **QEMU 7.0.0**: The backend has been updated to the latest release. Check out https://www.qemu.org/2022/04/19/qemu-7-0-0/ for more details. Additionally, other backend components such as SPICE GTK, libusbredir, and more have also been updated. * **Reclaiming space**: the host will attempt to TRIM any page of all zeros when committed to the QCOW2 disk image. Additionally, a new button in disk settings will allow you to re-convert a disk image to reclaim space (of all-zero pages) as well as compress an existing disk image (macOS 12+ only). Note compression is only done statically which means when the guest modifies a sector, it will be stored uncompressed just like before. * **Disposable mode**: right click/long press on a QEMU VM and select "Run without saving changes" to start VM in "disposable mode." In this mode, changes will not be saved to disk and will be discarded once the VM is stopped. (thanks @ktprograms) ## Notes * Reminder: for troubleshooting common Windows install issues (such as no networking), please check out the [guide](https://mac.getutm.app/gallery/windows-10). * If you manually added `highmem=on` or `highmem=off` to your QEMU Machine Properties as a workaround to issues in a previous release, please remove it. * (iOS) **UTM v3.2.x will be the last update to support iOS 11-13.** If you are still running those versions, please make sure you report any issues now so they can be fixed by the final release of v3.2.x. After that, iOS 14+ will be required to run future versions of UTM. ## Changes (v3.2.3) * Disabled screenshots for GL virtual machines (workaround for a crash that occurs, this will be re-enabled in a future update once the crash is triaged) * (iOS) Pass through Esc key on external keyboard when VoiceOver is in use (#3940) * (macOS) Use correct scaling when HiDPI is enabled (#3968) * (macOS) Fix toolbar overlapping top of screen when "Automatically hide and show the menu bar in full screen" is unchecked in system preferences (#3919) * (macOS) When bridged networking is selected, default the interface to "en0" (#3945) * (macOS) Wizard: clarify that Linux kernel and initrd must be uncompressed if Apple Virtualization is used ## Changes (v3.2.2) * Add "disposable mode" (see highlights for more information) (thanks @ktprograms) * Do not enable UEFI for unsupported architectures (#3976) * Fix broken play button in sidebar (#3980) * Fix "Error -1 while loading VM state" on resume caused by usbredir (#3979) * Various UI tweaks and typo fixes (#3984) * Fixed pausing without saving state * Fixed showing warning prompt when VM is paused but not saved * (iOS) Detect if UTM is installed without AltStore and AltJIT will not attempt to be used. * (iOS) Reduced build size by 10% (thanks @Halo-Michael) (#3934) * (macOS) Add new preference option to revert Caps Lock behaviour to pre 3.2.0 (#3974) ## Changes (v3.2.1) * Fixed boot of RISC-V virt platform (thanks @wegank) * Remove `highmem=off` default property which is no longer needed on macOS 12.4+ and iOS 15.5+ (it will still be used on lower versions) (#3941, #3946) * Caps lock state will now be synchronized when mouse is captured (note that if mouse is captured before the guest OS has booted up, the state will be out of sync) (#3415) * Re-introduce option to disable auto-resolution when SPICE tools is installed (#3938) * When discarding unsaved settings, do not delete any disk image not created by UTM (#3587) * Fix downloading of UTM zip files when the URL does not end in ".zip" (#3953) * (macOS) When importing a disk image, do not silently overwrite an existing image of the same name (#3866) * (macOS) Added option to reclaim unused space from disk image and to compress a disk image (macOS 12+ only) * (macOS) On the VM list, the start button will now change to a spinner when the VM is starting and will disappear when the VM has started. Also added the ability to start/show a VM by double-clicking on the list item (#3885) ## Changes (v3.2.0) * Checkbox for "Import VHDX Image" in the wizard now works correctly again (#3760) * Fixed various crashes in SPICE webdavd share has been resolved thanks to updated backend (#3633) * Removed "cache=writethrough" argument from block devices since it was added to workaround an issue with VHDX images which we now convert to QCOW2 * Added "discard=unmap,detect-zeroes=unmap" argument to block devices to reclaim unused space (#3460) * When "do not save screenshot to disk" is enabled, any existing screenshot will be deleted the next time the VM is started (#3936) * Fixed an issue in QEMU additional arguments where it sometimes would not appear after setting it (#3895) * Fixed RNG device not appearing in console mode even when enabled in the settings (#3790) * Added support for up to 5 additional mouse buttons (you may need to re-map them in the guest OS as they are automatically set to middle/up/down/side/extra) (#3906) * (iOS) Fixed an issue in the legacy view where "invalid identifier" error may show up on a newly created VM (#3872) * (macOS) Fixed crash when changing display settings while the VM window is open (but stopped) (#3925) * (macOS) Fixed crash when trying to select "Share..." in context menu (#3915) * (macOS) Prevent allowing rapid clicking of pause/resume which may lead to VM corruption (#3629) * (macOS) Show progress indicator while VM is saving to prevent user from terminating the app early and cause corruption (#3752) * (macOS) Block unsupported Apple USB devices from being captured (#3759) ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ### Known Issues * iOS 14 and below: There is a known issue crashing while running under taurine but not unc0ver. (#3628) [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

## Installation **iOS**: Visit [https://getutm.app/install/][1] for the most up to date installation instructions. **macOS**: Download "UTM.dmg" below and copy the contents to your `/Applications` directory. ## Highlights * **QEMU 7.0.0**: The backend has been updated to the latest release. Check out https://www.qemu.org/2022/04/19/qemu-7-0-0/ for more details. Additionally, other backend components such as SPICE GTK, libusbredir, and more have also been updated. * **Reclaiming space**: the host will attempt to TRIM any page of all zeros when committed to the QCOW2 disk image. Additionally, a new button in disk settings will allow you to re-convert a disk image to reclaim space (of all-zero pages) as well as compress an existing disk image (macOS 12+ only). Note compression is only done statically which means when the guest modifies a sector, it will be stored uncompressed just like before. * **Disposable mode**: right click/long press on a QEMU VM and select "Run without saving changes" to start VM in "disposable mode." In this mode, changes will not be saved to disk and will be discarded once the VM is stopped. (thanks @ktprograms) ## Notes * (iOS) **UTM v3.2.x will be the last update to support iOS 11-13.** If you are still running those versions, please make sure you report any issues now so they can be fixed by the final release of v3.2.x. After that, iOS 14+ will be required to run future versions of UTM. * In v3.2.0, if you added `highmem=on` to your QEMU Machine Properties as a workaround, please remove it after updating. If you did not use v3.2.0, you can ignore this. ## Changes (v3.2.2) * Add "disposable mode" (see highlights for more information) (thanks @ktprograms) * Do not enable UEFI for unsupported architectures (#3976) * Fix broken play button in sidebar (#3980) * Fix "Error -1 while loading VM state" on resume caused by usbredir (#3979) * Various UI tweaks and typo fixes (#3984) * Fixed pausing without saving state * Fixed showing warning prompt when VM is paused but not saved * (iOS) Detect if UTM is installed without AltStore and AltJIT will not attempt to be used. * (iOS) Reduced build size by 10% (thanks @Halo-Michael) (#3934) * (macOS) Add new preference option to revert Caps Lock behaviour to pre 3.2.0 (#3974) ## Changes (v3.2.1) * Fixed boot of RISC-V virt platform (thanks @wegank) * Remove `highmem=off` default property which is no longer needed on macOS 12.4+ and iOS 15.5+ (it will still be used on lower versions) (#3941, #3946) * Caps lock state will now be synchronized when mouse is captured (note that if mouse is captured before the guest OS has booted up, the state will be out of sync) (#3415) * Re-introduce option to disable auto-resolution when SPICE tools is installed (#3938) * When discarding unsaved settings, do not delete any disk image not created by UTM (#3587) * Fix downloading of UTM zip files when the URL does not end in ".zip" (#3953) * (macOS) When importing a disk image, do not silently overwrite an existing image of the same name (#3866) * (macOS) Added option to reclaim unused space from disk image and to compress a disk image (macOS 12+ only) * (macOS) On the VM list, the start button will now change to a spinner when the VM is starting and will disappear when the VM has started. Also added the ability to start/show a VM by double-clicking on the list item (#3885) ## Changes (v3.2.0) * Checkbox for "Import VHDX Image" in the wizard now works correctly again (#3760) * Fixed various crashes in SPICE webdavd share has been resolved thanks to updated backend (#3633) * Removed "cache=writethrough" argument from block devices since it was added to workaround an issue with VHDX images which we now convert to QCOW2 * Added "discard=unmap,detect-zeroes=unmap" argument to block devices to reclaim unused space (#3460) * When "do not save screenshot to disk" is enabled, any existing screenshot will be deleted the next time the VM is started (#3936) * Fixed an issue in QEMU additional arguments where it sometimes would not appear after setting it (#3895) * Fixed RNG device not appearing in console mode even when enabled in the settings (#3790) * Added support for up to 5 additional mouse buttons (you may need to re-map them in the guest OS as they are automatically set to middle/up/down/side/extra) (#3906) * (iOS) Fixed an issue in the legacy view where "invalid identifier" error may show up on a newly created VM (#3872) * (macOS) Fixed crash when changing display settings while the VM window is open (but stopped) (#3925) * (macOS) Fixed crash when trying to select "Share..." in context menu (#3915) * (macOS) Prevent allowing rapid clicking of pause/resume which may lead to VM corruption (#3629) * (macOS) Show progress indicator while VM is saving to prevent user from terminating the app early and cause corruption (#3752) * (macOS) Block unsupported Apple USB devices from being captured (#3759) ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ### Known Issues * iOS 14 and below: There is a known issue crashing while running under taurine but not unc0ver. (#3628) [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

## Installation **iOS**: Visit [https://getutm.app/install/][1] for the most up to date installation instructions. **macOS**: Download "UTM.dmg" below and copy the contents to your `/Applications` directory. ## Highlights * **QEMU 7.0.0**: The backend has been updated to the latest release. Check out https://www.qemu.org/2022/04/19/qemu-7-0-0/ for more details. Additionally, other backend components such as SPICE GTK, libusbredir, and more have also been updated. * **Reclaiming space**: the host will attempt to TRIM any page of all zeros when committed to the QCOW2 disk image. Additionally, a new button in disk settings will allow you to re-convert a disk image to reclaim space (of all-zero pages) as well as compress an existing disk image (macOS 12+ only). Note compression is only done statically which means when the guest modifies a sector, it will be stored uncompressed just like before. ## Notes * (iOS) **UTM v3.2.x will be the last update to support iOS 11-13.** If you are still running those versions, please make sure you report any issues now so they can be fixed by the final release of v3.2.x. After that, iOS 14+ will be required to run future versions of UTM. * In v3.2.0, if you added `highmem=on` to your QEMU Machine Properties as a workaround, please remove it after updating. If you did not use v3.2.0, you can ignore this. ## Changes (v3.2.1) * Fixed boot of RISC-V virt platform (thanks @wegank) * Remove `highmem=off` default property which is no longer needed on macOS 12.4+ and iOS 15.5+ (it will still be used on lower versions) (#3941, #3946) * Caps lock state will now be synchronized when mouse is captured (note that if mouse is captured before the guest OS has booted up, the state will be out of sync) (#3415) * Re-introduce option to disable auto-resolution when SPICE tools is installed (#3938) * When discarding unsaved settings, do not delete any disk image not created by UTM (#3587) * Fix downloading of UTM zip files when the URL does not end in ".zip" (#3953) * (macOS) When importing a disk image, do not silently overwrite an existing image of the same name (#3866) * (macOS) Added option to reclaim unused space from disk image and to compress a disk image (macOS 12+ only) * (macOS) On the VM list, the start button will now change to a spinner when the VM is starting and will disappear when the VM has started. Also added the ability to start/show a VM by double-clicking on the list item (#3885) ## Changes (v3.2.0) * Checkbox for "Import VHDX Image" in the wizard now works correctly again (#3760) * Fixed various crashes in SPICE webdavd share has been resolved thanks to updated backend (#3633) * Removed "cache=writethrough" argument from block devices since it was added to workaround an issue with VHDX images which we now convert to QCOW2 * Added "discard=unmap,detect-zeroes=unmap" argument to block devices to reclaim unused space (#3460) * When "do not save screenshot to disk" is enabled, any existing screenshot will be deleted the next time the VM is started (#3936) * Fixed an issue in QEMU additional arguments where it sometimes would not appear after setting it (#3895) * Fixed RNG device not appearing in console mode even when enabled in the settings (#3790) * Added support for up to 5 additional mouse buttons (you may need to re-map them in the guest OS as they are automatically set to middle/up/down/side/extra) (#3906) * (iOS) Fixed an issue in the legacy view where "invalid identifier" error may show up on a newly created VM (#3872) * (macOS) Fixed crash when changing display settings while the VM window is open (but stopped) (#3925) * (macOS) Fixed crash when trying to select "Share..." in context menu (#3915) * (macOS) Prevent allowing rapid clicking of pause/resume which may lead to VM corruption (#3629) * (macOS) Show progress indicator while VM is saving to prevent user from terminating the app early and cause corruption (#3752) * (macOS) Block unsupported Apple USB devices from being captured (#3759) ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ### Known Issues * iOS 14 and below: There is a known issue crashing while running under taurine but not unc0ver. (#3628) [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

## Installation **iOS**: Visit [https://getutm.app/install/][1] for the most up to date installation instructions. **macOS**: Download "UTM.dmg" below and copy the contents to your `/Applications` directory. ## Highlights * **QEMU 7.0.0***: The backend has been updated to the latest release. Check out https://www.qemu.org/2022/04/19/qemu-7-0-0/ for more details. Additionally, other backend components such as SPICE GTK, libusbredir, and more have also been updated. ## Notes * (iOS) **UTM v3.2.x will be the last update to support iOS 11-13.** If you are still running those versions, please make sure you report any issues now so they can be fixed by the final release of v3.2.x. After that, iOS 14+ will be required to run future versions of UTM. ## Changes (v3.2.0) * Checkbox for "Import VHDX Image" in the wizard now works correctly again (#3760) * Fixed various crashes in SPICE webdavd share has been resolved thanks to updated backend (#3633) * Removed "cache=writethrough" argument from block devices since it was added to workaround an issue with VHDX images which we now convert to QCOW2 * Added "discard=unmap,detect-zeroes=unmap" argument to block devices to reclaim unused space (#3460) * When "do not save screenshot to disk" is enabled, any existing screenshot will be deleted the next time the VM is started (#3936) * Fixed an issue in QEMU additional arguments where it sometimes would not appear after setting it (#3895) * Fixed RNG device not appearing in console mode even when enabled in the settings (#3790) * Added support for up to 5 additional mouse buttons (you may need to re-map them in the guest OS as they are automatically set to middle/up/down/side/extra) (#3906) * (iOS) Fixed an issue in the legacy view where "invalid identifier" error may show up on a newly created VM (#3872) * (macOS) Fixed crash when changing display settings while the VM window is open (but stopped) (#3925) * (macOS) Fixed crash when trying to select "Share..." in context menu (#3915) * (macOS) Prevent allowing rapid clicking of pause/resume which may lead to VM corruption (#3629) * (macOS) Show progress indicator while VM is saving to prevent user from terminating the app early and cause corruption (#3752) * (macOS) Block unsupported Apple USB devices from being captured (#3759) ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ### Known Issues * iOS 14 and below: There is a known issue crashing while running under taurine but not unc0ver. (#3628) * Starting a VM shows an empty "Error" dialog. This will be fixed in the next release. A workaround is to add `highmem=on` to "QEMU -> QEMU Machine Properties". [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

*Note: This is the same as v3.1.4 but with a fix for boot issues with the latest Linux kernel.* ## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Highlights * Store .utm bundles anywhere on disk (including on external drives) and import them as a shortcut. See notes below for some limitations. * Wizard redesign (thanks @js-john) * Various UI tweaks, fixes, and improvements (thanks @j-f1). Note that some settings have moved to different categories * Overhaul of the UTM backend which should improve application stability ## Notes * (iOS) **UTM v3.1.x will be the last update to support iOS 11 and iOS 12.** If you are still running those versions, please make sure you report any issues now so they can be fixed by the final release of v3.1.x. After that, iOS 13+ will be required to run future versions of UTM. * You can now run .utm files stored anywhere. There are a few caveats: First, all newly created VMs will still be created in the default storage (app sandbox). You can move the VM after creation with the new button on the toolbar or by right clicking (or force touch) on the VM entry and selecting "Move..." Second, when VM shortcuts are deleted, the underlying data is unaffected, and shortcuts are automatically deleted when they are no longer valid (for example, the .utm was moved). You can re-import the .utm by either double clicking it from Finder, or using "File -> Import Virtual Machine..." Finally, Apple VMs do not support persistent shortcuts, which means the shortcut is *always* deleted after UTM quits. This means you must re-import Apple VMs every time UTM is launched. * Default machine properties will now always be included *unless* explicitly set to another value in QEMU settings. For example, if you are booting an aarch64 virt machine, the property `highmem=off` will be appended unless the user specifies `highmem=on` in QEMU settings. Previously, when you select `virt` in VM settings, the machine properties text box will auto populate with `highmem=off`. If the user deletes it, then the VM will not boot because it requires `highmem=off`. Advanced users can still specify `highmem=on` and it will not be overridden. ## Changes (v3.1.5) * Fixed latest Linux kernel failing to boot (“EFI stub: Exiting boot services and installing virtual address map...”) (thanks @agraf for the fix) (#2682) * Fixed freezing during restart of a GL VM (#3746) * Clarified that clipboard sharing and auto resolution features are the same setting (#3748) ## Changes (v3.1.4) * The changes to behaviour of “legacy input” introduced in v3.1.2 is now disabled by default for all existing (x86_64) virtual machines. For new virtual machines, the default is still to disable PS/2 bus when USB is enabled. However, this can be overridden with a new tweak “Force PS/2 Controller” in the QEMU settings. (#3723) * The computed size for shortcut VMs is properly calculated and saving shorting VM settings works (#3724) * "Error: Use -machine help to list supported machines" shows up when starting a newly created virtualized VM (#3722) * Updated zh-Hans translation (thanks @js-john) * (iOS 11-13) Default UEFI boot to off because we do not have any UI to change it ## Changes (v3.1.3) * *Hotfix*: An earlier release of v3.1.3 had a bug which prevented newly created VMs from booting, this has now been fixed * Use QCOW2 format for EFI variables on newly created variables image. This enables suspend state to work on EFI enabled VMs again (unless suspend fails for other unsupported devices). Note: existing VMs should delete the EFI variables drive from VM Settings in order for UTM to recreate it as QCOW2. * The busy spinner gets suck during startup or shutdown (#3702) * Boots Windows ARM emulation with QEMU TCG by adding `virtualization=on` machine property (#3703) * Default machine properties will always be included *unless* explicitly set to another value in QEMU settings. (See notes above.) * Various UI tweaks, fixes, and improvements (thanks @j-f1). Note that some settings have moved to different categories. * Fixed "Failed to create new bookmark" when trying to launch a VM shortcut * Automatically de-toggle UEFI boot tweak on unsupported targets * Fixed a situation that caused UTM to crash randomly (#3515) * (iOS 14) Toolbar had large overlapping icons on compact devices ## Changes (v3.1.2) * Fixed leaking of location data in debug.log (#3667) * Console mode settings for colours are slightly off from the picker values. This has been fixed by using P3 space hex values. * Retain ordering of VM list when using move, clone, and edit operations * Show "unavailable" VMs when a shortcut is unaccessible due to the VM being deleted or an external drive not being mounted. No longer deletes these shortcuts by default (#3686) * Support importing multiple .utm at once (#3685) * Rename "import" menu to "open" to reflect the new behaviour of creating a shortcut by default. Add the "open" option to the first page of the wizard as well so iOS users can access it * New context menu option "New from template..." can be called to duplicate the settings of an existing QEMU VM without the data (#2339) * Fixed a UI issue where an error message makes the VM stuck in "busy" state * Disable PS/2 keyboard/mouse when "legacy input" is off. Renamed "legacy input" to USB mode to make more explicit that when it is off, a USB bus is emulated with the input controls there (#3674) * Moved USB sharing options to Input tab to consolidate USB settings * (iOS) Fixed launching on < iOS 15 (except with taurine, which is still broken for different reasons) * (iOS) Fix saving last display origin and scale (#3669) * Option to use UTC vs localtime (previous default) in a new option (QEMU -> Tweaks). This resolves clock issues on some Linux distros (#3104) * (iOS) Ability to fine tune cursor speed (in Settings) (#2522) * (iOS) Various improvements to scaling including fixing pinch to zoom on iOS 15 * (iOS) Fixed a random crash due to iOS 15 dyld changes (#3672) * (macOS) Ability to turn off auto QCOW2 conversion when importing an image as well as the ability to create a raw disk image (#3637) ## Changes (v3.1.1) * Automatically delete broken bookmarks for removable drives and shared directories after showing the error once (#3575) * Refactored backend QEMU VM manager to support Swift concurrency and also fix some rare race issues * Added picker for console background and text colour (thanks @ktprograms) * Added font style (bold/italics) for console font as well as font chooser for macOS (thanks @ktprograms) * Fixed crash/freeze when using UTM URL actions (#3642) * (iOS) Wizard: style was incorrect on iOS 14 * (iOS) Keyboard visibility state is now stored globally instead of per-VM * (iOS) Fixed an issue where the keyboard always pops up when an alert shows * (iOS) On iOS 13.4, old cursor functionality is restored when it was broken by the iOS 14 cursor implementation * (iOS) iOS 15 introduced a kernel race that leads to a panic and sometimes a purple screen and device reboot whenever GL is used. This has been fixed by reducing the possibility of the race (while we wait for Apple to fix it in iOS kernel) (#2743) * (iOS) Better error message when attempting to launch an unsupported architecture in UTM SE (#3635) * (macOS) Added descriptions to screen resolutions and notch-hiding resolutions (thanks @pointum) ## Changes (v3.1.0) * Improved design of wizard on iOS (thanks @js-john) * Updated zh-Hans translation (thanks @ty-yqs) * Refactored backend renderer into [CocoaSpice](https://github.com/utmapp/CocoaSpice) * Updated backend code to use Swift 5.5 concurrency features * In Apple VM configs, do not discard non-persistent settings (shared directories) when canceling out of settings window * Add option to run VM as a shortcut (see notes above) (#132, #1205) * Added icon for Pop! OS to picker (thanks @conath) * Fixed QEMU custom argument parsing when there is quoted space in middle of the argument (#3579) * Update the VM screenshot on a timer (#3499) * Added new global setting to disable saving screenshot to disk * Improved synchronization of state from the VM window and the main window (play button visible when stopped, busy spinner visible when starting, etc) * (iOS) Fix crash while installing on older versions of jailbroken iOS (#3543) * (macOS) Fix an issue where Apple VM aux storage was not created when switching from Linux to macOS boot option * (macOS) Ability to move a .utm VM to external storage * (macOS) Toolbar option to delete VM should be disabled when VM is running * (macOS) Support taking screenshots of Apple VMs ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ### Known Issues * iOS 14 and below: There is a known issue crashing while running under taurine but not unc0ver. (#3628) [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Highlights * Store .utm bundles anywhere on disk (including on external drives) and import them as a shortcut. See notes below for some limitations. * Wizard redesign (thanks @js-john) * Various UI tweaks, fixes, and improvements (thanks @j-f1). Note that some settings have moved to different categories * Overhaul of the UTM backend which should improve application stability ## Notes * (iOS) **UTM v3.1.x will be the last update to support iOS 11 and iOS 12.** If you are still running those versions, please make sure you report any issues now so they can be fixed by the final release of v3.1.x. After that, iOS 13+ will be required to run future versions of UTM. * You can now run .utm files stored anywhere. There are a few caveats: First, all newly created VMs will still be created in the default storage (app sandbox). You can move the VM after creation with the new button on the toolbar or by right clicking (or force touch) on the VM entry and selecting "Move..." Second, when VM shortcuts are deleted, the underlying data is unaffected, and shortcuts are automatically deleted when they are no longer valid (for example, the .utm was moved). You can re-import the .utm by either double clicking it from Finder, or using "File -> Import Virtual Machine..." Finally, Apple VMs do not support persistent shortcuts, which means the shortcut is *always* deleted after UTM quits. This means you must re-import Apple VMs every time UTM is launched. * Default machine properties will now always be included *unless* explicitly set to another value in QEMU settings. For example, if you are booting an aarch64 virt machine, the property `highmem=off` will be appended unless the user specifies `highmem=on` in QEMU settings. Previously, when you select `virt` in VM settings, the machine properties text box will auto populate with `highmem=off`. If the user deletes it, then the VM will not boot because it requires `highmem=off`. Advanced users can still specify `highmem=on` and it will not be overridden. ## Changes (v3.1.4) * The changes to behaviour of “legacy input” introduced in v3.1.2 is now disabled by default for all existing (x86_64) virtual machines. For new virtual machines, the default is still to disable PS/2 bus when USB is enabled. However, this can be overridden with a new tweak “Force PS/2 Controller” in the QEMU settings. (#3723) * The computed size for shortcut VMs is properly calculated and saving shorting VM settings works (#3724) * "Error: Use -machine help to list supported machines" shows up when starting a newly created virtualized VM (#3722) * Updated zh-Hans translation (thanks @js-john) * (iOS 11-13) Default UEFI boot to off because we do not have any UI to change it ## Changes (v3.1.3) * *Hotfix*: An earlier release of v3.1.3 had a bug which prevented newly created VMs from booting, this has now been fixed * Use QCOW2 format for EFI variables on newly created variables image. This enables suspend state to work on EFI enabled VMs again (unless suspend fails for other unsupported devices). Note: existing VMs should delete the EFI variables drive from VM Settings in order for UTM to recreate it as QCOW2. * The busy spinner gets suck during startup or shutdown (#3702) * Boots Windows ARM emulation with QEMU TCG by adding `virtualization=on` machine property (#3703) * Default machine properties will always be included *unless* explicitly set to another value in QEMU settings. (See notes above.) * Various UI tweaks, fixes, and improvements (thanks @j-f1). Note that some settings have moved to different categories. * Fixed "Failed to create new bookmark" when trying to launch a VM shortcut * Automatically de-toggle UEFI boot tweak on unsupported targets * Fixed a situation that caused UTM to crash randomly (#3515) * (iOS 14) Toolbar had large overlapping icons on compact devices ## Changes (v3.1.2) * Fixed leaking of location data in debug.log (#3667) * Console mode settings for colours are slightly off from the picker values. This has been fixed by using P3 space hex values. * Retain ordering of VM list when using move, clone, and edit operations * Show "unavailable" VMs when a shortcut is unaccessible due to the VM being deleted or an external drive not being mounted. No longer deletes these shortcuts by default (#3686) * Support importing multiple .utm at once (#3685) * Rename "import" menu to "open" to reflect the new behaviour of creating a shortcut by default. Add the "open" option to the first page of the wizard as well so iOS users can access it * New context menu option "New from template..." can be called to duplicate the settings of an existing QEMU VM without the data (#2339) * Fixed a UI issue where an error message makes the VM stuck in "busy" state * Disable PS/2 keyboard/mouse when "legacy input" is off. Renamed "legacy input" to USB mode to make more explicit that when it is off, a USB bus is emulated with the input controls there (#3674) * Moved USB sharing options to Input tab to consolidate USB settings * (iOS) Fixed launching on < iOS 15 (except with taurine, which is still broken for different reasons) * (iOS) Fix saving last display origin and scale (#3669) * Option to use UTC vs localtime (previous default) in a new option (QEMU -> Tweaks). This resolves clock issues on some Linux distros (#3104) * (iOS) Ability to fine tune cursor speed (in Settings) (#2522) * (iOS) Various improvements to scaling including fixing pinch to zoom on iOS 15 * (iOS) Fixed a random crash due to iOS 15 dyld changes (#3672) * (macOS) Ability to turn off auto QCOW2 conversion when importing an image as well as the ability to create a raw disk image (#3637) ## Changes (v3.1.1) * Automatically delete broken bookmarks for removable drives and shared directories after showing the error once (#3575) * Refactored backend QEMU VM manager to support Swift concurrency and also fix some rare race issues * Added picker for console background and text colour (thanks @ktprograms) * Added font style (bold/italics) for console font as well as font chooser for macOS (thanks @ktprograms) * Fixed crash/freeze when using UTM URL actions (#3642) * (iOS) Wizard: style was incorrect on iOS 14 * (iOS) Keyboard visibility state is now stored globally instead of per-VM * (iOS) Fixed an issue where the keyboard always pops up when an alert shows * (iOS) On iOS 13.4, old cursor functionality is restored when it was broken by the iOS 14 cursor implementation * (iOS) iOS 15 introduced a kernel race that leads to a panic and sometimes a purple screen and device reboot whenever GL is used. This has been fixed by reducing the possibility of the race (while we wait for Apple to fix it in iOS kernel) (#2743) * (iOS) Better error message when attempting to launch an unsupported architecture in UTM SE (#3635) * (macOS) Added descriptions to screen resolutions and notch-hiding resolutions (thanks @pointum) ## Changes (v3.1.0) * Improved design of wizard on iOS (thanks @js-john) * Updated zh-Hans translation (thanks @ty-yqs) * Refactored backend renderer into [CocoaSpice](https://github.com/utmapp/CocoaSpice) * Updated backend code to use Swift 5.5 concurrency features * In Apple VM configs, do not discard non-persistent settings (shared directories) when canceling out of settings window * Add option to run VM as a shortcut (see notes above) (#132, #1205) * Added icon for Pop! OS to picker (thanks @conath) * Fixed QEMU custom argument parsing when there is quoted space in middle of the argument (#3579) * Update the VM screenshot on a timer (#3499) * Added new global setting to disable saving screenshot to disk * Improved synchronization of state from the VM window and the main window (play button visible when stopped, busy spinner visible when starting, etc) * (iOS) Fix crash while installing on older versions of jailbroken iOS (#3543) * (macOS) Fix an issue where Apple VM aux storage was not created when switching from Linux to macOS boot option * (macOS) Ability to move a .utm VM to external storage * (macOS) Toolbar option to delete VM should be disabled when VM is running * (macOS) Support taking screenshots of Apple VMs ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ### Known Issues * iOS 14 and below: There is a known issue crashing while running under taurine but not unc0ver. (#3628) [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Highlights * Wizard redesign (thanks @js-john) * Various UI tweaks, fixes, and improvements (thanks @j-f1). Note that some settings have moved to different categories. * Store .utm bundles anywhere on disk (including on external drives) and import them as a shortcut. See notes below for some limitations. ## Notes * (iOS) **UTM v3.1.x will be the last update to support iOS 11 and iOS 12.** If you are still running those versions, please make sure you report any issues now so they can be fixed by the final release of v3.1.x. After that, iOS 13+ will be required to run future versions of UTM. * This update makes significant changes to the backend of UTM which may have introduced more issues than usual. As a precaution, please make sure you back up your VMs before running this beta in case there are bugs that cause data loss. * You can now run .utm files stored anywhere. There are a few caveats: First, all newly created VMs will still be created in the default storage (app sandbox). You can move the VM after creation with the new button on the toolbar or by right clicking (or force touch) on the VM entry and selecting "Move..." Second, when VM shortcuts are deleted, the underlying data is unaffected, and shortcuts are automatically deleted when they are no longer valid (for example, the .utm was moved). You can re-import the .utm by either double clicking it from Finder, or using "File -> Import Virtual Machine..." Finally, Apple VMs do not support persistent shortcuts, which means the shortcut is *always* deleted after UTM quits. This means you must re-import Apple VMs every time UTM is launched. * Default machine properties will now always be included *unless* explicitly set to another value in QEMU settings. For example, if you are booting an aarch64 virt machine, the property `highmem=off` will be appended unless the user specifies `highmem=on` in QEMU settings. Previously, when you select `virt` in VM settings, the machine properties text box will auto populate with `highmem=off`. If the user deletes it, then the VM will not boot because it requires `highmem=off`. Advanced users can still specify `highmem=on` and it will not be overridden. ## Changes (v3.1.3) * *Hotfix*: An earlier release of v3.1.3 had a bug which prevented newly created VMs from booting, this has now been fixed * Use QCOW2 format for EFI variables on newly created variables image. This enables suspend state to work on EFI enabled VMs again (unless suspend fails for other unsupported devices). Note: existing VMs should delete the EFI variables drive from VM Settings in order for UTM to recreate it as QCOW2. * The busy spinner gets suck during startup or shutdown (#3702) * Boots Windows ARM emulation with QEMU TCG by adding `virtualization=on` machine property (#3703) * Default machine properties will always be included *unless* explicitly set to another value in QEMU settings. (See notes above.) * Various UI tweaks, fixes, and improvements (thanks @j-f1). Note that some settings have moved to different categories. * Fixed "Failed to create new bookmark" when trying to launch a VM shortcut * Automatically de-toggle UEFI boot tweak on unsupported targets * Fixed a situation that caused UTM to crash randomly (#3515) * (iOS 14) Toolbar had large overlapping icons on compact devices ## Changes (v3.1.2) * Fixed leaking of location data in debug.log (#3667) * Console mode settings for colours are slightly off from the picker values. This has been fixed by using P3 space hex values. * Retain ordering of VM list when using move, clone, and edit operations * Show "unavailable" VMs when a shortcut is unaccessible due to the VM being deleted or an external drive not being mounted. No longer deletes these shortcuts by default (#3686) * Support importing multiple .utm at once (#3685) * Rename "import" menu to "open" to reflect the new behaviour of creating a shortcut by default. Add the "open" option to the first page of the wizard as well so iOS users can access it * New context menu option "New from template..." can be called to duplicate the settings of an existing QEMU VM without the data (#2339) * Fixed a UI issue where an error message makes the VM stuck in "busy" state * Disable PS/2 keyboard/mouse when "legacy input" is off. Renamed "legacy input" to USB mode to make more explicit that when it is off, a USB bus is emulated with the input controls there (#3674) * Moved USB sharing options to Input tab to consolidate USB settings * (iOS) Fixed launching on < iOS 15 (except with taurine, which is still broken for different reasons) * (iOS) Fix saving last display origin and scale (#3669) * Option to use UTC vs localtime (previous default) in a new option (QEMU -> Tweaks). This resolves clock issues on some Linux distros (#3104) * (iOS) Ability to fine tune cursor speed (in Settings) (#2522) * (iOS) Various improvements to scaling including fixing pinch to zoom on iOS 15 * (iOS) Fixed a random crash due to iOS 15 dyld changes (#3672) * (macOS) Ability to turn off auto QCOW2 conversion when importing an image as well as the ability to create a raw disk image (#3637) ## Changes (v3.1.1) * Automatically delete broken bookmarks for removable drives and shared directories after showing the error once (#3575) * Refactored backend QEMU VM manager to support Swift concurrency and also fix some rare race issues * Added picker for console background and text colour (thanks @ktprograms) * Added font style (bold/italics) for console font as well as font chooser for macOS (thanks @ktprograms) * Fixed crash/freeze when using UTM URL actions (#3642) * (iOS) Wizard: style was incorrect on iOS 14 * (iOS) Keyboard visibility state is now stored globally instead of per-VM * (iOS) Fixed an issue where the keyboard always pops up when an alert shows * (iOS) On iOS 13.4, old cursor functionality is restored when it was broken by the iOS 14 cursor implementation * (iOS) iOS 15 introduced a kernel race that leads to a panic and sometimes a purple screen and device reboot whenever GL is used. This has been fixed by reducing the possibility of the race (while we wait for Apple to fix it in iOS kernel) (#2743) * (iOS) Better error message when attempting to launch an unsupported architecture in UTM SE (#3635) * (macOS) Added descriptions to screen resolutions and notch-hiding resolutions (thanks @pointum) ## Changes (v3.1.0) * Improved design of wizard on iOS (thanks @js-john) * Updated zh-Hans translation (thanks @ty-yqs) * Refactored backend renderer into [CocoaSpice](https://github.com/utmapp/CocoaSpice) * Updated backend code to use Swift 5.5 concurrency features * In Apple VM configs, do not discard non-persistent settings (shared directories) when canceling out of settings window * Add option to run VM as a shortcut (see notes above) (#132, #1205) * Added icon for Pop! OS to picker (thanks @conath) * Fixed QEMU custom argument parsing when there is quoted space in middle of the argument (#3579) * Update the VM screenshot on a timer (#3499) * Added new global setting to disable saving screenshot to disk * Improved synchronization of state from the VM window and the main window (play button visible when stopped, busy spinner visible when starting, etc) * (iOS) Fix crash while installing on older versions of jailbroken iOS (#3543) * (macOS) Fix an issue where Apple VM aux storage was not created when switching from Linux to macOS boot option * (macOS) Ability to move a .utm VM to external storage * (macOS) Toolbar option to delete VM should be disabled when VM is running * (macOS) Support taking screenshots of Apple VMs ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ### Known Issues * iOS 14 and below: There is a known issue crashing while running under taurine but not unc0ver. (#3628) [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Highlights * Wizard redesign (thanks @js-john) * Store .utm bundles anywhere on disk (including on external drives) and import them as a shortcut. See notes below for some limitations. ## Notes * (iOS) **UTM v3.1.x will be the last update to support iOS 11 and iOS 12.** If you are still running those versions, please make sure you report any issues now so they can be fixed by the final release of v3.1.x. After that, iOS 13+ will be required to run future versions of UTM. * This update makes significant changes to the backend of UTM which may have introduced more issues than usual. As a precaution, please make sure you back up your VMs before running this beta in case there are bugs that cause data loss. * You can now run .utm files stored anywhere. There are a few caveats: First, all newly created VMs will still be created in the default storage (app sandbox). You can move the VM after creation with the new button on the toolbar or by right clicking (or force touch) on the VM entry and selecting "Move..." Second, when VM shortcuts are deleted, the underlying data is unaffected, and shortcuts are automatically deleted when they are no longer valid (for example, the .utm was moved). You can re-import the .utm by either double clicking it from Finder, or using "File -> Import Virtual Machine..." Finally, Apple VMs do not support persistent shortcuts, which means the shortcut is *always* deleted after UTM quits. This means you must re-import Apple VMs every time UTM is launched. ## Changes (v3.1.2) * Fixed leaking of location data in debug.log (#3667) * Console mode settings for colours are slightly off from the picker values. This has been fixed by using P3 space hex values. * Retain ordering of VM list when using move, clone, and edit operations * Show "unavailable" VMs when a shortcut is unaccessible due to the VM being deleted or an external drive not being mounted. No longer deletes these shortcuts by default (#3686) * Support importing multiple .utm at once (#3685) * Rename "import" menu to "open" to reflect the new behaviour of creating a shortcut by default. Add the "open" option to the first page of the wizard as well so iOS users can access it * New context menu option "New from template..." can be called to duplicate the settings of an existing QEMU VM without the data (#2339) * Fixed a UI issue where an error message makes the VM stuck in "busy" state * Disable PS/2 keyboard/mouse when "legacy input" is off. Renamed "legacy input" to USB mode to make more explicit that when it is off, a USB bus is emulated with the input controls there (#3674) * Moved USB sharing options to Input tab to consolidate USB settings * (iOS) Fixed launching on < iOS 15 (except with taurine, which is still broken for different reasons) * (iOS) Fix saving last display origin and scale (#3669) * Option to use UTC vs localtime (previous default) in a new option (QEMU -> Tweaks). This resolves clock issues on some Linux distros (#3104) * (iOS) Ability to fine tune cursor speed (in Settings) (#2522) * (iOS) Various improvements to scaling including fixing pinch to zoom on iOS 15 * (iOS) Fixed a random crash due to iOS 15 dyld changes (#3672) * (macOS) Ability to turn off auto QCOW2 conversion when importing an image as well as the ability to create a raw disk image (#3637) ## Changes (v3.1.1) * Automatically delete broken bookmarks for removable drives and shared directories after showing the error once (#3575) * Refactored backend QEMU VM manager to support Swift concurrency and also fix some rare race issues * Added picker for console background and text colour (thanks @ktprograms) * Added font style (bold/italics) for console font as well as font chooser for macOS (thanks @ktprograms) * Fixed crash/freeze when using UTM URL actions (#3642) * (iOS) Wizard: style was incorrect on iOS 14 * (iOS) Keyboard visibility state is now stored globally instead of per-VM * (iOS) Fixed an issue where the keyboard always pops up when an alert shows * (iOS) On iOS 13.4, old cursor functionality is restored when it was broken by the iOS 14 cursor implementation * (iOS) iOS 15 introduced a kernel race that leads to a panic and sometimes a purple screen and device reboot whenever GL is used. This has been fixed by reducing the possibility of the race (while we wait for Apple to fix it in iOS kernel) (#2743) * (iOS) Better error message when attempting to launch an unsupported architecture in UTM SE (#3635) * (macOS) Added descriptions to screen resolutions and notch-hiding resolutions (thanks @pointum) ## Changes (v3.1.0) * Improved design of wizard on iOS (thanks @js-john) * Updated zh-Hans translation (thanks @ty-yqs) * Refactored backend renderer into [CocoaSpice](https://github.com/utmapp/CocoaSpice) * Updated backend code to use Swift 5.5 concurrency features * In Apple VM configs, do not discard non-persistent settings (shared directories) when canceling out of settings window * Add option to run VM as a shortcut (see notes above) (#132, #1205) * Added icon for Pop! OS to picker (thanks @conath) * Fixed QEMU custom argument parsing when there is quoted space in middle of the argument (#3579) * Update the VM screenshot on a timer (#3499) * Added new global setting to disable saving screenshot to disk * Improved synchronization of state from the VM window and the main window (play button visible when stopped, busy spinner visible when starting, etc) * (iOS) Fix crash while installing on older versions of jailbroken iOS (#3543) * (macOS) Fix an issue where Apple VM aux storage was not created when switching from Linux to macOS boot option * (macOS) Ability to move a .utm VM to external storage * (macOS) Toolbar option to delete VM should be disabled when VM is running * (macOS) Support taking screenshots of Apple VMs ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ### Known Issues * iOS 14 and below: There is a known issue crashing while running under taurine but not unc0ver. (#3628) [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Highlights * Wizard redesign (thanks @js-john) * Store .utm bundles anywhere on disk (including on external drives) and import them as a shortcut. See notes below for some limitations. ## Notes * (iOS) **UTM v3.1.x will be the last update to support iOS 11 and iOS 12.** If you are still running those versions, please make sure you report any issues now so they can be fixed by the final release of v3.1.x. After that, iOS 13+ will be required to run future versions of UTM. * This update makes significant changes to the backend of UTM which may have introduced more issues than usual. As a precaution, please make sure you back up your VMs before running this beta in case there are bugs that cause data loss. * You can now run .utm files stored anywhere. There are a few caveats: First, all newly created VMs will still be created in the default storage (app sandbox). You can move the VM after creation with the new button on the toolbar or by right clicking (or force touch) on the VM entry and selecting "Move..." Second, when VM shortcuts are deleted, the underlying data is unaffected, and shortcuts are automatically deleted when they are no longer valid (for example, the .utm was moved). You can re-import the .utm by either double clicking it from Finder, or using "File -> Import Virtual Machine..." Finally, Apple VMs do not support persistent shortcuts, which means the shortcut is *always* deleted after UTM quits. This means you must re-import Apple VMs every time UTM is launched. ## Changes (v3.1.1) * Automatically delete broken bookmarks for removable drives and shared directories after showing the error once (#3575) * Refactored backend QEMU VM manager to support Swift concurrency and also fix some rare race issues * Added picker for console background and text colour (thanks @ktprograms) * Added font style (bold/italics) for console font as well as font chooser for macOS (thanks @ktprograms) * Fixed crash/freeze when using UTM URL actions (#3642) * (iOS) Wizard: style was incorrect on iOS 14 * (iOS) Keyboard visibility state is now stored globally instead of per-VM * (iOS) Fixed an issue where the keyboard always pops up when an alert shows * (iOS) On iOS 13.4, old cursor functionality is restored when it was broken by the iOS 14 cursor implementation * (iOS) iOS 15 introduced a kernel race that leads to a panic and sometimes a purple screen and device reboot whenever GL is used. This has been fixed by reducing the possibility of the race (while we wait for Apple to fix it in iOS kernel) (#2743) * (iOS) Better error message when attempting to launch an unsupported architecture in UTM SE (#3635) * (macOS) Added descriptions to screen resolutions and notch-hiding resolutions (thanks @pointum) ## Changes (v3.1.0) * Improved design of wizard on iOS (thanks @js-john) * Updated zh-Hans translation (thanks @ty-yqs) * Refactored backend renderer into [CocoaSpice](https://github.com/utmapp/CocoaSpice) * Updated backend code to use Swift 5.5 concurrency features * In Apple VM configs, do not discard non-persistent settings (shared directories) when canceling out of settings window * Add option to run VM as a shortcut (see notes above) (#132, #1205) * Added icon for Pop! OS to picker (thanks @conath) * Fixed QEMU custom argument parsing when there is quoted space in middle of the argument (#3579) * Update the VM screenshot on a timer (#3499) * Added new global setting to disable saving screenshot to disk * Improved synchronization of state from the VM window and the main window (play button visible when stopped, busy spinner visible when starting, etc) * (iOS) Fix crash while installing on older versions of jailbroken iOS (#3543) * (macOS) Fix an issue where Apple VM aux storage was not created when switching from Linux to macOS boot option * (macOS) Ability to move a .utm VM to external storage * (macOS) Toolbar option to delete VM should be disabled when VM is running * (macOS) Support taking screenshots of Apple VMs ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. ### Known Issues * iOS 14 and below: There is a known issue crashing while running under taurine but not unc0ver. (#3628) [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Highlights * Wizard redesign (thanks @js-john) * Store .utm bundles anywhere on disk (including on external drives) and import them as a shortcut. See notes below for some limitations. ## Notes * (iOS) **UTM v3.1.x will be the last update to support iOS 11 and iOS 12.** If you are still running those versions, please make sure you report any issues now so they can be fixed by the final release of v3.1.x. After that, iOS 13+ will be required to run future versions of UTM. * This update makes significant changes to the backend of UTM which may have introduced more issues than usual. As a precaution, please make sure you back up your VMs before running this beta in case there are bugs that cause data loss. * You can now run .utm files stored anywhere. There are a few caveats: First, all newly created VMs will still be created in the default storage (app sandbox). You can move the VM after creation with the new button on the toolbar or by right clicking (or force touch) on the VM entry and selecting "Move..." Second, when VM shortcuts are deleted, the underlying data is unaffected, and shortcuts are automatically deleted when they are no longer valid (for example, the .utm was moved). You can re-import the .utm by either double clicking it from Finder, or using "File -> Import Virtual Machine..." Finally, Apple VMs do not support persistent shortcuts, which means the shortcut is *always* deleted after UTM quits. This means you must re-import Apple VMs every time UTM is launched. ## Changes (v3.1.0) * Improved design of wizard on iOS (thanks @js-john) * Updated zh-Hans translation (thanks @ty-yqs) * Refactored backend renderer into [CocoaSpice](https://github.com/utmapp/CocoaSpice) * Updated backend code to use Swift 5.5 concurrency features * In Apple VM configs, do not discard non-persistent settings (shared directories) when canceling out of settings window * Add option to run VM as a shortcut (see notes above) (#132, #1205) * Added icon for Pop! OS to picker (thanks @conath) * Fixed QEMU custom argument parsing when there is quoted space in middle of the argument (#3579) * Update the VM screenshot on a timer (#3499) * Added new global setting to disable saving screenshot to disk * Improved synchronization of state from the VM window and the main window (play button visible when stopped, busy spinner visible when starting, etc) * (iOS) Fix crash while installing on older versions of jailbroken iOS (#3543) * (macOS) Fix an issue where Apple VM aux storage was not created when switching from Linux to macOS boot option * (macOS) Ability to move a .utm VM to external storage * (macOS) Toolbar option to delete VM should be disabled when VM is running * (macOS) Support taking screenshots of Apple VMs ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

**Please read the release notes carefully as this is a major update from v2.x and there are some changes you need to be aware of.** ## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Highlights * **Wizard for VM creation**: Easily create a new VM with the correct default settings with a guided step-by-step wizard. Preview: https://twitter.com/UTMapp/status/1475606159428046854 * **QEMU v6.2.0**: Updated QEMU backend to the latest release. Full changelog: https://wiki.qemu.org/ChangeLog/6.2 * (iOS 13+) **New toolbar**: The new toolbar is much more compact and friendly for smaller displays. It is also now movable and does not interfere with the iOS 15 multitasking button on the top center of the screen. Preview: https://twitter.com/UTMapp/status/1407350167494443023 * (macOS 12+, ARM64) **Virtualize macOS 12**: New integration with Apple's Virtualization.framework backend allows native hardware accelerated virtualization of macOS 12 (supporting both CPU and GPU virtualization). UTM can also download the latest macOS installer directly from Apple. (This is only supported on macOS 12+ running on an ARM64 Mac.) * (macOS 11+) **Virtualize Linux with Apple backend**: You now have the option to use Apple's Virtualization.framework to virtualize Linux. Note that while there are some performance benefits, it is still recommended to use the QEMU backend as it is more stable, has more device support (including graphical display), and is easier to configure. ## Notes * The default CPU for ARM64 virtual machine has changed from `cortex-a72` to `default`. This is the recommended option and you should change your existing VMs to use it. When using virtualization on M1(X) macOS, the `cortex-a72` CPU is known to have compatibility issues which causes the VM to sometimes freeze (including during Windows install). `default` will use the `host` CPU model when virtualization is used and `cortex-a72` when emulation is used. * The GL hardware acceleration support is now marked experimental to highlight that it is not stable. It is also no longer the default option. If you are experiencing lots of crashes, make sure that you chose a display hardware that is **not** marked as "GPU Supported". * The cursor and resolution change issues on ARM64 Windows has been fixed in [SPICE tools 0.164.3][3]. If you are using an older version and experience such issues, please update to the latest SPICE tools. * If you manually added `virtualization=on` to your VM machine properties, you should remove it. ## Changes (v3.0.4) * Introduced option to disable RNG device, which causes issues on FreeBSD (#3493) * Wizard: directory sharing is now enabled by default * Changed the default USB 3.0 controller from `qemu-xhci` to `nec-usb-xhci` which addresses an issue where the DVD drive disconnects randomly on Windows ARM64 and causes random errors during setup (#3194) * (macOS) Fixed save panel opening when you try to close the settings (#3494) * (macOS) Hide unsupported directory sharing options in macOS guests (#3496) * (macOS) Fix invert scrolling option (thanks @ktprograms) (#3497) * (macOS) Apple VM config files are now in plain-text (thanks @ktprograms) * (macOS) Hide non-disk drives from the drives icon menu and properly describe the "EFI Variables" "drive" in settings * (macOS) Fixed suspend save state being broken in a previous update * (macOS) Fixed a crash when a toolbar icon is hidden due to small window size and a toolbar option is selected from the menu * (macOS) The stop button in the main window will now stop the VM if it is started * (iOS) Wizard: Fix disabled button colour being the same as enabled buttons * (iOS) Moved the toolbar icon lower to not collide with the touch target for showing control center * (iOS) Fixed an issue where settings are not shown if the context menu is used to open it (#3513) ## Changes (v3.0.3) * Improvements to download UI (thanks @conath) (#3432) * Wizard: various improvements to creating Linux VMs (#3472) * (iOS) Add licensing text to app settings (#3236) * (macOS) DMG package now has a pretty icon and background (#3257) * (macOS) Add new preference to terminate when all windows are closed (previously this was the default) (#3483) * (macOS) Fix custom icon for Apple VMs (#3477) * (macOS) Fix retina mode support for QEMU VMs (note that previously there was a global preference to enable retina mode that is now removed, per-VM setting should be used instead) (#3471) * (macOS) Remove QEMU VM setting for "Fit to Screen" as it was never implemented for macOS * ~~(macOS) Remove Apple VM setting for "Retina (HiDPI) Mode" as it was confusing and is not used for rendering (it just specifies the size of the virtual monitor)~~ This has been reverted in v3.0.4 and the Retina (HiDPI) Mode has been added back. A use for this feature is if you wish to take screenshots at specific resolutions. ## Changes (v3.0.2) * (macOS) Fixed drive delete/move buttons not appearing on macOS 11 (#3461) * (macOS) Added missing network entitlement for bridged networking on Apple VMs * (macOS) Wizard: convert VHDX to QCOW2 when creating a Windows VM * (macOS) Any imported drive on an interface that is NOT floppy, pflash, or none will be converted to QCOW2. This does not apply to removable drives. * (iOS) Improved toolbar visibility and dimming while idle behaviour * Wizard: skip drive creation if rootfs image is selected * Fixed an issue where an imported drive does not use the selected interface ## Changes (v3.0.1) * (macOS) Fixed launching on macOS 11 (#3433) * (macOS) Fixed "auxiliaryStorage is nil" when creating macOS VM on M1 Mac (thanks @pointum) (#3429) * (iOS) Proper enablement of extended RAM usage on M1 iPad 16GB (thanks @kkk669) * (iOS) Fixed crash on VM launch on < iOS 13 due to toolbar not being initialized * (iOS) Version information will now be shown in the system Settings app for UTM (at the bottom) * Fixed cursor and screen resolution issues on ARM64 Windows after installing SPICE tools. Requires updating SPICE tools to [latest version][3]. * Add virtio-rng-pci device to fix boot warning about randomness source (thanks @ktprograms) * Default upscaling mode is now "nearest neighbor" * Fixed floppy drives being read-only (thanks @conath) (#3333) * Wizard: no longer use NVMe for Windows on x86_64 systems * Fixed a regression where Windows boots into BSOD often on x86_64 virtualization * Updated localization for Zh-Hant (thanks @pan93412) * Updated localization for Zh-Hans (thanks @js-john) * Fixed an issue where sometimes a VM will not boot due to invalid drive id (thanks @conath) (#3388) * Changing target to PC (i440FX) will now turn off hypervisor on x86_64 by default because it is unstable (#2420) ## Changes (v3.0.0) * Added VM creation wizard * Updated QEMU to v6.2.0 * Updated ANGLE to latest commit * Updated virglrenderer to latest commit (this may fix #2743) * Added `default` and `host` CPU option for ARM64 virtual machines. This will be the default for newly created VMs. * The downloader will no longer perform CRC checks on the ZIP file and this will significantly speed up extraction. * (iOS 13+) Redesigned toolbar (#496) * (macOS) Redesigned VM settings * (macOS) Fix crash moving drives (#3117) * (macOS) Make HVF per-VM configurable (#2493) * (macOS) Add Apple Virtualization.framework backend * (macOS) New Terminal frontend with SwiftTerm, currently only used with Apple backend on macOS * (macOS) Apple Virtualization supports virtual serial port through PTY device ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://mac.getutm.app/support/

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Highlights * **Wizard for VM creation**: Easily create a new VM with the correct default settings with a guided step-by-step wizard. Preview: https://twitter.com/UTMapp/status/1475606159428046854 * **QEMU v6.2.0**: Updated QEMU backend to the latest release. Full changelog: https://wiki.qemu.org/ChangeLog/6.2 * (iOS 13+) **New toolbar**: The new toolbar is much more compact and friendly for smaller displays. It is also now movable and does not interfere with the iOS 15 multitasking button on the top center of the screen. Preview: https://twitter.com/UTMapp/status/1407350167494443023 * (macOS 12+, ARM64) **Virtualize macOS 12**: New integration with Apple's Virtualization.framework backend allows native hardware accelerated virtualization of macOS 12 (supporting both CPU and GPU virtualization). UTM can also download the latest macOS IPSW directly from Apple. (This is only supported on macOS 12+ running on an ARM64 Mac.) * (macOS 11+) **Virtualize Linux with Apple backend**: You now have the option to use Apple's Virtualization.framework to virtualize Linux. Note that while there are some performance benefits, it is still recommended to use the QEMU backend as it is more stable, has more device support (including graphical display), and is easier to configure. ## Notes * The default CPU for ARM64 virtual machine has changed from `cortex-a72` to `default`. This is the recommended option and you should change your existing VMs to use it. When using virtualization on M1(X) macOS, the `cortex-a72` CPU is known to have compatibility issues which causes the VM to sometimes freeze (including during Windows install). `default` will use the `host` CPU model when virtualization is used and `cortex-a72` when emulation is used. * The GL hardware acceleration support is now marked experimental to highlight that it is not stable. It is also no longer the default option. If you are experiencing lots of crashes, make sure that you chose a display hardware that is **not** marked as "GPU Supported". * The cursor and resolution change issues on ARM64 Windows has been fixed in [SPICE tools 0.164.3][3]. ## Changes (v3.0.3) * Improvements to download UI (thanks @conath) (#3432) * Wizard: various improvements to creating Linux VMs (#3472) * (iOS) Add licensing text to app settings (#3236) * (macOS) DMG package now has a pretty icon and background (#3257) * (macOS) Add new preference to terminate when all windows are closed (previously this was the default) (#3483) * (macOS) Fix custom icon for Apple VMs (#3477) * (macOS) Fix retina mode support for QEMU VMs (note that previously there was a global preference to enable retina mode that is now removed, per-VM setting should be used instead) (#3471) * (macOS) Remove QEMU VM setting for "Fit to Screen" as it was never implemented for macOS * (macOS) Remove Apple VM setting for "Retina (HiDPI) Mode" as it was confusing and is not used for rendering (it just specifies the size of the virtual monitor) ## Changes (v3.0.2) * (macOS) Fixed drive delete/move buttons not appearing on macOS 11 (#3461) * (macOS) Added missing network entitlement for bridged networking on Apple VMs * (macOS) Wizard: convert VHDX to QCOW2 when creating a Windows VM * (macOS) Any imported drive on an interface that is NOT floppy, pflash, or none will be converted to QCOW2. This does not apply to removable drives. * (iOS) Improved toolbar visibility and dimming while idle behaviour * Wizard: skip drive creation if rootfs image is selected * Fixed an issue where an imported drive does not use the selected interface ## Changes (v3.0.1) * (macOS) Fixed launching on macOS 11 (#3433) * (macOS) Fixed "auxiliaryStorage is nil" when creating macOS VM on M1 Mac (thanks @pointum) (#3429) * (iOS) Proper enablement of extended RAM usage on M1 iPad 16GB (thanks @kkk669) * (iOS) Fixed crash on VM launch on < iOS 13 due to toolbar not being initialized * (iOS) Version information will now be shown in the system Settings app for UTM (at the bottom) * Fixed cursor and screen resolution issues on ARM64 Windows after installing SPICE tools. Requires updating SPICE tools to [latest version][3]. * Add virtio-rng-pci device to fix boot warning about randomness source (thanks @ktprograms) * Default upscaling mode is now "nearest neighbor" * Fixed floppy drives being read-only (thanks @conath) (#3333) * Wizard: no longer use NVMe for Windows on x86_64 systems * Fixed a regression where Windows boots into BSOD often on x86_64 virtualization * Updated localization for Zh-Hant (thanks @pan93412) * Updated localization for Zh-Hans (thanks @js-john) * Fixed an issue where sometimes a VM will not boot due to invalid drive id (thanks @conath) (#3388) * Changing target to PC (i440FX) will now turn off hypervisor on x86_64 by default because it is unstable (#2420) ## Changes (v3.0.0) * Added VM creation wizard * Updated QEMU to v6.2.0 * Updated ANGLE to latest commit * Updated virglrenderer to latest commit (this may fix #2743) * Added `default` and `host` CPU option for ARM64 virtual machines. This will be the default for newly created VMs. * The downloader will no longer perform CRC checks on the ZIP file and this will significantly speed up extraction. * (iOS 13+) Redesigned toolbar (#496) * (macOS) Redesigned VM settings * (macOS) Fix crash moving drives (#3117) * (macOS) Make HVF per-VM configurable (#2493) * (macOS) Add Apple Virtualization.framework backend * (macOS) New Terminal frontend with SwiftTerm, currently only used with Apple backend on macOS * (macOS) Apple Virtualization supports virtual serial port through PTY device ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://mac.getutm.app/support/

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Highlights * **Wizard for VM creation**: Easily create a new VM with the correct default settings with a guided step-by-step wizard. Preview: https://twitter.com/UTMapp/status/1475606159428046854 * **QEMU v6.2.0**: Updated QEMU backend to the latest release. Full changelog: https://wiki.qemu.org/ChangeLog/6.2 * (iOS 13+) **New toolbar**: The new toolbar is much more compact and friendly for smaller displays. It is also now movable and does not interfere with the iOS 15 multitasking button on the top center of the screen. Preview: https://twitter.com/UTMapp/status/1407350167494443023 * (macOS 12+, ARM64) **Virtualize macOS 12**: New integration with Apple's Virtualization.framework backend allows native hardware accelerated virtualization of macOS 12 (supporting both CPU and GPU virtualization). UTM can also download the latest macOS IPSW directly from Apple. (This is only supported on macOS 12+ running on an ARM64 Mac.) * (macOS 11+) **Virtualize Linux with Apple backend**: You now have the option to use Apple's Virtualization.framework to virtualize Linux. Note that while there are some performance benefits, it is still recommended to use the QEMU backend as it is more stable, has more device support (including graphical display), and is easier to configure. ## Notes * The default CPU for ARM64 virtual machine has changed from `cortex-a72` to `default`. This is the recommended option and you should change your existing VMs to use it. When using virtualization on M1(X) macOS, the `cortex-a72` CPU is known to have compatibility issues which causes the VM to sometimes freeze (including during Windows install). `default` will use the `host` CPU model when virtualization is used and `cortex-a72` when emulation is used. * The GL hardware acceleration support is now marked experimental to highlight that it is not stable. It is also no longer the default option. If you are experiencing lots of crashes, make sure that you chose a display hardware that is **not** marked as "GPU Supported". * The cursor and resolution change issues on ARM64 Windows has been fixed in [SPICE tools 0.164.3][3]. ## Changes (v3.0.2) * (macOS) Fixed drive delete/move buttons not appearing on macOS 11 (#3461) * (macOS) Added missing network entitlement for bridged networking on Apple VMs * (macOS) Wizard: convert VHDX to QCOW2 when creating a Windows VM * (macOS) Any imported drive on an interface that is NOT floppy, pflash, or none will be converted to QCOW2. This does not apply to removable drives. * (iOS) Improved toolbar visibility and dimming while idle behaviour * Wizard: skip drive creation if rootfs image is selected * Fixed an issue where an imported drive does not use the selected interface ## Changes (v3.0.1) * (macOS) Fixed launching on macOS 11 (#3433) * (macOS) Fixed "auxiliaryStorage is nil" when creating macOS VM on M1 Mac (thanks @pointum) (#3429) * (iOS) Proper enablement of extended RAM usage on M1 iPad 16GB (thanks @kkk669) * (iOS) Fixed crash on VM launch on < iOS 13 due to toolbar not being initialized * (iOS) Version information will now be shown in the system Settings app for UTM (at the bottom) * Fixed cursor and screen resolution issues on ARM64 Windows after installing SPICE tools. Requires updating SPICE tools to [latest version][3]. * Add virtio-rng-pci device to fix boot warning about randomness source (thanks @ktprograms) * Default upscaling mode is now "nearest neighbor" * Fixed floppy drives being read-only (thanks @conath) (#3333) * Wizard: no longer use NVMe for Windows on x86_64 systems * Fixed a regression where Windows boots into BSOD often on x86_64 virtualization * Updated localization for Zh-Hant (thanks @pan93412) * Updated localization for Zh-Hans (thanks @js-john) * Fixed an issue where sometimes a VM will not boot due to invalid drive id (thanks @conath) (#3388) * Changing target to PC (i440FX) will now turn off hypervisor on x86_64 by default because it is unstable (#2420) ## Changes (v3.0.0) * Added VM creation wizard * Updated QEMU to v6.2.0 * Updated ANGLE to latest commit * Updated virglrenderer to latest commit (this may fix #2743) * Added `default` and `host` CPU option for ARM64 virtual machines. This will be the default for newly created VMs. * The downloader will no longer perform CRC checks on the ZIP file and this will significantly speed up extraction. * (iOS 13+) Redesigned toolbar (#496) * (macOS) Redesigned VM settings * (macOS) Fix crash moving drives (#3117) * (macOS) Make HVF per-VM configurable (#2493) * (macOS) Add Apple Virtualization.framework backend * (macOS) New Terminal frontend with SwiftTerm, currently only used with Apple backend on macOS * (macOS) Apple Virtualization supports virtual serial port through PTY device ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://mac.getutm.app/support/

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Highlights * **Wizard for VM creation**: Easily create a new VM with the correct default settings with a guided step-by-step wizard. Preview: https://twitter.com/UTMapp/status/1475606159428046854 * **QEMU v6.2.0**: Updated QEMU backend to the latest release. Full changelog: https://wiki.qemu.org/ChangeLog/6.2 * (iOS 13+) **New toolbar**: The new toolbar is much more compact and friendly for smaller displays. It is also now movable and does not interfere with the iOS 15 multitasking button on the top center of the screen. Preview: https://twitter.com/UTMapp/status/1407350167494443023 * (macOS 12+, ARM64) **Virtualize macOS 12**: New integration with Apple's Virtualization.framework backend allows native hardware accelerated virtualization of macOS 12 (supporting both CPU and GPU virtualization). UTM can also download the latest macOS IPSW directly from Apple. (This is only supported on macOS 12+ running on an ARM64 Mac.) * (macOS 11+) **Virtualize Linux with Apple backend**: You now have the option to use Apple's Virtualization.framework to virtualize Linux. Note that while there are some performance benefits, it is still recommended to use the QEMU backend as it is more stable, has more device support (including graphical display), and is easier to configure. ## Notes * The default CPU for ARM64 virtual machine has changed from `cortex-a72` to `default`. This is the recommended option and you should change your existing VMs to use it. When using virtualization on M1(X) macOS, the `cortex-a72` CPU is known to have compatibility issues which causes the VM to sometimes freeze (including during Windows install). `default` will use the `host` CPU model when virtualization is used and `cortex-a72` when emulation is used. * The GL hardware acceleration support is now marked experimental to highlight that it is not stable. It is also no longer the default option. If you are experiencing lots of crashes, make sure that you chose a display hardware that is **not** marked as "GPU Supported". * The cursor and resolution change issues on ARM64 Windows has been fixed in [SPICE tools 0.164.3][3]. ## Changes (v3.0.1) * (macOS) Fixed launching on macOS 11 (#3433) * (macOS) Fixed "auxiliaryStorage is nil" when creating macOS VM on M1 Mac (thanks @pointum) (#3429) * (iOS) Proper enablement of extended RAM usage on M1 iPad 16GB (thanks @kkk669) * (iOS) Fixed crash on VM launch on < iOS 13 due to toolbar not being initialized * (iOS) Version information will now be shown in the system Settings app for UTM (at the bottom) * Fixed cursor and screen resolution issues on ARM64 Windows after installing SPICE tools. Requires updating SPICE tools to [latest version][3]. * Add virtio-rng-pci device to fix boot warning about randomness source (thanks @ktprograms) * Default upscaling mode is now "nearest neighbor" * Fixed floppy drives being read-only (thanks @conath) (#3333) * Wizard: no longer use NVMe for Windows on x86_64 systems * Fixed a regression where Windows boots into BSOD often on x86_64 virtualization * Updated localization for Zh-Hant (thanks @pan93412) * Updated localization for Zh-Hans (thanks @js-john) * Fixed an issue where sometimes a VM will not boot due to invalid drive id (thanks @conath) (#3388) * Changing target to PC (i440FX) will now turn off hypervisor on x86_64 by default because it is unstable (#2420) ## Changes (v3.0.0) * Added VM creation wizard * Updated QEMU to v6.2.0 * Updated ANGLE to latest commit * Updated virglrenderer to latest commit (this may fix #2743) * Added `default` and `host` CPU option for ARM64 virtual machines. This will be the default for newly created VMs. * The downloader will no longer perform CRC checks on the ZIP file and this will significantly speed up extraction. * (iOS 13+) Redesigned toolbar (#496) * (macOS) Redesigned VM settings * (macOS) Fix crash moving drives (#3117) * (macOS) Make HVF per-VM configurable (#2493) * (macOS) Add Apple Virtualization.framework backend * (macOS) New Terminal frontend with SwiftTerm, currently only used with Apple backend on macOS * (macOS) Apple Virtualization supports virtual serial port through PTY device ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://mac.getutm.app/support/

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Highlights * **Wizard for VM creation**: Easily create a new VM with the correct default settings with a guided step-by-step wizard. Preview: https://twitter.com/UTMapp/status/1475606159428046854 * **QEMU v6.2.0**: Updated QEMU backend to the latest release. Full changelog: https://wiki.qemu.org/ChangeLog/6.2 * (iOS 13+) **New toolbar**: The new toolbar is much more compact and friendly for smaller displays. It is also now movable and does not interfere with the iOS 15 multitasking button on the top center of the screen. Preview: https://twitter.com/UTMapp/status/1407350167494443023 * (macOS 12+, ARM64) **Virtualize macOS 12**: New integration with Apple's Virtualization.framework backend allows native hardware accelerated virtualization of macOS 12 (supporting both CPU and GPU virtualization). UTM can also download the latest macOS IPSW directly from Apple. (This is only supported on macOS 12+ running on an ARM64 Mac.) * (macOS 11+) **Virtualize Linux with Apple backend**: You now have the option to use Apple's Virtualization.framework to virtualize Linux. Note that while there are some performance benefits, it is still recommended to use the QEMU backend as it is more stable, has more device support (including graphical display), and is easier to configure. ## Notes * The default CPU for ARM64 virtual machine has changed from `cortex-a72` to `default`. This is the recommended option and you should change your existing VMs to use it. When using virtualization on M1(X) macOS, the `cortex-a72` CPU is known to have compatibility issues which causes the VM to sometimes freeze (including during Windows install). `default` will use the `host` CPU model when virtualization is used and `cortex-a72` when emulation is used. * The GL hardware acceleration support is now marked experimental to highlight that it is not stable. It is also no longer the default option. If you are experiencing lots of crashes, make sure that you chose a display hardware that is **not** marked as "GPU Supported". ## Changes (v3.0.0) * Added VM creation wizard * Updated QEMU to v6.2.0 * Updated ANGLE to latest commit * Updated virglrenderer to latest commit (this may fix #2743) * Added `default` and `host` CPU option for ARM64 virtual machines. This will be the default for newly created VMs. * The downloader will no longer perform CRC checks on the ZIP file and this will significantly speed up extraction. * (iOS 13+) Redesigned toolbar (#496) * (macOS) Redesigned VM settings * (macOS) Fix crash moving drives (#3117) * (macOS) Make HVF per-VM configurable (#2493) * (macOS) Add Apple Virtualization.framework backend * (macOS) New Terminal frontend with SwiftTerm, currently only used with Apple backend on macOS * (macOS) Apple Virtualization supports virtual serial port through PTY device ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Notes **Note that some changes require updates to your VM configuration so please read this part carefully.** * Cursor disappearing on Windows 10/11 has been fixed with an updated VirtIO GPU driver. Additionally, dynamic resolution (auto-change resolution when VM window is resized) and more fixed resolutions (matching all the screen resolutions of the latest Mac computers) were added to the driver. This requires you to download the latest SPICE tools ISO from https://mac.getutm.app/support/ and run the installer again (or manually updating your GPU driver from the ISO if you know how). * In v2.4.0, newly created Q35 and PC machine (x86 and x86_64) defaulted to the `Skylake-Client` CPU model. Subsequently, it was discovered that the change caused performance regressions. v2.4.1 reverted the default CPU model to `Default` but if you created a new Q35/PC VM in v2.4.0, it is recommended that you manually change the CPU in System settings to `Default`. * Since v1.0.0, UTM used the RTL8139 network card as the default for Q35 VMs (x86 and x86_64) and Virt VMs (ARM64). There is a bug in the device implementation that causes the Windows driver to freeze the system and many users reported Windows Installer freezing as well as random freezes through normal use. In v2.4.0, we changed the default network card for Virt machines to `virtio-net-pci` and in v2.4.1, we changed the default network card for Q35 machines to E1000. However, this change only applies to newly created VMs, and any existing VMs may still suffer from the random freeze issues. It is recommended that you change your network card to `e1000` for Q35 machines and `virtio-net-pci` for Virt machines. Windows 7 and above should have the Intel E1000 network card drivers already installed, but the VirtIO Network card requires drivers in the SPICE tools ISO from https://mac.getutm.app/support/ (if you previously installed this, you should have the drivers already on your system). * (macOS) Since v2.1.2, UTM provided an option (Cmd+,) to "Use only performance cores by default" which defaulted to off. When on, any VM which does not have a manually configured CPU count (> 0) will set the CPU count to the number of performance cores on the system. In v2.4.1, we have made this option on by default which means if you previously have not modified this option, then it will now be on. If you turned the option on, it should not change and if you turned the option on and later off again, it should still be off. The reason for this change was because users may not be aware of this option which can result in degraded performance when left off and we believe the default should reflect the best possible performance. Note that as before, if you manually set a VM's CPU count > 0, then this option does not change anything. ## Changes * (iOS) Integrated AltKit for automatically triggering AltJIT when installed with AltStore (1.5b2+) and AltServer (1.5b8+) (thanks @JoeMatt) * (iOS) Fixed sandbox issues (cannot select file) on jailbroken devices (thanks @Halo-Michael) * Improved zh-Hans translation (thanks @js-john) * Fixed inverted mouse cursor colour in Windows * New VMs will only use PCores by default (unless manually overridden with Preferences or per-VM config), this also fixes #3180 * Changed default Q35 audio card to intel-hda * Changed default Q35 network card to E1000 and Virt network card to virtio-net (#3130) * Removed default CPU for Q35 and PC configurations because the Skylake-Client CPU resulted in performance regression (#3249) * Fixed downloadVM URL action when the ZIP name collides with the .utm name (thanks @conath) * Fixed a race condition leading to crash when a VM is shut down suddenly ## Issues Please check the full list on [Github][2] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## New Features (Summary) * Improved support for SPARC and S390x * Updated macOS icon thanks to a real designer (@JackHinkle) ## Changes * Fixed crash when trying to pause a GL accelerated VM (#3207) * Configuration should reset more settings when changing architecture * Fixed UTM exit when deleting a VM * Fixed an incorrect mapping of removable drives causing an error "device not removable" when drives are moved around. * On ARM64 virt systems, use the virtual USB 3.0 bus for the virtual DVD drive, should improve read times and fix some Windows installer issues (#3194) (thanks @conath) * Fixed a crash booting OpenBSD (#3197) (thanks @agraf) * Fixed a crash caused by a race condition when an error occurs during VM launch * (macOS) Keyboard mapping accidentally swapped left/right Cmd and Option (#3175) (thanks @zeldin) * (macOS) Removed "beep" when pressing Cmd+key while mouse is not captured (#3217) * (macOS) Pass Ctrl+Tab to VM even when not captured because it is a common shortcut. VoiceOver users can use VO+Arrow to navigate. * (macOS) Unhide cursor when alert prompt shows up * (macOS) Fixed crash when trying to share a VM (#3208) ## Known Issues * VM sometimes randomly freezes (#3130, #301) Please check the full list on [Github][2] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## New Features (Summary) * **URL automation and VM downloading** (#2670) (thanks @conath) Allows for controlling and downloading VMs with `utm://` URL. Check out #2670 for more information. * (macOS) Improved cursor/keyboard capturing and handling: permit macOS shortcuts (minimize, full-screen) when not captured, fix various cursor bugs, basic support for VoiceOver and capturing, and more. * (macOS) Various UI enhancements: export log/args to file (#3056), title bar changes (#3125), exit confirmation works beyond Cmd+Q/W (#3154) (thanks @ktprograms and @conath) ## Changes (v2.3.1) * Fixed crash when Fn key is pressed (thanks @ktprograms) (#3179) * Fixed Unicode support in terminal mode (thanks @tie) * Added additional Windows icons (thanks @conath) * (macOS) Fixed numpad issues * (macOS) Correct key mapping for ISO keyboards (#3175) ## Changes (v2.3.0) * Fixed DNS resolution on IPv6 * Updated zh-Hans localization (thanks @ty-yqs) * Ensure temporary files are deleted when VM creation is canceled (#3012) * Support re-generating and customizing MAC address (#2724) * On PC/Q35 devices, USB mouse and keyboard will be disabled in order to prevent interference with the PS/2 keyboard and mouse that is always added to the machines. Some software such as Windows Installer will not work with the second mice. * (macOS) Move VM name in main window from title to subtitle, reduces confusion when switching windows (#3099) (thanks @conath) * (macOS) Show confirmation alert when closing/quitting with the menu or the button (#3103) (thanks @ktprograms) * (macOS) Error alert (instead of crash) when trying to use unsupported features on < macOS 11.3 (#3118) * (macOS) Support starting input capture with Ctrl+Opt (#3119) * (macOS) Reduced UI thread blocking in terminal mode with lots of output spewing (#2404, #2555) * (macOS) Add alternative hotkey for capture (Cmd+Opt) (#2710) * (macOS) Unhide cursor when popup alert shows (#3101) ## Known Issues * Networking can be broken in some instances, we are still investigating the cause. (#3051, #3094) * Windows 11 installation may randomly freeze and be corrupted (#3130) Please check the full list on [Github][2] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## New Features (Summary) * **URL automation and VM downloading** (#2670) (thanks @conath) Allows for controlling and downloading VMs with `utm://` URL. Check out #2670 for more information. * (macOS) Improved cursor/keyboard capturing and handling: permit macOS shortcuts (minimize, full-screen) when not captured, fix various cursor bugs, basic support for VoiceOver and capturing, and more. * (macOS) Various UI enhancements: export log/args to file (#3056), title bar changes (#3125), exit confirmation works beyond Cmd+Q/W (#3154) (thanks @ktprograms and @conath) ## Changes * Fixed DNS resolution on IPv6 * Updated zh-Hans localization (thanks @ty-yqs) * Ensure temporary files are deleted when VM creation is canceled (#3012) * Support re-generating and customizing MAC address (#2724) * On PC/Q35 devices, USB mouse and keyboard will be disabled in order to prevent interference with the PS/2 keyboard and mouse that is always added to the machines. Some software such as Windows Installer will not work with the second mice. * (macOS) Move VM name in main window from title to subtitle, reduces confusion when switching windows (#3099) (thanks @conath) * (macOS) Show confirmation alert when closing/quitting with the menu or the button (#3103) (thanks @ktprograms) * (macOS) Error alert (instead of crash) when trying to use unsupported features on < macOS 11.3 (#3118) * (macOS) Support starting input capture with Ctrl+Opt (#3119) * (macOS) Reduced UI thread blocking in terminal mode with lots of output spewing (#2404, #2555) * (macOS) Add alternative hotkey for capture (Cmd+Opt) (#2710) * (macOS) Unhide cursor when popup alert shows (#3101) ## Known Issues * Networking can be broken in some instances, we are still investigating the cause. (#3051, #3094) Please check the full list on [Github][2] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## New Features (Summary) * (macOS 11.3+ Only) **Bridged networking and shared networking support**. You can configure it in the Network settings for your VM. * (macOS 11+ and iOS 13+) **GPU acceleration for OpenGL on Linux**. Use `virtio-ramfb-gl` or `virtio-vga-gl` display device and compatible Linux drivers (most modern Linux distros will have it already installed). Windows is not supported because there is currently no virtio-gpu driver for Windows that supports 3D acceleration. Note that newly created VMs will default to a "GPU Supported" display device on supported architectures but existing VMs must manually change the display device in Display settings. GPU acceleration is still an experimental feature, so it may not work in some situations (including many 3D use cases). * **EFI Boot**. By default new VMs created for pc, q35, and virt* machines will have EFI enabled. In previous versions, EFI is only enabled for virt* machines. Due to compatibility with boot, existing pc and q35 VMs will NOT have EFI enabled and must be manually turned on in Settings -> System -> Advanced Configuration -> UEFI Boot. This may also require you to re-install the bootloader on your VM. As part of this change, EFI variables will also be properly handled (on both ARM and x86 VMs). Note that if you've configured a custom pflash device for your VM, the new UEFI Boot option will take no effect (same as before). * **QEMU v6.1.0** is now used for the backend. ## Changes (v2.2.1) * Fix crash when setting custom VM icon (#2387) (thanks @ktprograms) * Disable Port Forwarding feature for bridged networking (thanks @conath) * Fixed memory leak (#2720) ## Changes (v2.2.2) * (iOS) Enable OpenGL acceleration for iOS 11-12 * (iOS 15+) Increased memory limit for supported devices (M1 iPads currently) * (macOS) Fix layout issues in settings on macOS Monterey (#2644) * (macOS) Fix capturing of hotkeys (such as Cmd+Tab) (#2677) * Disable port forwarding options for shared & bridged networking * Fixed crash when PPC screamer is selected on iOS (currently this is still not supported) * Refactored non-OpenGL rendering code, fixing some random crashes seen in TestFlight reports. ## Changes (v2.2.3) * (iOS) When a mouse/trackpad is already connected when UTM starts up, it will now be properly detected (#3013) * (iOS) Handle touch and Apple Pencil input while the mouse is captured (#2669) * Windows BSOD on boot/setup due to `PAGE_FAULT_IN_NONPAGED_AREA` (#2721) ## Changes (v2.2.4) * (macOS) Settings no longer crash when an error occurs while saving a new VM * (iOS) GL rendering now works on EFI startup (black screen during boot) (#3076) ## Known Issues * v2.2.4 is built with Xcode 12.5.1 instead of Xcode 13.0 beta due to Apple's strict requirements in submitting apps built on beta SDKs. As a result, the layout issues in settings on macOS Monterey are back in v2.2.4. This will be resolved when Xcode 13 is released. * Networking can be broken in some instances, we are still investigating the cause. (#3051, #3094) Please check the full list on [Github][2] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

**Note: this beta build has breaking changes. Please read the notes below for more information.** ## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## New Features (v2.2.0) * (macOS 11.3+ Only) **Bridged networking and shared networking support**. You can configure it in the Network settings for your VM. * (macOS 11+ and iOS 13+) **GPU acceleration for OpenGL on Linux**. Use `virtio-ramfb` or `virtio-gpu-gl-pci` display device and compatible Linux drivers (most modern Linux distros will have it already installed). Windows is not supported because there is currently no virtio-gpu driver for Windows that supports 3D acceleration. ## Changes (v2.2.2) * (iOS) Enable OpenGL acceleration for iOS 11-12 * (iOS 15+) Increased memory limit for supported devices (M1 iPads currently) * (macOS) Fix layout issues in settings on macOS Monterey (#2644) * (macOS) Fix capturing of hotkeys (such as Cmd+Tab) (#2677) * Disable port forwarding options for shared & bridged networking * Fixed crash when PPC screamer is selected on iOS (currently this is still not supported) * Refactored non-OpenGL rendering code, fixing some random crashes seen in TestFlight reports. ## Changes (v2.2.3) * (iOS) When a mouse/trackpad is already connected when UTM starts up, it will now be properly detected (#3013) * (iOS) Handle touch and Apple Pencil input while the mouse is captured (#2669) * Windows BSOD on boot/setup due to `PAGE_FAULT_IN_NONPAGED_AREA` (#2721) * EFI Boot is now a configurable option: by default new VMs created for pc, q35, and virt* machines will have EFI enabled. In previous versions, EFI is only enabled for virt* machines. Due to compatibility with boot, existing pc and q35 VMs will NOT have EFI enabled and must be manually turned on in Settings -> System -> Advanced Configuration -> UEFI Boot. This may also require you to re-install the bootloader on your VM. As part of this change, EFI variables will also be properly handled (on both ARM and x86 VMs). Note that if you've configured a custom pflash device for your VM, the new UEFI Boot option will take no effect (same as before). * Added `virtio-ramfb-gl` device to support GPU Acceleration. On previous beta builds, GL is enabled automatically for `virtio-ramfb`. Now, that display device will **not** get GPU acceleration. This is to be more consistent with the other `-gl` display devices. By default, new VMs created will have `virtio-ramfb-gl` selected for `virt` devices (ARM) and `virtio-vga-gl` selected for `q35` and `pc` devices (x86). If you wish to use GPU acceleration on an existing VM, you need to change your display device to one of these two recommended devices (or any device with `-gl` in the name). Please check the full list on [Github][2] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## New Features (v2.2.0) * (macOS 11.3+ Only) **Bridged networking and shared networking support**. You can configure it in the Network settings for your VM. * (macOS 11+ and iOS 13+) **GPU acceleration for OpenGL on Linux**. Use `virtio-ramfb` or `virtio-gpu-gl-pci` display device and compatible Linux drivers (most modern Linux distros will have it already installed). Windows is not supported because there is currently no virtio-gpu driver for Windows that supports 3D acceleration. ## Changes (v2.2.2) * (iOS) Enable OpenGL acceleration for iOS 11-12 * (iOS 15+) Increased memory limit for supported devices (M1 iPads currently) * (macOS) Fix layout issues in settings on macOS Monterey (#2644) * (macOS) Fix capturing of hotkeys (such as Cmd+Tab) (#2677) * Disable port forwarding options for shared & bridged networking * Fixed crash when PPC screamer is selected on iOS (currently this is still not supported) * Intel Macs will use EFI boot if virtio-* graphics card is selected (fixes black screen on boot) * Refactored non-OpenGL rendering code, fixing some random crashes seen in TestFlight reports. Please check the full list on [Github][2] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## New Features (v2.2.0) * (macOS 11.3+ Only) **Bridged networking and shared networking support**. You can configure it in the Network settings for your VM. * (macOS 11+ and iOS 13+) **GPU acceleration for OpenGL on Linux**. Use `virtio-ramfb` or `virtio-gpu-gl-pci` display device and compatible Linux drivers (most modern Linux distros will have it already installed). Windows is not supported because there is currently no virtio-gpu driver for Windows that supports 3D acceleration. ## Changes (v2.2.1) * GPU acceleration is now using **OpenGL** instead of **Metal** due to compatibility issues. Please report anything that works on v2.2.0 (Metal) but fails on v2.2.1 (OpenGL). If there are many cases of these, then we will add an option to switch between the two backends. From experience though, it seems like the OpenGL backend is more stable and more compatible. However, compatibility is not perfect and you may experience crashes when trying to launch an unsupported app in the guest. As before, GPU acceleration only works on Linux with the correct Mesa drivers installed for virtio. * QEMU is updated to v6.1.0 (release) * Fix crash when setting custom VM icon (#2387) (thanks @ktprograms) * Disable Port Forwarding feature for bridged networking (thanks @conath) * Fixed memory leak (#2720) ## Known Issues * On Intel Macs, `virtio-ramfb` and `virtio-gpu-pl-pci` does not work with BIOS boot. You need to boot from UEFI which currently requires you to manually add a PC Flash device with the UEFI image. In the future, there will be an option to boot from UEFI instead of BIOS. * On macOS 12, some UI elements are laid out incorrectly due to changes in SwiftUI apis. Please check the full list on [Github][2] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## New Features * (macOS 11.3+ Only) **Bridged networking and shared networking support**. You can configure it in the Network settings for your VM. * (macOS 11+ and iOS 13+) **GPU acceleration for OpenGL on Linux**. Use `virtio-ramfb` or `virtio-gpu-gl-pci` display device and compatible Linux drivers (most modern Linux distros will have it already installed). Windows is not supported because there is currently no virtio-gpu driver for Windows that supports 3D acceleration. * QEMU is updated to v6.1.0-rc1 ## Known Issues * On Intel Macs, `virtio-ramfb` and `virtio-gpu-pl-pci` does not work with BIOS boot. You need to boot from UEFI which currently requires you to manually add a PC Flash device with the UEFI image. In the future, there will be an option to boot from UEFI instead of BIOS. * On macOS 12, some UI elements are laid out incorrectly due to changes in SwiftUI apis. Please check the full list on [Github][2] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Changes * Fixed QEMU issue causing crash running x86 Windows on M1 (thanks @kwhr0) (#2630) * Fixed crash due to bad drive id (#2614) * Properly delete imported/created drives on a new VM when canceled out (#2576) * Fixed bad CPU core configuration on SPARC (#2651) * Improvement to zh-Hant translation (thanks @pan93412) (#2595) * Fixed an unusable CD drive always showing up in Windows x86 (thanks @conath) (#2538) * (macOS) Fixed an issue with auto resolution changing with SPICE installed (#2587) * (macOS) Fixed a crash when starting a VM after shutting down (#2622) * (macOS) New global setting to (try to) only use performance cores: when set, if a VM does not manually specify a core count, instead of using the maximum number of cores on the system, UTM will use only the number of performance cores. Note this does not guarantee only the performance cores are used but only that the number of cores seen by the guest is lower. (#2557) * (macOS) Fixed screen tearing/glitches on Windows and improved framebuffer rendering performance (#2569) * (macOS) When SPICE tools are not properly set up, attempting to resize the window will now "revert" the size if the resolution does not get changed by the guest. * (iOS) Fixed crash when launching with [Jitterbug][3] or other imobiledevice tools * (iOS) Fixed Cydia install on iOS 11 (#2618) Please check the full list on [Github][2] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://github.com/osy/Jitterbug

This release brings two major features: USB support is here for macOS *and* jailbroken iOS. You can attach a device to your VM with the new USB icon in the toolbar. You can enable USB 3.0 in the Share settings for faster devices on supported targets. Note that older versions of Windows (e.g. Windows 7 and below) require installing additional drivers for USB 3.0. UTM SE is a new build for iOS that does not require JIT (and therefore is much slower). It can therefore be sideloaded on any iOS device that is not jailbroken. Jailbreak users are still recommended to install the standard UTM DEB package for faster JIT speeds and USB support. ## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Changes (v2.1.1) * (iOS) Fix USB attach on (jailbroken) iOS 14.6 * Fixed slow UEFI boot due to accidentally including a debug build of EDK2 * (macOS) Fixed captured mouse not being released when VM is shut down or suspended * (macOS) Trackpad scroll speed made more consistent (#2400) * (macOS) Fixed Windows 10 not booting on M1 Macs (#2546) * (macOS) Fixed Screamer audio (#2548) Note that you must now select the 'screamer' audio card for the 'mac99' system target for sound to work. ## Changes (v2.1.0) * QEMU updated from v5.2.0 to v6.0.0 * USB support: attach a USB device to the VM (macOS and jailbroken iOS 14.5 and below only) * UTM SE (Slow Edition): JITless iOS build available to sideload on *any* non-jailbroken device (thanks @ktemkin) * Screamer audio device for PPC mac99 machines Please check the full list on [Github][2] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

This release brings two major features: USB support is here for macOS *and* jailbroken iOS. You can attach a device to your VM with the new USB icon in the toolbar. You can enable USB 3.0 in the Share settings for faster devices on supported targets. Note that older versions of Windows (e.g. Windows 7 and below) require installing additional drivers for USB 3.0. UTM SE is a new build for iOS that does not require JIT (and therefore is much slower). It can therefore be sideloaded on any iOS device that is not jailbroken. Jailbreak users are still recommended to install the standard UTM DEB package for faster JIT speeds and USB support. ## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Changes * QEMU updated from v5.2.0 to v6.0.0 * USB support: attach a USB device to the VM (macOS and jailbroken iOS 14.5 and below only) * UTM SE (Slow Edition): JITless iOS build available to sideload on *any* non-jailbroken device (thanks @ktemkin) * Screamer audio device for PPC mac99 machines (no setting changes needed) Please check the full list on [Github][2] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Changes * (iOS) When file selection for removable drive is closed by tapping outside the modal, trying to open the modal again fails (#2499) * (macOS) When Cmd/Win key is held, keyUp event was not being handled (#2486) * Updated welcome screen with links to user guide and support page (#2498) * bootindex was not properly applied for floppy devices (note: this fix is only for Q35, floppy boot order is unsupported for other targets) (#2492) * Some targets such as Raspberry Pi fail to start because of an error with "-device usb-ehci" argument (#2505) * On Q35/PC targets, press Esc to get to boot menu in BIOS (#2504) * When removable drives are re-ordered, the underlying images assigned to them were not being reordered (#2512) Please check the full list on [Github][2] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

Note: this is a hotfix from v2.0.26. The following changelog is the same as v2.0.26 with the problematic patch removed (#2410). ## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Changes * (iOS) Use GCMouse APIs for improved mouse support (thanks @js-john), this also allows legacy (PS/2) mouse emulation to work properly * (macOS) Fixed sound broken by last update (#2448) * (macOS) When main window closes, opening the main window again loses state of started VMs (#2437) * (macOS) Capture Cmd+W and Cmd+Q and pass them to the VM when mouse is captured. Warn user if mouse is not captured. (#2321) * Removed legacy boot device order settings and added a note about how boot ordering is determined by order of drives added (which can be moved around). This should fix some boot issues (provided you move the devices in the right order). * Fixed non-removable CD/DVD devices not being recognized/not being able to boot (#2419) * Fixed notes cut off on iOS (#2460) Please check the full list on [Github][2] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Changes * (iOS) Use GCMouse APIs for improved mouse support (thanks @js-john), this also allows legacy (PS/2) mouse emulation to work properly * (macOS) Fixed sound broken by last update (#2448) * (macOS) When main window closes, opening the main window again loses state of started VMs (#2437) * (macOS) Automatically close window when VM stops (#2410) * (macOS) Capture Cmd+W and Cmd+Q and pass them to the VM when mouse is captured. Warn user if mouse is not captured. (#2321) * Removed legacy boot device order settings and added a note about how boot ordering is determined by order of drives added (which can be moved around). This should fix some boot issues (provided you move the devices in the right order). * Fixed non-removable CD/DVD devices not being recognized/not being able to boot (#2419) * Fixed notes cut off on iOS (#2460) Please check the full list on [Github][2] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Changes * Fix not booting automatically from NVMe (#2385) * Fix not booting automatically from USB (#2333) ## Notice for iOS 14.4+ iOS 14.4 broke JIT again (for non-jailbroken A12+ devices), and likely for good this time. We do not recommend updating to iOS 14.4 or higher. Future support for iOS will be limited to tethered and jailbroken devices only. ## Known Issues * Black screen or crash trying to start any VM? Make sure you read **all** the instructions in the [install page][1]. * When installed via Cydia/Sileo, Settings and Files integration does not work and VMs are not deleted automatically when uninstalled. Please check the full list on [Github][1] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://getutm.app/install/#jailbroken-devices

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Changes * Fix error booting with multiple IDE/SCSI drives (#2382) * Fix error booting with NVMe (#2383) * (iOS) Fix selecting interface for a new drive not working (#2384) * (iOS) Fix DEB build script ## Notice for iOS 14.4+ iOS 14.4 broke JIT again (for non-jailbroken A12+ devices), and likely for good this time. We do not recommend updating to iOS 14.4 or higher. Future support for iOS will be limited to tethered and jailbroken devices only. ## Known Issues * Black screen or crash trying to start any VM? Make sure you read **all** the instructions in the [install page][1]. * When installed via Cydia/Sileo, Settings and Files integration does not work and VMs are not deleted automatically when uninstalled. Please check the full list on [Github][1] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://getutm.app/install/#jailbroken-devices

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Changes * Fix wrong display card value in settings * Fix crash when selecting a display card (#2330) * Disable SPICE powered options when display card is unsupported * Improve boot ordering support * Fix crash when number field is erased * Fix restricted networking mode (thanks @conath) * Fix Cocoa resolution scaling (thanks @akihikodaki) * Add stable MAC address for new vm configs * Support fixed Hypervisor entitlements in sandbox on macOS 11.3 (no fork() workaround needed) * (macOS) Fix crash when moving drive down * (macOS) Fixed screen clipping in fullscreen mode (#2372) * (iOS) Jailbreak install now uses AppSync to install an unsigned IPA. Please read the Cydia description for important information on migrating VMs. ## Notice for iOS 14.4+ iOS 14.4 broke JIT again (for non-jailbroken A12+ devices), and likely for good this time. We do not recommend updating to iOS 14.4 or higher. Future support for iOS will be limited to tethered and jailbroken devices only. ## Known Issues * Black screen or crash trying to start any VM? Make sure you read **all** the instructions in the [install page][1]. * When installed via Cydia/Sileo, Settings and Files integration does not work and VMs are not deleted automatically when uninstalled. Please check the full list on [Github][1] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://getutm.app/install/#jailbroken-devices

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Changes * (iOS) Fixed crash when moving drives (#2322) * Fix removable drives option (#2320) * Limit network and sound card selection based on architecture support * Use new QEMU option for selecting sound card * New option to change display card (thanks @js-john) ## Notice for iOS 14.4+ iOS 14.4 broke JIT again (for non-jailbroken A12+ devices), and likely for good this time. We do not recommend updating to iOS 14.4 or higher. Future support for iOS will be limited to tethered and jailbroken devices only. ## Known Issues * Black screen or crash trying to start any VM? Make sure you read **all** the instructions in the [install page][1]. * When installed via Cydia/Sileo, Settings and Files integration does not work and VMs are not deleted automatically when uninstalled. Please check the full list on [Github][1] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://getutm.app/install/#jailbroken-devices

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Changes * Updated zh-Hans translation * (iOS) Check for iOS 14.4 and show warning message * (macOS) Disabled multiple windows and tabs for the home view * (macOS) Added menu commands for Import and New * (macOS) Fixed an issue where opening a .utm file creates a new window ## Notice for iOS 14.4+ iOS 14.4 broke JIT again (for non-jailbroken A12+ devices), and likely for good this time. We do not recommend updating to iOS 14.4 or higher. Future support for iOS will be limited to tethered and jailbroken devices only. ## Known Issues * Black screen or crash trying to start any VM? Make sure you read **all** the instructions in the [install page][1]. * When installed via Cydia/Sileo, Settings and Files integration does not work and VMs are not deleted automatically when uninstalled. Please check the full list on [Github][1] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://getutm.app/install/#jailbroken-devices

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Changes * Fixed CPU and core settings not used (#2293) * Fixed a bug where VM sometimes boots up in a black screen and requires resizing to see the graphics * Fixed a crash when starting VM in console mode with sharing enabled (#2291) * Moved default share from `/tmp/Public` to `Documents/Public`. This is the Documents folder in UTM's sandbox, **not** the user's documents directory. * Disabled sharing options and show warning message when console mode is enabled * No more white background behind the console (#1201) * (macOS) Enhanced UI for setting CPU flags * (macOS) Detect when SPICE agent is installed and allow resolution change by resizing the VM window * (macOS) New settings option to right click with Control+click (#2287) ## Notice for iOS 14.4 iOS 14.4 broke JIT again (for non-jailbroken A12+ devices), and likely for good this time. We do not recommend updating to iOS 14.4. Future support for iOS will be limited to jailbroken devices only. ## macOS Sandbox Migration If you are updating from < 2.0.17 on macOS, then when you open UTM you will not see any VMs you previously created! To fix this, move your .utm files from `~/Documents` to `~/Library/Containers/com.utmapp.UTM/Data/Documents`. You can do it in Terminal with the following command: ``` mv ~/Documents/*.utm ~/Library/Containers/com.utmapp.UTM/Data/Documents ``` or with Finder 1. Open Finder and go to your home directory. 2. Press Cmd+Shift+. (that's the period key) to show hidden files. 3. Browse to Library -> Containers -> UTM -> Data -> Documents 4. Copy or move your .utm files from your home's Documents directory to this directory. ## Known Issues * Black screen or crash trying to start any VM? Make sure you read **all** the instructions in the [install page][1]. * Cannot import any drives/ISO: there is a bug in iOS where an invalid "application-identifier" entitlement causes the file picker to not work. A fix for iOS App Signer is [submitted][3] and can be manually compiled. If you are using AltStore, you need use a free (not paid) developer account. * When installed via Cydia/Sileo, Settings and Files integration does not work and VMs are not deleted automatically when uninstalled. Please check the full list on [Github][1] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://github.com/DanTheMan827/ios-app-signer/pull/163 [4]: https://getutm.app/install/#jailbroken-devices

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Changes * (macOS) Add menu command to unhide sidebar (thanks @laosb) * (macOS) Redesign removable drives and shared directory UI (thanks @conath) * (macOS) Fix crash on macOS 11.2 when using JIT * (iOS) Disable autocorrect in text fields in settings (#2282) * (iOS) Show animation to home screen when exiting (#2279) * (Both) Toggle MB/GB when creating disk image (default to GB) (#2278) * (macOS) "Show in Finder" command in VM card's right click context menu (#2277) * (Both) Better handle orphaned disk images due to crash or discarding settings. Should prevent "file already exists" error when importing a disk image. (#2275) * (Both) Default x86_64 and i386 target is now q35 (2009) (#2274) * (Both) Export QEMU command line feature (#2283) * (Both) New setting: change CPU model and CPU flags when supported by QEMU (#1197) ## Notice for upcoming iOS update iOS 14.4 beta 2 broke JIT again (for non-jailbroken A12+ devices), and likely for good this time. We do not recommend updating to iOS 14.4 when it is released to the public. ## macOS Sandbox Migration If you are updating from < 2.0.17 on macOS, then when you open UTM you will not see any VMs you previously created! To fix this, move your .utm files from `~/Documents` to `~/Library/Containers/com.utmapp.UTM/Data/Documents`. You can do it in Terminal with the following command: ``` mv ~/Documents/*.utm ~/Library/Containers/com.utmapp.UTM/Data/Documents ``` or with Finder 1. Open Finder and go to your home directory. 2. Press Cmd+Shift+. (that's the period key) to show hidden files. 3. Browse to Library -> Containers -> UTM -> Data -> Documents 4. Copy or move your .utm files from your home's Documents directory to this directory. ## Known Issues * Black screen or crash trying to start any VM? Make sure you read **all** the instructions in the [install page][1]. * Cannot import any drives/ISO: there is a bug in iOS where an invalid "application-identifier" entitlement causes the file picker to not work. A fix for iOS App Signer is [submitted][3] and can be manually compiled. If you are using AltStore, you need use a free (not paid) developer account. * When installed via Cydia/Sileo, Settings and Files integration does not work and VMs are not deleted automatically when uninstalled. Please check the full list on [Github][1] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://github.com/DanTheMan827/ios-app-signer/pull/163 [4]: https://getutm.app/install/#jailbroken-devices

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Changes * Check out the new UTM Gallery: https://mac.getutm.app/gallery/ * QEMU 5.1.0 changed JIT cache allocation to default to be host RAM / 8 instead of guest RAM / 4 as before. We revert back to guest RAM / 4. * Fixed "Allocate x bytes for jit buffer: invalid argument" (#2269) * (macOS) Console mode broken due to CoreAudio API cannot be used after fork() (#2267) * Skip USB device for "isapc" (#2272) ## Notice for upcoming iOS update iOS 14.4 beta 2 broke JIT again (for non-jailbroken A12+ devices), and likely for good this time. We do not recommend updating to iOS 14.4 when it is released to the public. ## macOS Sandbox Migration If you are updating from < 2.0.17 on macOS, then when you open UTM you will not see any VMs you previously created! To fix this, move your .utm files from `~/Documents` to `~/Library/Containers/com.utmapp.UTM/Data/Documents`. You can do it in Terminal with the following command: ``` mv ~/Documents/*.utm ~/Library/Containers/com.utmapp.UTM/Data/Documents ``` or with Finder 1. Open Finder and go to your home directory. 2. Press Cmd+Shift+. (that's the period key) to show hidden files. 3. Browse to Library -> Containers -> UTM -> Data -> Documents 4. Copy or move your .utm files from your home's Documents directory to this directory. ## Known Issues * Black screen or crash trying to start any VM? Make sure you read **all** the instructions in the [install page][1]. * Cannot import any drives/ISO: there is a bug in iOS where an invalid "application-identifier" entitlement causes the file picker to not work. A fix for iOS App Signer is [submitted][3] and can be manually compiled. If you are using AltStore, you need use a free (not paid) developer account. * When installed via Cydia/Sileo, Settings and Files integration does not work and VMs are not deleted automatically when uninstalled. Please check the full list on [Github][1] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://github.com/DanTheMan827/ios-app-signer/pull/163 [4]: https://getutm.app/install/#jailbroken-devices

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Changes * Fixed a memory leak in starting VM with a removable drive that could lead to a crash in rare circumstances * Fixed a race condition in CocoaSpice that could lead to a crash or freeze on other running VMs if one VM is stopped * (iOS) Jailbreak detection for iOS 14 improved so startup message will not show up when jailbroken * (macOS) Improved icon at low resolutions * **(macOS) BREAKING CHANGE: App Sandbox is re-enabled starting with this build. You need to move any existing VMs. Please read the section below for more details.** ## macOS Sandbox Migration When you open UTM you will not see any VMs you previously created! To fix this, move your .utm files from `~/Documents` to `~/Library/Containers/com.utmapp.UTM/Data/Documents`. You can do it in Terminal with the following command: ``` mv ~/Documents/*.utm ~/Library/Containers/com.utmapp.UTM/Data/Documents ``` or with Finder 1. Open Finder and go to your home directory. 2. Press Cmd+Shift+. (that's the period key) to show hidden files. 3. Browse to Library -> Containers -> UTM -> Data -> Documents 4. Copy or move your .utm files from your home's Documents directory to this directory. ## Known Issues * Black screen or crash trying to start any VM? Make sure you read **all** the instructions in the [install page][1]. * Cannot import any drives/ISO: there is a bug in iOS where an invalid "application-identifier" entitlement causes the file picker to not work. A fix for iOS App Signer is [submitted][3] and can be manually compiled. If you are using AltStore, you need use a free (not paid) developer account. * When installed via Cydia/Sileo, Settings and Files integration does not work and VMs are not deleted automatically when uninstalled. Please check the full list on [Github][1] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://github.com/DanTheMan827/ios-app-signer/pull/163 [4]: https://getutm.app/install/#jailbroken-devices

## Installation Visit [https://getutm.app/install/][1] for the most up to date installation instructions. ## Changes * (iOS) Black screen when booting aarch64 VMs (#2080) * (iOS) External mouse/touchpad right click and middle click broken (#523) * (iOS) New setting option to disable screen dimming when VM is running (#1217) * (iOS) **New [Cydia repo][4] for jailbroken users**: https://cydia.getutm.app/ ## Known Issues * Black screen or crash trying to start any VM? Make sure you read **all** the instructions in the [install page][1]. * Cannot import any drives/ISO: there is a bug in iOS where an invalid "application-identifier" entitlement causes the file picker to not work. A fix for iOS App Signer is [submitted][3] and can be manually compiled. If you are using AltStore, you need use a free (not paid) developer account. * When installed via Cydia/Sileo, Settings and Files integration does not work and VMs are not deleted automatically when uninstalled. Please check the full list on [Github][1] and help report any bug you find that is not listed. [1]: https://getutm.app/install/ [2]: https://github.com/utmapp/UTM/issues [3]: https://github.com/DanTheMan827/ios-app-signer/pull/163 [4]: https://getutm.app/install/#jailbroken-devices

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. UTM 2.0 also updates the QEMU backend from 4.2.0 to 5.2.0 (for all supported iOS versions). Installation instructions differ depending on what version of iOS you are running: * iOS 11-13: You can install and run UTM using any version of AltStore (recommended) or [iOS App Signer][2]. * iOS 14: You must either be jailbroken or follow the [tethered launch][3] instructions every time you launch UTM. Note that the jailbroken instructions are currently outdated. If you have a good guide, please let us [know][5]. * iOS 14.2+: You can use either AltStore (>= 1.4.2) or [iOS App Signer][2]. Note A11 and older devices are not supported by this method and must be jailbroken or use tethered launch. As always, please report all bugs to [Github](https://github.com/utmapp/UTM/issues) ## Changes * QEMU option to use write-through cache to prevent HDD corruption when terminating a VM unexpectedly * Support virtio-gpu on aarch64 for dynamic resolution on Linux and Windows (with the proper drivers) (#1230) * Fix a crash when an invalid shared directory is specified (#528) * Show an error message when shared directory or removable drive specified is invalid * When no shared directory is specified, use a temporary directory * (iOS) Clipboard sharing works when running UTM side by side with another app * (macOS) Fix hypervisor on Intel Macs (#570) * (macOS) Fix auto determine core count on Intel Macs * (macOS) Implement clipboard sharing (SPICE tools needed) (#1204) * (macOS) Fix cursor issues when using virtio-gpu * (macOS) Support deleting port forward settings (#1226) ## Known Issues * Cannot import any drives/ISO: there is a bug in iOS where an invalid "application-identifier" entitlement causes the file picker to not work. A fix for iOS App Signer is [submitted][4] and can be manually compiled. If you are using AltStore, you need use a free (not paid) developer account. * Starting a VM goes to a black screen on iOS 14: you need to sign UTM with a "development" certificate. If you used a 3rd party signing service, it is probably signed with the wrong certificate. If you signed UTM yourself, make sure you chose a "development" certificate and in iOS App Signer, "No get-task-allow" is unchecked. Please check the full list on [Github][1] and help report any bug you find that is not listed. [1]: https://github.com/utmapp/UTM/issues [2]: https://dantheman827.github.io/ios-app-signer/ [3]: https://github.com/utmapp/UTM/blob/master/Documentation/TetheredLaunch.md [4]: https://github.com/DanTheMan827/ios-app-signer/pull/163 [5]: https://github.com/utmapp/UTM/issues/537 [6]: https://github.com/utmapp/qemu/releases/tag/v5.2.0-rc3-asi

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. UTM 2.0 also updates the QEMU backend from 4.2.0 to 5.2.0 (for all supported iOS versions). Installation instructions differ depending on what version of iOS you are running: * iOS 11-13: You can install and run UTM using any version of AltStore (recommended) or [iOS App Signer][2]. * iOS 14: You must either be jailbroken or follow the [tethered launch][3] instructions every time you launch UTM. Note that the jailbroken instructions are currently outdated. If you have a good guide, please let us [know][5]. * iOS 14.2: You can use either AltStore (>= 1.4.2) or [iOS App Signer][2]. Note A11 and older devices are not supported by this method and must be jailbroken or use tethered launch. As always, please report all bugs to [Github](https://github.com/utmapp/UTM/issues) ## Changes * QEMU updated to v5.1.0 release with v4 of @agraf's hypervisor patches for M1 * Update Korean localization (thanks @obbcth) * Default clipboard sharing setting to on for 'pc' and 'virt' targets on new VMs (SPICE tools still required) * (macOS) Default hypervisor to on. Note: this overrides any previous setting due to confusion caused by a bug in the last release where the settings dialog shows hypervisor on while it is actually off. This also changes the wording of the setting so checking the box now *disables* hypervisor. This is to align with the idea that default = off position in the settings. * (macOS) Disable pause button when hypervisor is used (pausing is not supported by QEMU) * (macOS) Fix various issues closing+reopening a VM window * (macOS) Fix a crash if VM was resized and then re-opened (#1203) * (iOS) Fix invalid TB size from config value (#1214) ## Known Issues * Cannot import any drives/ISO: there is a bug in iOS where an invalid "application-identifier" entitlement causes the file picker to not work. A fix for iOS App Signer is [submitted][4] and can be manually compiled. If you are using AltStore, you need use a free (not paid) developer account. * Starting a VM goes to a black screen on iOS 14: you need to sign UTM with a "development" certificate. If you used a 3rd party signing service, it is probably signed with the wrong certificate. If you signed UTM yourself, make sure you chose a "development" certificate and in iOS App Signer, "No get-task-allow" is unchecked. Please check the full list on [Github][1] and help report any bug you find that is not listed. [1]: https://github.com/utmapp/UTM/issues [2]: https://dantheman827.github.io/ios-app-signer/ [3]: https://github.com/utmapp/UTM/blob/master/Documentation/TetheredLaunch.md [4]: https://github.com/DanTheMan827/ios-app-signer/pull/163 [5]: https://github.com/utmapp/UTM/issues/537 [6]: https://github.com/utmapp/qemu/releases/tag/v5.2.0-rc3-asi

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. UTM 2.0 also updates the QEMU backend from 4.2.0 to 5.2.0 (for all supported iOS versions). Installation instructions differ depending on what version of iOS you are running: * iOS 11-13: You can install and run UTM using any version of AltStore (recommended) or [iOS App Signer][2]. * iOS 14: You must either be jailbroken or follow the [tethered launch][3] instructions every time you launch UTM. Note that the jailbroken instructions are currently outdated. If you have a good guide, please let us [know][5]. * iOS 14.2: You can use either AltStore (>= 1.4.2) or [iOS App Signer][2]. Note A11 and older devices are not supported by this method and must be jailbroken or use tethered launch. As always, please report all bugs to [Github](https://github.com/utmapp/UTM/issues) ## Changes * (macOS) Starting a VM on Intel Macs shows dylib error (#721) * Default BIOS for virt machines (no longer need to manually import a BIOS file to boot) * Default USB 3.0 controller for virt machines (fixes `BUGCODE_USB_DRIVER` BSOD on Windows 10 ARM) * (macOS) Sometimes settings modal is disabled after importing/add/removing a drive (#901) * After selecting an architecture and machine, sane default settings will be applied to other places * (macOS) Fix port forwarding * Add support for NVMe and USB drive interfaces (for Windows 10 ARM) * Simplify disk creation popup (removed confusing options) * (macOS) Improved mouse capture handling (#710) ## Known Issues * Cannot import any drives/ISO: there is a bug in iOS where an invalid "application-identifier" entitlement causes the file picker to not work. A fix for iOS App Signer is [submitted][4] and can be manually compiled. If you are using AltStore, you need use a free (not paid) developer account. * Starting a VM goes to a black screen on iOS 14: you need to sign UTM with a "development" certificate. If you used a 3rd party signing service, it is probably signed with the wrong certificate. If you signed UTM yourself, make sure you chose a "development" certificate and in iOS App Signer, "No get-task-allow" is unchecked. Please check the full list on [Github][1] and help report any bug you find that is not listed. [1]: https://github.com/utmapp/UTM/issues [2]: https://dantheman827.github.io/ios-app-signer/ [3]: https://github.com/utmapp/UTM/blob/master/Documentation/TetheredLaunch.md [4]: https://github.com/DanTheMan827/ios-app-signer/pull/163 [5]: https://github.com/utmapp/UTM/issues/537 [6]: https://github.com/utmapp/qemu/releases/tag/v5.2.0-rc3-asi

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. UTM 2.0 also updates the QEMU backend from 4.2.0 to 5.2.0 (for all supported iOS versions). Installation instructions differ depending on what version of iOS you are running: * iOS 11-13: You can install and run UTM using any version of AltStore (recommended) or [iOS App Signer][2]. * iOS 14: You must either be jailbroken or follow the [tethered launch][3] instructions every time you launch UTM. Note that the jailbroken instructions are currently outdated. If you have a good guide, please let us [know][5]. * iOS 14.2: You can use either AltStore (>= 1.4.2) or [iOS App Signer][2]. Note A11 and older devices are not supported by this method and must be jailbroken or use tethered launch. As always, please report all bugs to [Github](https://github.com/utmapp/UTM/issues) ## Changes * Updated QEMU backend from 5.1.0 to 5.2.0-rc3 with [additional patches][6] for virtualization support on Apple M1 Macs * *Potentially VM breaking change*: For newly created VMs, `-device virtio-gpu-pci` is no longer added by default to `virt` machines (ARM64). This is due to newer versions of OVMF not supporting the option. On existing VMs, the option is moved to QEMU custom arguments. * An issue prevented auto-detection of CPU cores on supported configurations (weak on weak) * Correct missing names for some network cards (#706) * Some minor description changes in System settings * (iOS 14) Removable drives and shared directory works outside of the sandbox * (macOS) Bug where new VM button was not working (#704) * (macOS) Fix mouse dragging in capture mode * (macOS) Disabled App Sandbox since a macOS bug prevents Hypervisor.framework from working inside an inherited Sandbox (FB8921623) ## Known Issues * Cannot import any drives/ISO: there is a bug in iOS where an invalid "application-identifier" entitlement causes the file picker to not work. A fix for iOS App Signer is [submitted][4] and can be manually compiled. If you are using AltStore, you need use a free (not paid) developer account. * Starting a VM goes to a black screen on iOS 14: you need to sign UTM with a "development" certificate. If you used a 3rd party signing service, it is probably signed with the wrong certificate. If you signed UTM yourself, make sure you chose a "development" certificate and in iOS App Signer, "No get-task-allow" is unchecked. Please check the full list on [Github][1] and help report any bug you find that is not listed. [1]: https://github.com/utmapp/UTM/issues [2]: https://dantheman827.github.io/ios-app-signer/ [3]: https://github.com/utmapp/UTM/blob/master/Documentation/TetheredLaunch.md [4]: https://github.com/DanTheMan827/ios-app-signer/pull/163 [5]: https://github.com/utmapp/UTM/issues/537 [6]: https://github.com/utmapp/qemu/releases/tag/v5.2.0-rc3-asi

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. UTM 2.0 also updates the QEMU backend from 4.2.0 to 5.1.0 (for all supported iOS versions). Installation instructions differ depending on what version of iOS you are running: * iOS 11-13: You can install and run UTM using any version of AltStore (recommended) or [iOS App Signer][2]. * iOS 14: You must either be jailbroken or follow the [tethered launch][3] instructions every time you launch UTM. Note that the jailbroken instructions are currently outdated. If you have a good guide, please let us [know][5]. * iOS 14.2: You can use either the beta AltStore (1.4.2) or [iOS App Signer][2]. Note A11 and older devices are not supported by this method and must be jailbroken or use tethered launch. As always, please report all bugs to [Github](https://github.com/utmapp/UTM/issues) ## Changes * (macOS) Fixed empty error message when creating a new drive (#565) * (macOS) Implemented debug logging (#575) * (macOS) Various UI/interface issues fixed * (macOS) Implemented console display mode * (macOS) Mouse capture mode stuck on corner of the screen (#576) * (macOS) Removing a removable disk image on the home screen will now persist if VM is not started * (iOS) On < A12 devices running iOS 14.2, an error message will show up on startup to alert user that it is not compatible ## Known Issues * Cannot import any drives/ISO: there is a bug in iOS where an invalid "application-identifier" entitlement causes the file picker to not work. A fix for iOS App Signer is [submitted][4] and can be manually compiled. If you are using AltStore, you need use a free (not paid) developer account. * Starting a VM goes to a black screen on iOS 14: you need to sign UTM with a "development" certificate. If you used a 3rd party signing service, it is probably signed with the wrong certificate. If you signed UTM yourself, make sure you chose a "development" certificate and in iOS App Signer, "No get-task-allow" is unchecked. Please check the full list on [Github][1] and help report any bug you find that is not listed. [1]: https://github.com/utmapp/UTM/issues [2]: https://dantheman827.github.io/ios-app-signer/ [3]: https://github.com/utmapp/UTM/blob/master/Documentation/TetheredLaunch.md [4]: https://github.com/DanTheMan827/ios-app-signer/pull/163 [5]: https://github.com/utmapp/UTM/issues/537

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. UTM 2.0 also updates the QEMU backend from 4.2.0 to 5.1.0 (for all supported iOS versions). Installation instructions differ depending on what version of iOS you are running: * iOS 11-13: You can install and run UTM using any version of AltStore (recommended) or [iOS App Signer][2]. * iOS 14: You must either be jailbroken or follow the [tethered launch][3] instructions every time you launch UTM. Note that the jailbroken instructions are currently outdated. If you have a good guide, please let us [know][5]. * iOS 14.2: You can use either the beta AltStore (1.4.2) or [iOS App Signer][2]. Note A11 and older devices are not supported by this method and must be jailbroken or use tethered launch. As always, please report all bugs to [Github](https://github.com/utmapp/UTM/issues) ## Changes * (iOS 14, macOS): Fixed an issue with the welcome screen not updated for dark mode * (iOS 14, macOS): Add back the option to specify boot device order. * (macOS): Fix context menu not showing on right click on the sidebar * (macOS): Fix play button not working on the sidebar * (macOS): Sign release to prevent "damaged and cannot be opened" error * (macOS): Hardened runtime and notarization to prevent gatekeeper issues and "internal error" on startup ## Known Issues * Cannot import any drives/ISO: there is a bug in iOS where an invalid "application-identifier" entitlement causes the file picker to not work. A fix for iOS App Signer is [submitted][4] and can be manually compiled. If you are using AltStore, you need use a free (not paid) developer account. * Starting a VM goes to a black screen on iOS 14: you need to sign UTM with a "development" certificate. If you used a 3rd party signing service, it is probably signed with the wrong certificate. If you signed UTM yourself, make sure you chose a "development" certificate and in iOS App Signer, "No get-task-allow" is unchecked. * Removable drives (changing images, etc) not working completely yet. For now, use the import drive feature instead to copy the disk image to the .utm bundle. Please check the full list on [Github][1] and help report any bug you find that is not listed. [1]: https://github.com/utmapp/UTM/issues [2]: https://dantheman827.github.io/ios-app-signer/ [3]: https://github.com/utmapp/UTM/blob/master/Documentation/TetheredLaunch.md [4]: https://github.com/DanTheMan827/ios-app-signer/pull/163 [5]: https://github.com/utmapp/UTM/issues/537

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. UTM 2.0 also updates the QEMU backend from 4.2.0 to 5.1.0 (for all supported iOS versions). Installation instructions differ depending on what version of iOS you are running: * iOS 11-13: You can install and run UTM using any version of AltStore (recommended) or [iOS App Signer][2]. * iOS 14: You must either be jailbroken or follow the [tethered launch][3] instructions every time you launch UTM. * iOS 14.2: You can use either the beta AltStore (1.4.2) or [iOS App Signer][2]. Note A11 and older devices are not supported by this method and must be jailbroken or use tethered launch. As always, please report all bugs to [Github](https://github.com/utmapp/UTM/issues) ## Changes * Deleting a drive now actually deletes the data * Booting Linux kernel works again (#515) * Fixed default settings not being loaded including default cursor settings * (macOS) Fixed internal error on startup ## Known Issues * AltStore cannot install UTM on iOS 14: make sure you are running AltStore 1.4.2 or higher. At time of writing, 1.4.2 beta is only available to AltStore Patreon beta testers. For those without access, you can use [iOS App Signer][2]. * Cannot import any drives/ISO: there is a bug in iOS where an invalid "application-identifier" entitlement causes the file picker to not work. A fix for iOS App Signer is [submitted][4] and can be manually compiled. * Starting a VM goes to a black screen on iOS 14: you need to sign UTM with a "development" certificate. If you used a 3rd party signing service, it is probably signed with the wrong certificate. If you signed UTM yourself, make sure you chose a "development" certificate and in iOS App Signer, "No get-task-allow" is unchecked. Please check the full list on [Github][1] and help report any bug you find that is not listed. [1]: https://github.com/utmapp/UTM/issues [2]: https://dantheman827.github.io/ios-app-signer/ [3]: https://github.com/utmapp/UTM/blob/master/Documentation/TetheredLaunch.md [4]: https://github.com/DanTheMan827/ios-app-signer/pull/163

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. UTM 2.0 also updates the QEMU backend from 4.2.0 to 5.1.0 (for all supported iOS versions). Installation instructions differ depending on what version of iOS you are running: * iOS 11-13: You can install and run UTM using any version of AltStore (recommended) or [iOS App Signer][2]. * iOS 14: You must either be jailbroken or follow the [tethered launch][3] instructions every time you launch UTM. * iOS 14.2: You can use either the beta AltStore (1.4.2) or [iOS App Signer][2]. Note some people report issues with this, please [post the device model you're running if it does not work][4]. Notice to users of previous versions: If you are running an older version of UTM (v1 or v2 beta), please note that because the bundle identifier has changed, it will install as a new app and AltStore will not show an update for your existing app. You should manually move your VMs to the new app. We are also retiring the distinction of beta vs release. Since we don't have dedicated testers or a QA team, it is misleading to label something as 'beta' or 'release' when every build incrementally improves upon the last one. As always, please report all bugs to [Github](https://github.com/utmapp/UTM/issues) One more thing... macOS 11 universal builds will now be included in the releases. Be warned that currently the macOS builds are still very unstable. ## Changes (from last update) * Fix port forwarding (broken in last update) * (iOS 14) Add confirmation popup for delete/clone/stop operations * (iOS 14) Fix issue on iPad where a delete VM still shows its details page ## Changes (highlights since v1.0) * (iOS 14) Brand new UI for the home view and configuration views * (iOS 14) Advanced mode: bypass QEMU arguments generated by configuration and pass args directly (#381) * (iOS 14) Sort VMs on home view (#356) * QEMU updated from 4.2.0 to 5.1.0 * Removable drives and changing discs while VM is running (#109) * Jailbroken devices can use more JIT memory (#67) ## Known Issues Please check the full list on [Github][1] and help report any bug you find that is not listed. [1]: https://github.com/utmapp/UTM/issues [2]: https://dantheman827.github.io/ios-app-signer/ [3]: https://github.com/utmapp/UTM/blob/master/Documentation/TetheredLaunch.md [4]: https://github.com/utmapp/UTM/issues/516

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. However, iOS 14.2 introduces a new method for running UTM's JIT engine (untethered). As of this release, the changes to AltStore required for the new method are not released yet, so for now the recommended way to install UTM for iOS 14.2 is **not** to use AltStore. You should use [iOS App Signer][2] until the new AltStore is released. As always, please report all bugs to [Github](https://github.com/utmapp/UTM/issues) ## Changes * (iOS 14) Detect new iOS 14.2 JIT enable method (see above) * (iOS 14) Disable modifying VM settings when suspended (#476) * (iOS 14) When VM is suspended, add toolbar/menu option to delete save state. Also show suspended state in details view. * Fix QEMU issue where on some occasion, "Could not remap code buffer mirror" error shows up on launch. ## Known Issues Please check the full list on [Github][1] and help report any bug you find that is not listed. [1]: https://github.com/utmapp/UTM/issues [2]: https://dantheman827.github.io/ios-app-signer/

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](https://github.com/utmapp/UTM/issues) ## Changes * (iOS 14) Really fix drive import error and UTM import error (thanks @kkk669) * (iOS 14) Fixed crash on APRR devices (including iPhone 12) * (iOS 11-14) Added new warning when trying to import a .utm as a drive image (#497) * (iOS 14) Fixed number text field input and input validation in various settings pages * Updated zh-Hans translation (thanks @ty-yqs) * Updated ko translation (thanks @obbcth) ## Known Issues Please check the full list on [Github][1] and help report any bug you find that is not listed. [1]: https://github.com/utmapp/UTM/issues

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](https://github.com/utmapp/UTM/issues) ## Changes * (iOS 14) Fix import drive permission error * (iOS 11-12) Fix launching on older versions without SwiftUI.framework * Updated Zh-Hans translation (thanks @Ty-programmer) ## Known Issues Please check the full list on [Github][1] and help report any bug you find that is not listed. [1]: https://github.com/utmapp/UTM/issues

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](https://github.com/utmapp/UTM/issues) ## Changes * Fix black screen on startup (#453) * Fix drive selection on legacy UI (#472) * Fix duplicate VM entries (#455) * Fix import drive button (#475) ## Known Issues Please check the full list on [Github][1] and help report any bug you find that is not listed. [1]: https://github.com/utmapp/UTM/issues

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](https://github.com/utmapp/UTM/issues) ## Changes * Fixed “Could not allocate dynamic translator buffer” on jailbroken devices (#459) * Implemented APRR JIT for < iOS 14. This means non-jailbroken devices on < iOS 13.5 (thanks to Psychic Paper) and ALL jailbroken devices get improved JIT. These devices no longer have the 1/2 JIT cache penalty (and can allocate a bit more guest RAM). The kernel instability from improper exit should also no longer affect these devices and you can now terminate UTM by swiping up from the task switcher. ## Known Issues Please check the full list on [Github][1] and help report any bug you find that is not listed. [1]: https://github.com/utmapp/UTM/issues

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](https://github.com/utmapp/UTM/issues) ## Changes Beta 2 fixes a couple of issues that prevented VMs from working. * Fixed error popup when opening from AltStore (#449) * Fixed creating VMs due to incorrect type (#449) * Fixed issue identifying if running with jailbroken entitlement (#451) ## Known Issues Please check the full list on [Github][1] and help report any bug you find that is not listed. [1]: https://github.com/utmapp/UTM/issues

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](https://github.com/utmapp/UTM/issues) ## 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)

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][1] and help report any bug you find that is not listed. [1]: https://github.com/utmapp/UTM/issues

For the next few months, expect only bug fixes and minor tweaks. PLEASE help us by submitting any issues you find on [Github][1] (after searching). ## Changes * Added link to the [User Guide][2] 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][1] and help report any bug you find that is not listed. [1]: https://github.com/utmapp/UTM/issues [2]: https://getutm.app/guide/

For the next few months, expect only bug fixes and minor tweaks. PLEASE help us by submitting any issues you find on [Github][1] (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][1] and help report any bug you find that is not listed. [1]: https://github.com/utmapp/UTM/issues

For the next few months, expect only bug fixes and minor tweaks. PLEASE help us by submitting any issues you find on [Github][1] (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][1] and help report any bug you find that is not listed. [1]: https://github.com/utmapp/UTM/issues

For the next few months, expect only bug fixes and minor tweaks. PLEASE help us by submitting any issues you find on [Github][1] (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 (directindirect) 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][1] 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. [1]: https://github.com/utmapp/UTM/issues

For the next few months, expect only bug fixes and minor tweaks. PLEASE help us by submitting any issues you find on [Github][1] (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][1] and help report any bug you find that is not listed. [1]: https://github.com/utmapp/UTM/issues

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][1] (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][1] and help report any bug you find that is not listed. [1]: https://github.com/utmapp/UTM/issues

🐰🥚🔔 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][1] 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][1]) * 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][2] 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][2]. [1]: https://www.spice-space.org/download.html [2]: https://github.com/utmapp/UTM/issues

## 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][1] 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][2] 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. [1]: https://www.spice-space.org/download.html [2]: https://github.com/utmapp/UTM/issues

## New Features * Touchscreen/tablet mode (configure in Settings) * Apple Pencil support * Improved button contrast in toolbar and pause screen * iPadOS 13.4 touchpad navigation for home and VM toolbar * Specify image for BIOS, Linux Kernel/initrd/DTB * Configure sound card hardware to emulate ## Bug Fixes * Do not attempt to restore VM if it failed before (#164) * Disable Save button if name is empty in configuration (#169) * Fixed paste function racing modifier keys (#163) * If QMP connection fails, will retry (#172) * Network disable from configuration implemented * Fixed some input issues booting aarch64 ## Known Issues * Keyboard arrow keys not working on aarch64 (#188) * Touchpad not working in VM (#176) ## Other Information We now have an [AltStore][1] repo at **https://alt.getutm.app** which will allow you to get update notifications. This is also the new preferred way of installing UTM on non-jailbroken devices. [1]: https://altstore.io

## New Features * Pause/resume VM * Restart VM * Auto-save state on background and/or low memory warning * Preferences page for controlling auto-save and gestures * Configure gestures (change two finger tap, long press, etc) * Save display position/zoom automatically ## Bug Fixes * Add delay in mouse up and key up events fixing broken cursor/keyboard in PPC/aarch64/others (#145) * Fix pasting long text (#151) * Rare crash due to texture buffer not being locked correctly (#23) * Fix issue of PPC QEMU trying not supporting QXL ## Other Information iOS 13.4 fixes the signing bug that prevents free accounts from signing UTM. You can now sign UTM every 7 days with a free developer account again.

This release is focused on the configuration UI. * Better way of adding advanced QEMU options as a list (thanks @spotlightishere ) * Fixed audio (AC97 guest drivers may need to be installed) (thanks @js-john ) * Improved zh-Hans translation (thanks @js-john ) * Fixed mouse hold & drag (broken in last release) * Added option to force multi-core TCG (ONLY for advanced users, this WILL break x86_64 emulation. For most people running i386/x86_64 there is no performance advantage for > 1 core! Any more cores will degrade performance!). Changed default core count to 1 for the same reason. * Added option to specify JIT cache size (allows more fine tuning with limited host memory, more JIT cache = faster execution, more guest RAM = more concurrent applications running) * Show available system memory, available system cores, and estimated memory usage for easier configuration * Added target machine picker. Fine tune emulation by specifying a target machine (like RPI3 for aarch64 for example). Default machine will be selected automatically which is the old behaviour. * Save the display state when VM is shut down: the zoom and position of the display as well as the visibility of the toolbar and keyboard * Debug logging: when enabled `debug.log` will be created in the .utm bundle. Can aid in debugging issues. You can also export the debug log easily from the configuration screen. * A warning message shows up now when attempting to change unimplemented configuration settings

* Reimplemented hardware keyboard support: includes arrow keys, modifier keys, etc * Two finger swipe up or down maps to mouse wheel up and down * Trigger network usage popup in Chinese region * Implemented deleting and cloning VM: long press on the icon in the list view to see the context popup * Show an error message when QEMU fails (instead of crashing) * Mouse acceleration & inertia: fast swipe moves mouse cursor farther * Mouse cursor shows up when QXL drivers are installed (can now install SPICE drivers on Windows and fixes mouse cursor not appearing in many Linux distros) * Prompt disk data to be deleted when a drive is removed

* Add zh-Hans language (thanks @Evsio0n ) * Fixed an issue where on some jailbroken device with conflicting libraries installed, UTM refuses to launch even with a correct signature * Fixed an issue with toolbar icons overlapping and made size of toolbar icons more consistent (thanks @fredyshox ) * Fixed dark mode keyboard if transition happens while keyboard was open * Redesigned the extra keys above the keyboard: larger keys on iPads, keys are visible above home screen bar, added a few extra keys * Fixed an issue where smart keys get triggered in some circumstances * Fixed an issue where predictive keyboard text does not get entered * Implemented hardware keyboard without needing to be activated with the keyboard button. Also allows hardware keyboard to work without the extra key strip active. * Implemented paste function in the keyboard * Fixed an issue where import disk image does not work on directories outside the UTM documents. (thanks @humboldtjs ) * Implemented click-and-drag: long-press on the screen (0.5s) until you feel a click, then you can move the cursor to drag items. * Show an alert when low on memory * Show an alert when trying to launch a new VM * Added a new exit button on the home screen and a welcome message explaining the need for it (#32 ) https://getutm.app/install for installation instructions.

This is exactly the same as v0.2 release but the IPA is fakesigned so jailbroken users can install it directly. Non-jailbreak users still must re-sign the IPA.

* Fixed white screen/must restart device on crash issues (thanks @saagarjha). Note that white screen issue still occurs if app is force-killed in any way. * Fixed issue creating non x86_64/i386 machines (thanks @ledwardchow) * Implemented bulletproof JIT (should improve performance by up to 25%) https://getutm.app/install for installation instructions.

Please visit https://getutm.app/install for more details.