← Contact

A high-level look at downloading an encrypted App Store app, decrypting it, and running it on a virtual iPhone.

From an encrypted App Store app to a running app on vphone

Overview

Getting an App Store app running on a virtual iPhone involves three main stages: download the encrypted app, remove its FairPlay encryption, and install the decrypted app on vphone.

At a high level, the flow looks like this:

Encrypted App Store IPA → decrypted IPA → installation on vphone → running app

An IPA is the package format used for iOS apps. It is essentially a ZIP file containing the app, its resources, and its App Store license information. Downloading that package is only the first step—the executable code inside is still encrypted.

1. Download the encrypted app

ipatool can search the App Store and download app packages. After authenticating with an Apple Account, give ipatool the app’s bundle ID and it downloads the App Store IPA associated with that account.

The result is an encrypted, personalized copy of the app. It contains the app and its resources, but its executable code is protected by Apple’s FairPlay encryption.

2. Set up FairPlay decryption once

UnfairPlay uses a Mac’s FairPlay enrollment to decrypt IPAs. It needs a one-time setup before it can decrypt apps.

We installed and opened Among Us through the normal Mac App Store, then downloaded its matching IPA with ipatool using the same Apple Account. This gave UnfairPlay a matching app, IPA, and Mac enrollment to work with.

From that enrollment, UnfairPlay created a reusable private model. We only needed to perform this setup once; the saved model can decrypt other IPAs associated with the same enrollment.

3. Decrypt and verify the IPA

With the one-time setup complete, UnfairPlay can take an encrypted IPA from ipatool, use the saved model, and produce a decrypted IPA.

Before installing the result, verify that decryption completed successfully. The app’s Mach-O executable images should no longer be marked as encrypted. Checking each executable image helps catch a failed or incomplete decryption before the app reaches the virtual device.

Keep the original encrypted download separate from the decrypted output so the process can be repeated if needed.

4. Install the decrypted app on vphone

vphone-cli runs a virtual iPhone on an Apple Silicon Mac. For this workflow, we created a fresh, jailbroken iOS research VM. The jailbroken environment provides root access over SSH and allows apps to be installed and examined in an environment we control.

Install the decrypted IPA into the VM and launch it. We tested this process with apps including Wikipedia and Dollarwise and confirmed that they opened successfully inside the virtual iPhone.

Once the FairPlay model exists, the general process is straightforward: use ipatool to obtain the encrypted IPA, use UnfairPlay to decrypt it, and install the decrypted IPA on vphone. Each tool handles a separate part of the transition from an App Store download to an app running on a virtual iPhone.