Release Candidate

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

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

Bug Fixes

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

Known Issues

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

Release Candidate

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

New Features

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

Bug Fixes

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

Known Issues

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

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

Preview

🐰🥚🔔 Happy Easter!

New Features

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

Bug Fixes

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

Known Issues

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

Other Information

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

Preview

New Features

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

Bug Fixes

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

Known Issues

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

Other Information

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

Preview

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 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.

Preview

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.

Preview

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

Preview

• 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

Preview

• 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.

Preview

• 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.