Skip to content

LightTouch v0.0.14: game controllers on the desktop, faster games, and iPads at real size

Latest

Choose a tag to compare

@blake-lucas blake-lucas released this 21 Nov 20:39

LightTouch v0.0.14: game controllers on the desktop, faster games, and iPads at real size

LightTouch emulates classic iPods and iPhones running iOS on Android, Linux, Windows and macOS. This release adds game controller, keyboard and mouse controls to the desktop app, brings in the November speed and correctness fixes from upstream qemu-ios, and fixes games that ran at double speed, movies that juddered on the iPad, slow jailbroken devices, and a slowdown on Linux after some games used the network. When something goes wrong, LightTouch can now save its logs for a bug report. The desktop app can also show an iPad at its real size, and Windows now downloads as a single .exe. The iPod touch 2G on iOS 3.1.3 is still the easiest place to start.

LightTouch is still early, and things can change or break between versions. Android has had the most testing.

Downloads

File For
LightTouch-v0.0.14-android-arm64.apk Android 10+ on 64-bit ARM. Installs over v0.0.13 and keeps your devices.
LightTouch-v0.0.14-Linux-x86_64.AppImage x86_64 Linux with glibc 2.31+ (Debian 11, Ubuntu 20.04 and newer). chmod +x, then run it; without FUSE, add --appimage-extract-and-run.
LightTouch-v0.0.14-Windows-x86_64.exe 64-bit Windows 10 or 11. A single file now: run it. The first start of each version unpacks it, which takes a few seconds.
LightTouch-v0.0.14-macOS-arm64.zip Apple Silicon Macs, macOS 26+. Not notarized: the first time, allow it in System Settings › Privacy & Security.
armv6.itpack, armv7.itpack Guest tools (the helpers LightTouch installs inside iOS), attached for reference. Every download above already has them built in.

LightTouch does not include iOS itself. Every version downloads Apple's iOS file (an IPSW) for the device you pick and prepares it. If you already have the IPSW, you can choose it instead of downloading. docs/ASSETS.md says where everything comes from.

What's new

Controllers, keyboard and mouse (desktop)

The desktop app has a new Controls button in the dock. It opens a window where you build a set of controls for a game and place them on the device's screen. Each binding turns a controller button, stick, key or the mouse into touches:

  • Tap a spot, held, toggled or repeated, and Swipe along a line.
  • Joystick: a stick, the D-pad or four keys drive a finger around an on-screen stick, for games with a virtual thumbstick.
  • Look around: a stick or the mouse drags across part of the screen, for a game's camera. Mouse looks locks the mouse to the game, as in a PC shooter. Hold Ctrl (by default) to use the mouse on the game's buttons, and press Escape to get the mouse back for LightTouch. For games that fire with a tap, a button (left click, when the mouse looks) can tap where the finger is; if a game misses fast taps, Tap lift under More options gives each tap a longer gap.
  • Pointer: a stick moves a finger over part of the screen, for games you play by touching anywhere.
  • Tilt from a stick, for games you steer by tilting. You choose how the device rests when the stick is let go (upright, flat on a table, on its side and so on), and an optional button keeps the lean you've found as the new resting point.
  • Motion: your controller's own motion sensors tilt the device. Lying flat, the controller is the device lying flat on a table; Set level makes the way you hold it level instead.
  • Home, Sleep and the volume buttons.

A binding can work only while another button is held, so one controller can do more. Sets of controls can be linked to games, so they switch on by themselves when that game opens, and they can be exported and shared. The arrow keys can still tilt the device without setting anything up.

Controllers have been tried on Windows, Linux and macOS. On some Linux systems, reading the motion sensors in Switch and PlayStation controllers needs a permission the system doesn't give by default. When that happens, the controller's card says so and offers Allow access, which installs a small system rule after asking for your password. Other systems, such as Bazzite, already allow it, so there's nothing to set up.

iPads at their real size (desktop)

Settings › Display › iPad size shows an iPad at its real size on your monitor, for toys and pieces that were made to be used on an iPad's screen. You measure your display once by holding a bank card or a ruler against the screen. If the whole iPad doesn't fit, LightTouch shows its screen at full size and leaves out the frame around it. Thanks to Rayly Retro for the idea and the first implementation.

Faster and more accurate

  • Upstream engine fixes. This release takes the November speed and correctness fixes from qemu-ios, the emulator LightTouch is built on. For example, Epic Citadel on the iPod touch 4G went from about 40 to 43 frames a second on a Poco F3. They also fix several drawing problems inside iOS, such as Cover Flow and some 3D effects.
  • Games no longer run at double speed. Doodle Jump, and other games made for iOS 2 to 5 that time themselves by the screen's refresh, could run twice as fast as on a real device. They now run at the right speed.
  • Movies on the iPad no longer judder. Video, such as the intro of Epic Citadel, showed some frames out of order on the iPad, iPod touch 4G and iPhone 4.
  • Zombie Gunship shows its world. On the iPod touch 4G, the game drew its buttons and menus, but the world behind them stayed black.
  • Switching games on the iPad no longer freezes the screen. With a few games left open in the background, the one in front could stop drawing.
  • Jailbroken devices from v0.0.13 are fast again. On a jailbroken iPod touch 3G or iPhone 3GS, one of iOS's background services kept crashing and restarting, which slowed every game down. These devices are repaired automatically the next time they open. On the iPod touch 3G on a Linux PC, a game went from about 20 to 28 frames a second.

Tilt and motion

  • Tilting keeps its lean. Holding a tilt used to drift back to level after a moment, so steering games stopped turning.
  • Rest matches the screen. The device rests upright the way the desktop app shows it, including when it's turned on its side. Tilting rocks it side to side like a steering wheel, so a landscape racing game steers the way you'd expect.
  • On iOS 3.0 and later, including the iPod touch 2G, and on the iPhone 4, the device reported itself face down while lying face up. It now reports it correctly.

Logs for bug reports

LightTouch now keeps logs of what it and the emulator did, so a problem can be reported after it happens without turning anything on first. Settings › Diagnostics › Export logs saves them as one zip file to attach to a GitHub issue. When preparing a device finishes or fails, that page has a Save logs button too. The zip holds LightTouch's own logs, the emulator's and iOS's, and a summary of your phone or computer and your devices. It leaves out your files, firmware and personal details, and only the current and previous run of each log is kept, so they stay small. The issue forms say what else helps.

Everywhere

  • Force stop works while an app installs. Once iOS has started installing an app, it can't shut down until the install finishes, and Stop wasn't available until then. Stop now offers Force stop, which ends the device straight away; the app being installed is lost, and the next start checks the device's storage first.
  • Double and triple clicks of Home reach iOS as that many presses, for example to open the app switcher. A very quick click now also counts.
  • When a guest tools update arrives, LightTouch checks the device can use it before installing.

Desktop

  • Linux: no more slowdown after games that use the network. When a game's network connection closed, for example after playing Real Racing HD on the iPad, the emulator could get stuck checking it over and over. The device then showed a new frame only every few seconds, even back on the Home screen, until it was restarted.
  • Windows: Detailed frame timing works. With Settings › Diagnostics › Detailed frame timing on, every device start showed "Profile capture: Invalid argument" and the frame inspector had no detail to show.
  • Windows touchscreens: touches with two or more fingers at once were dropped; this is fixed, though it hasn't been tried on many touchscreens yet. Thanks to Rayly Retro, whose video showed the problem.
  • While apps are installing, the install queue's progress shows on the device page, next to the Legacy Store button.
  • Buttons no longer shift slightly when you hover over them.

Which devices are tested

Unchanged from v0.0.13: the iPod touch 2G (3.1.3 and 4.2.1), iPod touch 3G (4.2.1), iPod touch 4G (6.1.6), iPhone 3GS (5.1.1), iPhone 4 (4.2.1, 4.3.5 and 6.1.3) and the iPad (5.1.1) are tested. The iPod touch 1G and the original iPhone still say Doesn't start yet.

Guest tools

Devices update their guest tools automatically the next time they start.

Known limits

  • The iPod touch 1G and the original iPhone stop at a white screen after they are set up.
  • On a device that isn't connected to iTunes, iOS shows "Connect to iTunes to Use Push Notifications" when some games open, which pauses the game. Tap OK to carry on.
  • The iPhone 3GS's microphone records silence.
  • Jailbreaking is not available on the iPod touch 2G.
  • On some phones, preparation can stop making progress if the phone is locked while it runs. Keep the screen on until it finishes.
  • iOS 7 has had very little testing.
  • Some Store apps marked compatible still need a newer iOS than the device runs and quit right after opening. Try an older version of the app.
  • Storage formats can still change between versions. Keep a copy of devices you care about.

Source and checksums

Built from LightTouch tag v0.0.14 (b9f93d0d) and tag lighttouch-v0.0.14 (60b1aacfb4) of the emulator engine, qemu-ios. Both source archives, SHA256SUMS and RELEASE-MANIFEST.json are attached. GPL-2.0-or-later; see LICENSE.txt.

442f1cfabea69dc95e27093b51e86bf7ee37f1105a7719f2ae97c3896e9a855a  LightTouch-v0.0.14-android-arm64.apk (43760181 bytes)
eee2e7262cf76f3a949d180dcec59457a896125c5623bb743a77b1e5e0f027a8  LightTouch-v0.0.14-Linux-x86_64.AppImage (44366328 bytes)
b0f1b20d702eaea78d89692cfa04350ddd7e2c5f89b2d1756a2b82c6d92c27bc  LightTouch-v0.0.14-Windows-x86_64.exe (77417816 bytes)
c3b61fe2d76ea704f968d4bfa61f53715e0f6d55e680a7f1c26e1b8a497460e1  LightTouch-v0.0.14-macOS-arm64.zip (34548659 bytes)
60630eac6489e15fa2c389b3ef4e24bfe9afdfa889b8d5dec29c425209acb273  armv6.itpack (1017066 bytes)
2d2df787f670acec6d38d6a2012bd611b3f47870bb58ab61f51a21a8c7fed174  armv7.itpack (1743673 bytes)
132758a79ac34bbea7cfb532b161c464edff88eb1bf756dac09d91aa24c49fb7  LightTouch-v0.0.14-source.tar.gz (3494133 bytes)
f2be5500d2cc631b3eda694e7df6bada6e64a99e6396b2df68c264f56623fb7f  qemu-ios-v0.0.14-source.tar.gz (55499362 bytes)