Run virtual machines on iOS

osy 30cb9827c8 build: update ANGLE for macOS builds		4 years ago
.github	build: update package_mac tool for launcher provisioning profile	4 years ago
CocoaSpice	CocoaSpice: fix debug logging	4 years ago
Configuration	CocoaSpice: use Unix port for SPICE	4 years ago
Documentation	readme: updated with more information	4 years ago
Icons	project: mass rename and reorganize	5 years ago
JailbreakInterposer	interposer: disable for simulator builds	4 years ago
Managers	CocoaSpice: fix debug logging	4 years ago
Platform	config: gate bridged networking behind macOS 11.3	4 years ago
QEMUHelper	project: enable bridged networking	4 years ago
QEMULauncher	project: enable bridged networking	4 years ago
Renderer	renderer: re-work draw lock code for better performance	4 years ago
UTM.xcodeproj	project: add GPU support libraries	4 years ago
gstreamer	project: fix warnings	4 years ago
patches	build: update ANGLE for macOS builds	4 years ago
qapi	qapi: fixed missing return check	4 years ago
scripts	build: update ANGLE for macOS builds	4 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	4 years ago
CodeSigning.xcconfig.sample	project: enable bridged networking	4 years ago
LICENSE	UTM: implemented main view and configuration views	6 years ago
README.md	readme: add note about UTM SE processor support	4 years ago
README.zh-Hans.md	Update README.zh-Hans.md	5 years ago
README.zh-Hant.md	build: rename sign to package scripts	5 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

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.