Repository navigation
LightTouch v0.0.6: smoother Android games, downloadable guest tools, startup fix
Pre-releaseLightTouch v0.0.6: smoother Android games, downloadable guest tools, startup fix
LightTouch emulates an iPod touch 2G running iOS 3.1.3 on Android, Linux, Windows and macOS.
This is an early alpha, published as a pre-release.
Downloads
| File | For |
|---|---|
LightTouch-v0.0.6-android-arm64.apk |
Android 10+ on 64-bit ARM. Installs over v0.0.5 and keeps your devices. |
LightTouch-v0.0.6-Linux-x86_64.AppImage |
x86_64 Linux with glibc 2.31+ and X11 or XWayland. chmod +x, then run it; without FUSE, add --appimage-extract-and-run. |
LightTouch-v0.0.6-Windows-x86_64.zip |
64-bit Windows. Extract the whole zip, then run LightTouch.cmd. |
LightTouch-v0.0.6-macOS-arm64.zip |
Apple Silicon Macs, macOS 26+. Not notarized: allow it in System Settings › Privacy & Security. |
armv6.itpack |
New: guest tools for the iPod touch 2G (the helpers LightTouch installs inside iOS). |
LightTouch does not include iOS itself. docs/ASSETS.md explains how to get the iOS system and boot file; a script does it for you. The script also gives you an older armv6.itpack: use the one attached here instead.
What's new
Smoother games on Android
When the emulated CPU had to wait briefly for another part of the emulator, it went to sleep at
once, and on phones waking up again often costs a millisecond or more. It now waits a moment before
sleeping, so these short waits no longer stall the game.
Measured on a Poco F3, a phone with a Snapdragon 865-class chip, on Jetpack Joyride's title screen:
| Frame rate (of 60) | Stutters (frames over 50 ms) per minute | |
|---|---|---|
| v0.0.5 with the older guest tools | about 39 fps | over 200 |
| v0.0.5 with the new guest tools | about 53 fps | about 10 |
| v0.0.6 with the new guest tools | about 58 fps | about 4 |
Flight Control runs at about 59 of 60 fps with the new guest tools (about 55 before).
The desktop builds already ran these games at full speed and don't use this change.
Guest tools you can download
The guest tools for the iPod touch 2G are now attached to the release (armv6.itpack). They include the
graphics fix behind most of the gains above: the older guest tools wrote a log message for every
frame a game drew, and iOS spent much of its time processing those messages.
To give them to a device you already have, keeping its apps and data: on Android, stop the device and
tap Guest tools; on Linux, run
lighttouch-linux --library LIB --record ID --set-guest-package armv6.itpack. They install the next
time iOS starts. On Windows and macOS, choose the new file when you set up a new device.
Fixes and smaller changes
- iOS systems from the recommended download failed to start in v0.0.5 on every platform, with an
error that mentionsaes-uid. They start now. - Choose which version of an app to install (Linux and Windows): the Apps window lists the
versions that run on the emulated iPod, as Android's Store already did. The version it chose before
could need a newer iOS: Doodle Jump 3.x, for example, opens and then quits; pick 2.10.1 or older. - Android: Start profile / Stop profile records a performance capture of a game while you play,
for bug reports. Getting it off the phone needsadb; see
docs/PROFILING.md.
Known limits
- Only Android and Linux can give new guest tools to an existing device.
- The macOS build is compiled and packaged but was not run for this release.
- Some Legacy Store apps marked compatible still need a newer iOS than 3.1.3 and quit right after
opening. Try an older version of the app. - Alpha storage formats can change. Keep a copy of saved devices you care about.
Source and checksums
Built from LightTouch tag v0.0.6 (3c9de409) and the emulator engine, tag lighttouch-v0.0.6
(e95888e9cb) of qemu-ios. Both source archives,
SHA256SUMS and RELEASE-MANIFEST.json are attached. GPL-2.0-or-later; see LICENSE.txt.
ef1ecb7fd065a8b84792e33d99c5e1d001eef8fab52a12f2b411a1412a0c9b0c LightTouch-v0.0.6-android-arm64.apk (48742009 bytes)
1dbe1f0a867d985167421883b16f6567a6e662370b93df8e6342fd7566197e86 LightTouch-v0.0.6-Linux-x86_64.AppImage (204012024 bytes)
68c8494408d2139c5e84ba442f334091a22a22a296e23b58401e42aab0f1a3ae LightTouch-v0.0.6-Windows-x86_64.zip (90892923 bytes)
422e9e8628dd23db7799adc57368e5e5d53a1feab40df1c804227b8f2e80389e LightTouch-v0.0.6-macOS-arm64.zip (52859474 bytes)
f27df777f73db2db6c66f7f786e676e250e351ba017fedbac850bac2955894f6 armv6.itpack (986540 bytes)
0c1fe9ad567d766625f466dd1a1e9dc344971bad8da8c4d811c27f9999f3935f LightTouch-v0.0.6-source.tar.gz (2970099 bytes)
47b9b6698d6d567f5c1a7a8f26a38fcc9688e929299982c1cec34a9e65d6fb94 qemu-ios-v0.0.6-source.tar.gz (70132153 bytes)