Repository navigation
Releases
LightTouch v0.0.14: game controllers on the desktop, faster games, and iPads at real size
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 qu...
CI inputs 1 (build inputs for CI, not a LightTouch release)
Prebuilt inputs .github/workflows/release-build.yml fetches by SHA-256 (ci/release-inputs.json): the pinned AppImage tool and runtime, the desktop packages' licence notices, the Windows USB bridge (lighttouch-usbmuxd.exe and its DLLs, open-source builds), and the Android build's ANGLE libraries, frontend notices and engine PGO profile. Not an app release; nothing here is for end users. docs/BUILDING.md, "CI builds", says what each is.
LightTouch v0.0.13: microphone, Voice Memos, jailbreak at setup, and a smoother Mac app
LightTouch v0.0.13: microphone, Voice Memos, jailbreak at setup, and a smoother Mac app
LightTouch emulates classic iPods and iPhones running iPhone OS and iOS on Android, Linux, Windows and macOS. This release lets iOS apps that record hear your microphone, makes Voice Memos work on the iPod touch 4G, adds a switch to jailbreak a device while it's being set up, and fixes the Mac app, which in v0.0.12 could fail to start a device, couldn't install apps, and showed at most about 33 frames a second. 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.13-android-arm64.apk |
Android 10+ on 64-bit ARM. Installs over v0.0.12 and keeps your devices. |
LightTouch-v0.0.13-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.13-Windows-x86_64.zip |
64-bit Windows 10 or 11. Extract the whole zip, then run lighttouch.exe. |
LightTouch-v0.0.13-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
Microphone
Settings › Audio › Microphone lets iOS apps that record hear your phone's or computer's microphone. It's off by default. When it's on, the microphone is only open while an iOS app is actually recording, so your system's microphone indicator shows when that happens. It works on the iPhone 4, iPod touch 4G and iPad. The iPhone 3GS records silence for now. Based on the microphone support in Un1box.
Voice Memos on the iPod touch 4G
Voice Memos now records, pauses, stops and plays back on the iPod touch 4G. Before, a recording could never be stopped, and the app kept the device busy until it was restarted. Recordings are real AAC files, as on the iPod.
Jailbreak while setting up
The setup screen has a new Jailbreak switch that installs Cydia and afc2 while the device is prepared. Thanks to bulatorr for contributing it, along with fixes for setting up the iPad, its screen rotation, and iOS 7. The switch is off and locked on the iPod touch 2G, because a jailbroken 2G doesn't start again after its first restart.
Mac
- Smoother. The Mac app showed a new picture at most every 30 ms, so games that run at 60 frames a second looked like 33. It now shows every frame, as the other versions do, and draws its window with Metal, so frames reach the screen evenly and the app scrolls at up to 120 Hz on ProMotion displays.
- Devices start when the app is opened from Downloads. macOS runs an app opened where it was downloaded from a protected copy, and v0.0.12 set up devices from that copy with an empty set of guest tools, so they stopped with "not a guest ITPACK01 archive". Devices set up that way need to be deleted and set up again.
- Installing apps works. v0.0.12's Mac app was missing two libraries that the connection to iOS needs, so the Legacy Store and IPA installs couldn't reach the device.
Everywhere
- Remove an app from its page in the store (Remove from device). LightTouch asks first, then uninstalls the app and its data.
- Force stop. If iOS takes too long to shut down, Stop becomes Force stop, which ends the device at once. The next start checks the device's storage, like after a crash.
- Asphalt 8 starts now. It uses a graphics feature LightTouch didn't support, and crashed straight away.
- 3D games draw a little faster: each frame reads shared geometry from the device once instead of once per part.
- Find out why an app quit. In the store's menu, Why did the last app quit? reads iOS's newest crash report and says where the app crashed and what that likely means (for example, that it needs a newer iOS). Record the next app launch records iOS's system log while you open an app, for apps that close without leaving a crash report. When the emulator itself stops on Android, the banner now says why.
- Settings › Performance › Fewer pauses when apps open (off by default) keeps the emulator's translated code when an app opens, for fewer stalls at the cost of up to about 5% speed in games. From Un1box.
- The performance overlay's full level has a DISK section with the device's storage reads and writes.
- The iPad is drawn as the first-generation iPad, with its own bezel and buttons.
- A new app icon, the same on every platform.
Android
- Setting up a device no longer fails a second into its first boot on some phones (seen on a Poco F3 running LineageOS).
- Less battery use while LightTouch is open: it stops starting a new background thread twice a second, and checks for sound less often while iOS is silent. From Un1box.
- A device that needs recovery shows a warning badge in the device list instead of text that got cut off.
Windows
- Deleting a device works. Before, Windows refused with "Permission denied".
Which devices are tested
- Tested: 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 now 6.1.3), and the iPad (now 5.1.1).
- The "Tested, slow" label is gone; the devices that had it are now simply Tested.
- The iPod touch 1G and the original iPhone now say Doesn't start yet, which is what happens: they stop at a white screen after they're set up.
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. This is being looked into.
- 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.13 (28792077) and tag lighttouch-v0.0.13 (123cd6d9bb) of the emulator engine, qemu-ios. Both source archives, SHA256SUMS and RELEASE-MANIFEST.json are attached. GPL-2.0-or-later; see LICENSE.txt.
47261ad6df029d78de2a788d5f9dd5be8d37bcdad54149a460b57df1e6fbdb83 LightTouch-v0.0.13-android-arm64.apk (43563748 bytes)
e08b2e1dd8b44aadb838a85d78098744cf5185279f902e2d80be9f4a01cf83e2 LightTouch-v0.0.13-Linux-x86_64.AppImage (43055608 bytes)
9b4ad22311a86826e222a5a851a3f50b91e2856beedcd11bdc24026ff5c0a394 LightTouch-v0.0.13-Windows-x86_64.zip (53772547 bytes)
c35b63e7b430520a273e40d7af20bb0b5401646dddf39c2b5a28d41d859b2514 LightTouch-v0.0.13-macOS-arm64.zip (32943765 bytes)
c07013c511596976c7f76b3942f62eb5f25cb626b39c61bef9c9dafa549802ac armv6.itpack (1001698 bytes)
a29bd903e8f6732c0270d304dd36c8110f30f71f8b98d46d9f557f16b1b2dd51 armv7.itpack (1711256 bytes)
668db421f229e7575c2e056a08f672f39f1cf9bf8ffe4efde6331448dfffdb1f LightTouch-v0.0.13-source.tar.gz (3325818 bytes)
2a88f42b3d103dc2dfb0f362349079b043b2b3d547068a90b06625079ffae369 qemu-ios-v0.0.13-source.tar.gz (55410110 bytes)
LightTouch v0.0.12: Wayback Machine + a new desktop app for Linux, Windows and macOS
LightTouch v0.0.12: Wayback Machine + a new desktop app for Linux, Windows and macOS
LightTouch emulates classic iPods and iPhones running iPhone OS and iOS on Android, Linux, Windows and macOS. This release replaces the old desktop versions with one new app that works like the Android app: choose Get started, pick a device and iOS version, and LightTouch downloads iOS and sets it up for you, with no manual steps. It also adds internet access inside iOS, on Android and on computers, through your own connection or the Internet Archive's Wayback Machine. 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.12-android-arm64.apk |
Android 10+ on 64-bit ARM. Installs over v0.0.11 and keeps your devices. |
LightTouch-v0.0.12-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.12-Windows-x86_64.zip |
64-bit Windows 10 or 11. Extract the whole zip, then run lighttouch.exe. |
LightTouch-v0.0.12-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
One desktop app for Linux, Windows and macOS
The old desktop versions needed a device prepared somewhere else. The new app does everything the Android app does:
- Set up devices from an IPSW. Pick a device and iOS version and LightTouch downloads and prepares it, showing its progress. The iPod touch 2G on iOS 3.1.3 takes about a minute. If LightTouch is closed while a device is being prepared, the preparation starts again the next time it opens.
- The Legacy Store, with the same tabs as on Android (For this device, Installed, Featured, Charts, Categories, Collections), app pages and the install queue. You can also install IPA files you have.
- Controls. Click to touch, and hold Alt while dragging to pinch and rotate with two fingers. The arrow keys tilt the device, you can turn the device for landscape apps, and there are on-screen Home, Sleep/Wake and volume buttons. A finger dragged past the screen's edge stays at the edge, as on Android. The ? button beside Settings lists every control and keyboard shortcut.
- The performance overlay and frame inspector, PNG screenshots, profiles, and a licenses page.
- Stopping cleanly. Closing the window shuts iOS down first, so its data is saved.
Devices made with the old desktop versions don't carry over. Set them up again in the new app.
Internet inside iOS
Settings › Network turns on internet access for the emulated device, on Android and on computers. Choose Direct, which uses your own connection, or Wayback Machine, which shows websites as the Internet Archive saved them on a date you choose, so pages look as they did when your iOS version was current. It can be switched on, off or to another date while the device is running, without restarting it.
Android
- When iOS turns the screen off (after pressing Sleep/Wake, or when the screen locks on its own), the screen now goes black on every device. Before, some devices kept showing the last picture.
- The app is about 20 MB smaller: the part that prepares devices was rewritten, and Android and the computers now share it.
- LightTouch's notifications now go away when a device is shut down or installs finish, and say in plain words whether the device is running or paused while you're away.
- Devices are now always set up from an IPSW. The I already have the device files option is gone. Its files came from an old guide and had to be made on a computer, and the app now does all of that itself.
Other fixes
- iPod touch 4G and iPhone 3GS: the level set with the volume buttons now reaches your phone or computer's sound, in steps fine enough that the middle levels are audible. Keyboard clicks, lock sounds and alerts follow Settings › Sounds › Ringer and Alerts instead, as on a real iPod; turn on Change with Buttons there to set them with the volume buttons too.
- Devices set up with this version keep their storage in a single file and give space back when iOS frees it. Devices set up before keep working as they are.
Known limits
- The iPod touch 1G and the original iPhone stop at a white screen after they are set up. This is being looked into.
- The iPhone 3GS and iPhone 4, the iPod touch 3G and the iPad still run noticeably slower than the iPod touch 2G and 4G, especially on phones. The iPad takes several minutes to set up.
- 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 not been tested.
- 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.12 (45db6465) and tag lighttouch-v0.0.12 (c2952e8ea8) of the emulator engine, qemu-ios. Both source archives, SHA256SUMS and RELEASE-MANIFEST.json are attached. GPL-2.0-or-later; see LICENSE.txt.
9d4034d7fa22099d960268a0951834aceaaf7c9e82ff8df5ead862a2a5176b0e LightTouch-v0.0.12-android-arm64.apk (43391028 bytes)
a404129449227a758c728096834a84a9c94b949c0b8da38d5988efe4ffbc1f6a LightTouch-v0.0.12-Linux-x86_64.AppImage (42686968 bytes)
dd1da98c410a4b8cf23e9343708267c9d7438856bca3e0d787f665a1559cc9bd LightTouch-v0.0.12-Windows-x86_64.zip (53545050 bytes)
4e564c3814179aa7edc606b5b603835323ef1a401a75ae99fd25b320ecf39bc5 LightTouch-v0.0.12-macOS-arm64.zip (25505064 bytes)
e843f1ae8abf9f173f8fd95e7eea3126cf17cbf87321574973668d6f1b9b4a2e armv6.itpack (997308 bytes)
ab39ea878f1a88b2000fbda373fc89ef20dea07409b45e773b37646d6da737d1 armv7.itpack (1704835 bytes)
1a47f8d372536fa2a68f5c5a29f45fe5ffd25c62516c635ecb13234de3bdf13e LightTouch-v0.0.12-source.tar.gz (3009035 bytes)
99c4baeaaeb41015a2ad1b593862fd375705559ea26642f7248e48542cd4c963 qemu-ios-v0.0.12-source.tar.gz (55404637 bytes)
LightTouch v0.0.11: the full Legacy Store on Android, and smoother iPod touch 4G games
LightTouch v0.0.11: the full Legacy Store on Android, and smoother iPod touch 4G games
LightTouch emulates classic iPods and iPhones running iPhone OS and iOS on Android, Linux, Windows and macOS. On Android, setting up your first device is now one guided flow on the phone, and you can browse the whole Legacy Store and install several apps at once. Landscape games on the iPod touch 4G stutter much less, and touch controls work better near the screen's edges. The iPod touch 2G on iOS 3.1.3 is still the easiest place to start.
This is the first regular (not pre-release) build: the Android app works from start to finish, from preparing a device to installing and playing apps. LightTouch is still early, though, and things can change or break between versions. The Linux, Windows and macOS versions are not yet easy to use, since most of the work has gone into the Android app first. Getting iOS onto them takes manual steps, so for now they suit people comfortable with some setup.
Downloads
| File | For |
|---|---|
LightTouch-v0.0.11-android-arm64.apk |
Android 10+ on 64-bit ARM. Installs over v0.0.10 and keeps your devices. |
LightTouch-v0.0.11-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.11-Windows-x86_64.zip |
64-bit Windows. Extract the whole zip, then run LightTouch.cmd. |
LightTouch-v0.0.11-macOS-arm64.zip |
Apple Silicon Macs, macOS 26+. Not notarized: allow it in System Settings › Privacy & Security. |
armv6.itpack, armv7.itpack |
Guest tools (the helpers LightTouch installs inside iOS) for Linux, Windows and macOS. armv6.itpack is for the iPod touch 1G and 2G and the original iPhone; armv7.itpack is for every other device. The Android app has both built in. |
LightTouch does not include iOS itself. On Android the app can download and set it up for you: tap Add a device, then Prepare from an IPSW. On Linux, Windows and macOS, docs/ASSETS.md explains how to get a prepared iOS system; a script does it for the iPod touch 2G.
What's new
Setting up your first device on Android
On first launch, Get started now goes straight to setting up a device on your phone: choose a device and iOS version, and LightTouch downloads iOS and prepares it. Before, the welcome screen asked for files most people don't have and pointed to a guide written for computers. Add a device works the same way later on. If you already have device files made elsewhere, such as on a computer, tap I already have the device files.
The Legacy Store on Android
- Browse the store like the website. Tabs under the search box show For this device (apps checked to run on your device, as before), Installed, Featured, Charts, Categories and Collections.
- Charts shows the old App Store charts (Top Free, Top Paid, Top Grossing and the New lists) for iPhone or iPad, by category and by year. They open near the year your device's iOS was current.
- An app's page shows its category, the year it came out and its screenshots, above the versions that run on your device. Apps the archive hasn't preserved are greyed out.
- Installed lists the apps on the device, with their store pages and any newer versions.
- Tap Install on several apps to queue them. They download and install one after another, and keep going if you leave LightTouch, with a notification showing progress. The download button in the top bar shows one progress ring for the whole install and opens the queue. IPA files you pick yourself join the same queue.
- You can cancel an install while it is still copying onto the device, not only while it downloads. A large app's copy can take minutes.
Smoother games on the iPod touch 4G
When a game is held sideways, iOS turns every frame upright before showing it, and the emulator did that turn too slowly. When the turn missed the screen's refresh, the frame stayed on screen for an extra refresh, which you see as stutter. The turn is now more than twice as fast on phones and Apple Silicon Macs.
Jetpack Joyride's title screen, iPod touch 4G, iOS 6.1.6:
| Frames held for an extra refresh | Average | |
|---|---|---|
| Poco F3 (Snapdragon 870) | about 1 in 6 before, now about 1 in 20 | now about 57 fps |
| Pixel 10 | 1 in 8 to 1 in 5 before, now about 1 in 17 | 50–53 fps before, now about 57 |
- Epic Citadel has fewer long pauses. Its music decoding and the screen update no longer hold up the emulated processor while they wait.
- Reading files on the iPod touch 4G is about 15% faster.
Other fixes
- Touch: a finger that slides off the edge of the iOS screen, or starts outside it in the black bars, now stays at the nearest edge instead of being lifted. Before, it lifted every finger on the screen, so steering with one thumb while the other slid off a button let go of both.
- iPod touch 2G: writing to its storage is about twice as fast. The emulator kept the emulated processor waiting on every page it wrote.
Android
- Details, in each device's ⋮ menu on the devices list, shows its model, iOS version, serial number, the hardware it stands for, and how much space it takes on your phone.
- The setting that unpauses a device when you return to LightTouch is now called Unpause when you return.
- The Headphones plugged in setting's info now says it also turns off the speaker's limiter, which some games count on to keep loud sounds from distorting.
Known limits
- The iPhone 3GS and iPhone 4 and the iPod touch 3G were not part of the speed work and still run noticeably slower than the iPod touch 2G and 4G, especially on phones.
- Doodle Jump on the iPod touch 3G (iOS 5.1.1) runs at double speed.
- Space that iOS frees on a device isn't given back to your phone yet, so a device's storage only grows.
- 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 not been tested.
- The desktop apps cannot prepare an IPSW themselves. On Linux,
firmwarekitbuilt from the source can; on macOS, Light Touch for Mac can; Windows needs a system prepared elsewhere. - Starting iOS was not tested on macOS for this release.
- 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.
- Alpha storage formats can change. Keep a copy of saved devices you care about.
Source and checksums
Built from LightTouch tag v0.0.11 (df4209a3) and tag lighttouch-v0.0.11 (e15a9a95e2) of the emulator engine, qemu-ios. Both source archives, SHA256SUMS and RELEASE-MANIFEST.json are attached. GPL-2.0-or-later; see LICENSE.txt.
f44279538dc9edaf879b0dbd29a015fa074682ae6e488860a06f4f9980111490 LightTouch-v0.0.11-android-arm64.apk (63177934 bytes)
6b7a49720c576c87c4faf2debef6596bfebccfde369b7fc4ca0d2b522f59203e LightTouch-v0.0.11-Linux-x86_64.AppImage (189581816 bytes)
da1eabac36c9ebb5424b16cdb9d06a36ab0e9255e5844aa5d6c9b4a5c357f1b1 LightTouch-v0.0.11-Windows-x86_64.zip (91162488 bytes)
fb3e6281ff5570fe94b208217ea201f94645d1405d818f2dcc4eaf745c376b44 LightTouch-v0.0.11-macOS-arm64.zip (53424446 bytes)
e843f1ae8abf9f173f8fd95e7eea3126cf17cbf87321574973668d6f1b9b4a2e armv6.itpack (997308 bytes)
ab39ea878f1a88b2000fbda373fc89ef20dea07409b45e773b37646d6da737d1 armv7.itpack (1704835 bytes)
f50d0df705eac31bc20f6f5494c951678d143b0b13c2a7ca89fd538ccc1bbadb LightTouch-v0.0.11-source.tar.gz (3058452 bytes)
2405283cb886ccfe39b61bad4e1de5a0c93ff32a4d4cdb70f54926972ec454ec qemu-ios-v0.0.11-source.tar.gz (55378102 bytes)
LightTouch v0.0.10: a much faster iPod touch 4G
LightTouch v0.0.10: a much faster iPod touch 4G
LightTouch emulates classic iPods and iPhones running iPhone OS and iOS on Android, Linux, Windows and macOS. This release is about the iPod touch 4G on iOS 6.1.6, which now runs most games at or near full speed on phones. The iPod touch 2G on iOS 3.1.3 is still the easiest place to start. This is an early alpha, published as a pre-release.
Downloads
| File | For |
|---|---|
LightTouch-v0.0.10-android-arm64.apk |
Android 10+ on 64-bit ARM. Installs over v0.0.9 and keeps your devices. |
LightTouch-v0.0.10-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.10-Windows-x86_64.zip |
64-bit Windows. Extract the whole zip, then run LightTouch.cmd. |
LightTouch-v0.0.10-macOS-arm64.zip |
Apple Silicon Macs, macOS 26+. Not notarized: allow it in System Settings › Privacy & Security. |
armv6.itpack, armv7.itpack |
Guest tools (the helpers LightTouch installs inside iOS) for Linux, Windows and macOS. armv6.itpack is for the iPod touch 1G and 2G and the original iPhone; armv7.itpack is for every other device. The Android app has both built in. |
LightTouch does not include iOS itself. On Android the app can download and set it up for you: tap Add a device, then Prepare from an IPSW. On Linux, Windows and macOS, docs/ASSETS.md explains how to get a prepared iOS system; a script does it for the iPod touch 2G.
What's new
The iPod touch 4G runs games at full speed
In v0.0.9 the iPod touch 4G on iOS 6.1.6 was marked Tested, slow, and games showed it. It is now plain Tested. Most of the emulator's time now goes to running the game instead of waiting on itself: the game's graphics are handled alongside the emulated processor instead of in its way, finished frames reach the screen without holding up the next one, and the emulated processor's code is laid out so the phone's processor caches hold more of it.
Frame rates on the iPod touch 4G, iOS 6.1.6 (60 fps is full speed):
| Game | Poco F3 (Snapdragon 870) | Pixel 10 |
|---|---|---|
| Jetpack Joyride (title screen) | 13–21 fps in v0.0.9, now about 55 | close to 60 |
| Doodle Jump (title screen) | 25–35 fps in v0.0.9, now 60 | not measured |
| Real Racing (a race) | about 60 | about 60 |
| Flight Control | about 58 | not measured |
| Epic Citadel | about 30 | about 50–55 in play |
Epic Citadel did not run at all before: it stopped after its logo.
Most of this work is in the parts of the emulator that every device shares, so other devices may run faster too, but only the iPod touch 4G was measured for this release.
Other fixes for the iPod touch 4G
- Steering with the gyroscope (Real Racing with Gyroscope on) no longer drifts back to centre every few seconds. iOS saw the device as upside down when it lay face up, so its motion tracking kept correcting itself. Tilt games that use only side-to-side tilt, like Doodle Jump, were not affected.
- If Android closed LightTouch, or it crashed, while an iPod touch 4G was running, the device could fail to start afterwards, which looked like games freezing on their first screen. Its storage now stays consistent when that happens.
- Videos inside games play more smoothly, and ones that showed only green (Epic Citadel's intro) now play.
- Large apps install: Asphalt 5 used to time out while installing on a Poco F3, and now installs in about 4 minutes.
Android
- New setting, Headphones plugged in, on by default: the iPod touch 4G plays sound as if headphones were connected, in stereo and without the speaker processing that also costs emulated processor time in games. Tap its info button for the tradeoff.
Desktop
- On Windows, closing the window or pressing Stop iOS now shuts iOS down directly, as on Android, Linux and macOS, instead of holding the power button and sliding to power off.
All platforms
- Installing an app shows a real progress bar while iOS unpacks it, where it used to sit with no progress for minutes.
- Copying an app onto the device is about twice as fast: Asphalt 5 (281 MB) took 137 seconds to copy onto an iPod touch 2G on the desktop, and now takes 73.
Known limits
- The iPhone 3GS and iPhone 4 and the iPod touch 3G were not part of this speed work and still run noticeably slower than the iPod touch 2G and 4G, especially on phones.
- Doodle Jump on the iPod touch 3G (iOS 5.1.1) runs at double speed.
- 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 not been tested.
- The desktop apps cannot prepare an IPSW themselves. On Linux,
firmwarekitbuilt from the source can; on macOS, Light Touch for Mac can; Windows needs a system prepared elsewhere. - Starting iOS was not tested on macOS for this release.
- 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.
- Alpha storage formats can change. Keep a copy of saved devices you care about.
Source and checksums
Built from LightTouch tag v0.0.10 (4bdb0e78) and tag lighttouch-v0.0.10 (7ddc3c7006) of the emulator engine, qemu-ios. Both source archives, SHA256SUMS and RELEASE-MANIFEST.json are attached. GPL-2.0-or-later; see LICENSE.txt.
7fc06afbcd36c62114890c98755cb9f4ab32c222a373b2cdf15d6c63cb66b2b6 LightTouch-v0.0.10-android-arm64.apk (62901254 bytes)
634c3e1a25910a578e3e9bc6daf2532baf35b136f113aaa5cb63590489cf43dc LightTouch-v0.0.10-Linux-x86_64.AppImage (189540856 bytes)
3d6f4e1b17c41395c2461987951f69b85b1739dd9d80f1ee7dccc00bdeb916de LightTouch-v0.0.10-Windows-x86_64.zip (91154861 bytes)
1a2a0b11def920b71f24bd470decff86baabe746f2ca2bdc44037cacfa5e1573 LightTouch-v0.0.10-macOS-arm64.zip (53421598 bytes)
e843f1ae8abf9f173f8fd95e7eea3126cf17cbf87321574973668d6f1b9b4a2e armv6.itpack (997308 bytes)
ab39ea878f1a88b2000fbda373fc89ef20dea07409b45e773b37646d6da737d1 armv7.itpack (1704835 bytes)
5c218b24b5e2de76c5461be495cc8e3d558e37a0989b3dcb275f36c5719047e6 LightTouch-v0.0.10-source.tar.gz (3026192 bytes)
e44fcb3cebe665be9fa36d5ac235e6a52f9e43c45cab31b2082c50bee4ba035f qemu-ios-v0.0.10-source.tar.gz (55382547 bytes)
LightTouch v0.0.9: more iPods and iPhones
LightTouch v0.0.9: more iPods and iPhones
LightTouch emulates classic iPods and iPhones running iPhone OS and iOS on Android, Linux, Windows and macOS. The iPod touch 2G on iOS 3.1.3 is still the main target and runs best. This is an early alpha, published as a pre-release.
Downloads
| File | For |
|---|---|
LightTouch-v0.0.9-android-arm64.apk |
Android 10+ on 64-bit ARM. Installs over v0.0.8 and keeps your devices. |
LightTouch-v0.0.9-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.9-Windows-x86_64.zip |
64-bit Windows. Extract the whole zip, then run LightTouch.cmd. |
LightTouch-v0.0.9-macOS-arm64.zip |
Apple Silicon Macs, macOS 26+. Not notarized: allow it in System Settings › Privacy & Security. |
armv6.itpack, armv7.itpack |
Guest tools (the helpers LightTouch installs inside iOS) for Linux, Windows and macOS. armv6.itpack is for the iPod touch 1G and 2G and the original iPhone; armv7.itpack is for every other device. The Android app has both built in. |
LightTouch does not include iOS itself. On Android the app can download and set it up for you: tap Add a device, then Prepare from an IPSW. On Linux, Windows and macOS, docs/ASSETS.md explains how to get a prepared iOS system; a script does it for the iPod touch 2G.
What's new
Prepare any device and iOS version on Android
v0.0.8 could prepare only the iPod touch 2G on iOS 3.1.3. Prepare from an IPSW now offers every device and iOS version in Light Touch for Mac's firmware catalog: the iPod touch 1G to 4G, the original iPhone, the iPhone 3GS and 4, and the iPad, from iPhone OS 1 to iOS 7. The app downloads Apple's firmware, checks it, and prepares it on the phone, using the same preparation tool as Light Touch for Mac.
Each version is labelled by how well it has been checked:
| Label | Devices and iOS versions |
|---|---|
| Tested | iPod touch 2G on 3.1.3 and 4.2.1, iPod touch 3G on 4.2.1 |
| Tested, slow | iPod touch 4G on 6.1.6, iPhone 3GS on 5.1.1, iPhone 4 on 4.2.1 and 4.3.5. These work but run slower than the iPod touch 2G. |
| Experimental | passes Light Touch for Mac's own checks, not yet tried on LightTouch |
| Untested | not tried anywhere yet |
The iPod touch 2G on iOS 3.1.3 takes under a minute to prepare on a Poco F3. Devices whose preparation starts iOS once to finish its first-time setup take 3 to 5 minutes. Preparation needs about 5 GB free.
- Downloads and preparation keep going when you switch to another app. If Android closes LightTouch in the meantime, reopening it shows the preparation again, or adds the finished device.
- When preparation finishes, Details shows how long each stage took.
- The prepare screen says which boot file a device needs, if any, and downloads it. The iPod touch 1G and the original iPhone have their own.
Other Android changes
- Starting a device rechecks only the system files that changed since it last started. On a Poco F3 that check took 98 seconds for an iPod touch 4G and now takes 2.5.
- When an app update carries newer guest tools, existing devices get them the next time they start.
- Guest audio plays alongside other apps' audio. Music in another app keeps playing, and other apps no longer pause the guest.
- Error messages float over the screen instead of shrinking the guest, and stay dismissed until something new goes wrong.
- The Legacy Store keeps its list of installed apps for each device, so two devices of the same model on different iOS versions no longer share one.
- Touching the screen while iOS is still starting no longer shows an error.
Desktop
- Linux, Windows and macOS can add a system prepared by Light Touch for Mac as a folder: choose Choose folder… under iOS system. This is how the iPod touch 4G is added.
- The desktop apps can now start every device the preparation tool supports. On Linux, the iPod touch 2G on 2.1.1, 3.1.3 and 4.2.1, the iPod touch 3G on 4.2.1, the iPod touch 4G on 6.1.6, the iPhone 3GS on 5.1.1 and the iPhone 4 on 4.2.1 and 4.3.5 start to the Home screen, and all but 2.1.1 install apps. Windows and macOS were not checked with these devices.
- On macOS, adding a system checks it on four threads with a real progress bar, more than twice as fast.
All platforms
- The emulator includes the latest work from qemu-ios, the project it is based on: sound at the rate iOS sets on the iPod touch 3G and 4G, the iPhone 3GS and 4 and the iPad; light sensors, Bluetooth and the iPhones' modem answering as iOS expects; and changes to how the ARM processor is emulated.
- A quick tap released before iOS reads the touch screen now arrives whole.
- Battle Bears: Zombies! no longer spins a thread in the background, and reaches its 30 fps cap on a desktop.
- In the Legacy Store, Fruit Ninja installs a working copy; the one it used to pick was cut short and could not open.
Known limits
- Devices other than the iPod touch 2G run noticeably slower, especially on phones. Speeding them up is the next focus.
- 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 not been tested.
- The desktop apps cannot prepare an IPSW themselves. On Linux,
firmwarekitbuilt from the source can; on macOS, Light Touch for Mac can; Windows needs a system prepared elsewhere. - Starting iOS was not tested on macOS for this release.
- 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.
- Alpha storage formats can change. Keep a copy of saved devices you care about.
Source and checksums
Built from LightTouch tag v0.0.9 (7c15b091) and tag lighttouch-v0.0.9 (061f59c365) of the emulator engine, qemu-ios. Both source archives, SHA256SUMS and RELEASE-MANIFEST.json are attached. GPL-2.0-or-later; see LICENSE.txt.
fbb750f5fb3d1c9357d53827d35f3e495e0555372efea580ddf459782d791105 LightTouch-v0.0.9-android-arm64.apk (62868202 bytes)
f939d9db78e708a6a709c4d504cf4f9103b3db4b2137f4b9aa127f89fad4968f LightTouch-v0.0.9-Linux-x86_64.AppImage (189315576 bytes)
a6ddd8eb0d714f45e3662e656ec35c015b5d23dde711996495448d94bfabec94 LightTouch-v0.0.9-Windows-x86_64.zip (90968565 bytes)
087f9e347d15d815409c5fefcdf6a515935b37d889515cb407d3b0fb5e4d9434 LightTouch-v0.0.9-macOS-arm64.zip (53379477 bytes)
e843f1ae8abf9f173f8fd95e7eea3126cf17cbf87321574973668d6f1b9b4a2e armv6.itpack (997308 bytes)
ab39ea878f1a88b2000fbda373fc89ef20dea07409b45e773b37646d6da737d1 armv7.itpack (1704835 bytes)
aaa141a93974cd3d00c44011c865e004bb6f7289241efdc01c2df9480ed817c1 LightTouch-v0.0.9-source.tar.gz (2991027 bytes)
bcd235f125645b32643c36e9f89149ab6da5aa14da0931bbec0e33404a0e7756 qemu-ios-v0.0.9-source.tar.gz (55319993 bytes)
LightTouch v0.0.8: faster 3D games
LightTouch v0.0.8: faster 3D games
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.8-android-arm64.apk |
Android 10+ on 64-bit ARM. Installs over v0.0.7 and keeps your devices. |
LightTouch-v0.0.8-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.8-Windows-x86_64.zip |
64-bit Windows. Extract the whole zip, then run LightTouch.cmd. |
LightTouch-v0.0.8-macOS-arm64.zip |
Apple Silicon Macs, macOS 26+. Not notarized: allow it in System Settings › Privacy & Security. |
armv6.itpack |
Guest tools for the iPod touch 2G (the helpers LightTouch installs inside iOS), for Linux, Windows and macOS. The same file as in v0.0.7. The Android app has them built in. |
LightTouch does not include iOS itself. On Android the app can download and set it up for you: tap Add a device, then Prepare from an IPSW. On Linux, Windows and macOS, docs/ASSETS.md explains how to get the iOS system and boot file; a script does it for you.
What's new
Faster 3D games
Many 3D games draw each frame as a hundred or more small pieces, each cut from one large block of 3D model data. LightTouch used to copy the whole block for every piece. Now it copies only the part each piece uses. All four platforms get this change. On phones:
| Game | Phone | v0.0.7 | v0.0.8 |
|---|---|---|---|
| Asphalt 5, during a race | Poco F3 (Snapdragon 870) | about 8 fps | 25 fps |
| N.O.V.A. | Pixel 10 (Tensor G5) | about 30 fps | 60 fps |
Asphalt 5 never runs faster than 25 fps and N.O.V.A. never faster than 60, so both now run at full speed on those phones. In Asphalt 5's races, the time the Poco F3 spends drawing each frame dropped from about 60 ms to about 5 ms. Real Racing also holds a steady 60 fps on the Pixel 10.
In a small test app that times only this kind of drawing, each draw is 7.6 times faster on the Pixel 10 and 4.7 times faster on the Poco F3. Games that draw differently are not affected by this change.
Other emulator updates
- The emulator now includes the latest fixes from the qemu-ios project it is based on, and QEMU 11.0.5. They correct details of how the iPod's ARM processor, encryption hardware and clock are emulated.
- On Windows, a quick tap is no longer lost when its press and release reach iOS together.
Known limits
- Some games still run below their full speed, mostly on phones. Work on them continues.
- On Android, Prepare from an IPSW supports only the iPod touch 2G with iOS 3.1.3 so far.
- Starting iOS was not tested on Windows or macOS for this release.
- Some 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.8 (795ed0f4) and tag lighttouch-v0.0.8 (f4eeeab129) of the emulator engine, qemu-ios. Both source archives, SHA256SUMS and RELEASE-MANIFEST.json are attached. GPL-2.0-or-later; see LICENSE.txt.
42c769d1f5b68c79a7adb7fc3ea6e4c5f9d17efc9e1ba0de51dd0dd82237aa95 LightTouch-v0.0.8-android-arm64.apk (39423077 bytes)
6308563ac78840224c8cb8fa32321ee459520aded3d48c45b2856e0569662762 LightTouch-v0.0.8-Linux-x86_64.AppImage (204139000 bytes)
16dec231a5ead52d82d18787493e495126cb35ab6833c727000229d6a9a7c4f3 LightTouch-v0.0.8-Windows-x86_64.zip (90907782 bytes)
7d4c8837d386eb3472ab5e16bbe4c7e4b9819899481ff5965c0a560686f60cdf LightTouch-v0.0.8-macOS-arm64.zip (52861255 bytes)
f27df777f73db2db6c66f7f786e676e250e351ba017fedbac850bac2955894f6 armv6.itpack (986540 bytes)
c5c35eccc183e2edb81b52a7c657189ef47c75f71713a231a1782b693cda8db7 LightTouch-v0.0.8-source.tar.gz (3043179 bytes)
1bc1ec176af63a389ac5eccac8340408d185da9d190a9a52f50048b5668e1e2a qemu-ios-v0.0.8-source.tar.gz (70177055 bytes)
LightTouch v0.0.7: new Android UI and streamlined setup
LightTouch v0.0.7: new Android UI and streamlined setup
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.7-android-arm64.apk |
Android 10+ on 64-bit ARM. Installs over v0.0.6 and keeps your devices. |
LightTouch-v0.0.7-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.7-Windows-x86_64.zip |
64-bit Windows. Extract the whole zip, then run LightTouch.cmd. |
LightTouch-v0.0.7-macOS-arm64.zip |
Apple Silicon Macs, macOS 26+. Not notarized: allow it in System Settings › Privacy & Security. |
armv6.itpack |
Guest tools for the iPod touch 2G (the helpers LightTouch installs inside iOS), for Linux, Windows and macOS. The same file as in v0.0.6. The Android app now has them built in. |
LightTouch does not include iOS itself. On Android the app can now download and set it up for you (see below). On Linux, Windows and macOS, docs/ASSETS.md explains how to get the iOS system and boot file; a script does it for you.
What's new
This release is about the Android app. The Linux, Windows and macOS builds are rebuilt from this release's source and work as they did in v0.0.6.
A redesigned Android app
The Android app has a new look, made for using it, not just for testing the emulator:
- Device screen: your iPod is drawn as a device, with Pause, Full screen, Screenshot, Inspect and Stop below it.
- Full screen: iOS fills the phone, centred, with the iPod's Home and power buttons beneath.
- Devices: switch between your devices, add new ones, rename or delete them.
- Settings in one place, a light or dark theme, and a restyled Store for finding and installing apps.
- Performance overlay (optional): frame rate, CPU and memory over the game. Inspect pauses iOS and shows the frames around a recent stutter.
- First launch walks you through adding a device.
- Your phone's volume buttons now leave iOS alone unless you turn that on in Settings.
- When a page such as Settings or the Store covers the iOS screen, the emulator stops drawing to it, which saves battery.
Set up iOS from inside the app
You no longer need to find and copy files to your phone first. Tap Add a device, then Prepare from an IPSW, choose iPod touch 2G and iOS 3.1.3, and the app:
- downloads Apple's iOS 3.1.3 firmware for the iPod touch 2G (an IPSW file, 263 MB) from the Internet Archive, or uses an IPSW you already have on the phone;
- downloads the iPod's boot file from securerom.fun, or reuses one from a device already on the phone;
- checks both files against known checksums, then turns them into a device and adds its guest tools.
On a Poco F3, a phone with a Snapdragon 865-class chip, the whole process took under a minute on a fast connection: about 24 seconds to download and check the IPSW, and 23 seconds to prepare the device. It needs about 1.5 GB of free space while it works and cleans up after itself.
The other devices and iOS versions are listed but marked Not supported yet. If you already have a prepared system (n72ap-7E18.itbase and bootrom.bin), choose Or add a prepared device image instead.
Faster imports, smaller devices
LightTouch now stores a device's flash memory as one file instead of more than 100,000 small ones:
| On the Poco F3 | v0.0.6 | v0.0.7 |
|---|---|---|
Adding a device from an .itbase file |
about 53 seconds | about 15 seconds |
| Storage a new device uses | about 890 MB | about 450 MB |
Devices you already have keep working as they are.
Known limits
- On Android, Prepare from an IPSW supports only the iPod touch 2G with iOS 3.1.3 so far.
- Starting iOS was not tested on Windows or macOS for this release. Their code is unchanged since v0.0.6.
- Some 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.7 (64a22104). The emulator engine is unchanged since v0.0.6: 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.
ab375857bb7e32581df76cc0da5ecbfa11cbc6019f9f5a5ae32690438f86f68d LightTouch-v0.0.7-android-arm64.apk (39420657 bytes)
9a9f027ab092329b63af451a88e56d3858b48cfd65a23f7fd842d3cb7eedc7a9 LightTouch-v0.0.7-Linux-x86_64.AppImage (204089848 bytes)
5db60a1d32582b47fc43a60bd7325f0b4c724a05039b6c58b8e9522affbe2085 LightTouch-v0.0.7-Windows-x86_64.zip (90893598 bytes)
79ca23e0627cd6f605c9bce4a907d6e1b99f55d4d8091797de4e470db5ae2ca0 LightTouch-v0.0.7-macOS-arm64.zip (52859458 bytes)
f27df777f73db2db6c66f7f786e676e250e351ba017fedbac850bac2955894f6 armv6.itpack (986540 bytes)
c9b802c717db11ed097050281cd484fd893b95cd621043cccd0c9f566ed4771e LightTouch-v0.0.7-source.tar.gz (3008743 bytes)
47b9b6698d6d567f5c1a7a8f26a38fcc9688e929299982c1cec34a9e65d6fb94 qemu-ios-v0.0.6-source.tar.gz (70132153 bytes)
LightTouch v0.0.6: smoother Android games, downloadable guest tools, startup fix
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 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)