Skip to content

LightTouch v0.0.6: smoother Android games, downloadable guest tools, startup fix

Pre-release
Pre-release

Choose a tag to compare

@blake-lucas blake-lucas released this 19 Oct 16:41
· 447 commits to main since this release

LightTouch 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 mentions aes-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 needs adb; 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)