Run virtual machines on iOS

osy a8a0363b9e build: update SPICE and SPICE client		3 years ago
.github	github: add automation step to submit to App Store Connect	3 years ago
Configuration	config: removed displayFitScreen setting	3 years ago
Documentation	docs: added release document	3 years ago
Icons	Add Pop!_OS icon	4 years ago
JailbreakInterposer	interposer: disable for simulator builds	4 years ago
Managers	vm: proper handling of scoped access	3 years ago
Platform	settings: auto resolution is tied to clipboard sharing	3 years ago
QEMUHelper	wizard: convert VHDX to QCOW2 for Windows VM	4 years ago
QEMULauncher	project: moved QEMULauncher-InfoPlist.strings to correct group	4 years ago
Renderer	project: refactored CocoaSpice into package	4 years ago
UTM.xcodeproj	CocoaSpice: fix freezing during restart of GL VM	3 years ago
patches	build: update SPICE and SPICE client	3 years ago
qapi	qapi: support handling VNC events	4 years ago
scripts	build: update SPICE and SPICE client	3 years ago
.gitignore	project: move code signing config to external file	4 years ago
.gitmodules	project: mass rename and reorganize	5 years ago
Build.xcconfig	project: bumped version	3 years ago
CodeSigning.xcconfig.sample	build: make entitlement use configurable	4 years ago
LICENSE	UTM: implemented main view and configuration views	6 years ago
README.md	readme: update license	4 years ago
README.zh-Hans.md	Update README.zh-Hans.md	4 years ago
README.zh-Hant.md	Fix typos	4 years ago
screen.png	Update screen.png	4 years ago

README.md

UTM

It is possible to invent a single machine which can be used to compute any computable sequence.

-- Alan Turing, 1936

UTM is a full featured system emulator and virtual machine host for iOS and macOS. It is based off of QEMU. In short, it allows you to run Windows, Linux, and more on your Mac, iPhone, and iPad. More information at https://getutm.app/ and https://mac.getutm.app/

Features

Full system emulation (MMU, devices, etc) using QEMU
30+ processors supported including x86_64, ARM64, and RISC-V
VGA graphics mode using SPICE and QXL
Text terminal mode
USB devices
JIT based acceleration using QEMU TCG
Frontend designed from scratch for macOS 11 and iOS 11+ using the latest and greatest APIs
Create, manage, run VMs directly from your device

Additional macOS Features

Hardware accelerated virtualization using Hypervisor.framework and QEMU
Boot macOS guests with Virtualization.framework on macOS 12+

UTM SE

UTM/QEMU requires dynamic code generation (JIT) for maximum performance. JIT on iOS devices require either a jailbroken device, or one of the various workarounds found for specific versions of iOS (see "Install" for more details).

UTM SE ("slow edition") uses a threaded interpreter which performs better than a traditional interpreter but still slower than JIT. This technique is similar to what iSH does for dynamic execution. As a result, UTM SE does not require jailbreaking or any JIT workarounds and can be sideloaded as a regular app.

To optimize for size and build times, only the following architectures are included in UTM SE: ARM, PPC, RISC-V, and x86 (all with both 32-bit and 64-bit variants).

Install

UTM (SE) for iOS: https://getutm.app/install/

UTM is also available for macOS: https://mac.getutm.app/

Development

macOS Development

iOS Development

iSH: emulates a usermode Linux terminal interface for running x86 Linux applications on iOS
a-shell: packages common Unix commands and utilities built natively for iOS and accessible through a terminal interface

License

UTM is distributed under the permissive Apache 2.0 license. However, it uses several (L)GPL components. Most are dynamically linked but the gstreamer plugins are statically linked and parts of the code are taken from qemu. Please be aware of this if you intend on redistributing this application.

Some icons made by Freepik from www.flaticon.com.

Additionally, UTM frontend depends on the following MIT License components: