Jitterbug is an iOS app that lets you to wirelessly connect to another iOS device (neither are jailbroken) and then launch an app on the connected iOS device with JIT enabled. This can be used with UTM or DolphiniOS or other supported apps for faster emulation speed.
On jailbroken devices, TrollStore compatible devices, or any device with a paid developer account, Jitterbug can create a VPN tunnel to run apps on the local device without needing a second device.
Jitterbug Lite is the same app without any of the VPN features which require special entitlements only available to paid Apple Developer accounts.
Note: Only Jitterbug Lite will work with AltStore!
Installation
Jitterbug Lite: AltStore is the preferred way to install Jitterbug Lite. You can also sideload the IPA through other means.
Jitterbug (with VPN): If you have a jailbroken device, you can install Jitterbug with AppSync Unified for the full set of features. If you have a TrollStore compatible device, you can install the IPA with TrollStore. If you have neither, you can build and install Jitterbug with a paid Apple Developer account. Check out these instructions for more details.
Pairing
Install Jitterbug on your primary device and the app you wish to launch on your secondary device.
On macOS and Windows, make sure you have iTunes installed. On Linux, make sure usbmuxd is installed (sudo apt install usbmuxd).
Run jitterbugpair with your secondary device plugged in to generate YOUR-UDID.mobiledevicepairing. You need to have a passcode enabled and the device should be unlocked. The first time you run the tool, you will get a prompt for your passcode. Type it in and keep the screen on and unlocked and run the tool again to generate the pairing.
Running
Use AirDrop, email, or another means to copy the .mobiledevicepairing file generated from jitterbugpair to your primary iOS device. When you open it, it should launch Jitterbug and import automatically.
Download the Developer Image for the iOS version running on your secondary iOS device (or the closest lower version if your version is not listed) and copy both DeveloperDiskImage.dmg and DeveloperDiskImage.dmg.signature to your primary iOS device. Open Jitterbug, go to "Support Files" and import both files.
Open Jitterbug, go to "Launcher", and look for your secondary iOS device to show up. If it is not showing up, make sure both devices are connected to the same network (tethering from primary to secondary OR secondary to primary is OK). Select the device and choose the pairing file. Then choose the app to launch and choose the DeveloperDiskImage.dmg file.
Troubleshooting
- Re-generate the pairing file. If you have not used the pairing file for a long time or if you updated or reset your device, the pairing file will expire.
- Make sure you are using the right
DeveloperDiskImage.dmgandDeveloperDiskImage.dmg.signaturecorresponding to the iOS version on the secondary iOS device. - Make sure both devices are connected to the same Wifi network. Try a different Wifi network (or use iPhone Wifi tethering) if connection problems persists. Cellular will not work even with VPN.
- Make sure the app you are trying to launch is "Developer Signed". This means you've loaded it with AltStore, iOS App Signer, Xcode, or other similar means. What's not developer signed: Ad-Hoc signed, Enterprise signed, App Store signed, most "cloud" signing services.
Changes
1.3.1
- Shows all apps (including apps marked as system) in order to support TrollStore installed apps
- Fixed a crash when querying apps with an empty Container string
1.3.0
- Import pairing/DMG inside the app (thanks @js-john)
- Fix UI issue launching from shortcut in iPad landscape mode (#21)
- Updated zh-Hans localization (thanks @js-john)
- Updated libimobiledevice and dependencies to latest commit
1.2.0
- Generate URL shortcut for devices and apps by 3D touching on the list item. You can then use the URL on the same device to quickly launch an app from anywhere.
- Jitterbug Lite is the same app without the VPN features and can be installed with AltStore or free developer accounts.
- Various stability fixes for VPN connection (thanks @luken11)
- zh-Hans translation (thanks @js-john)
- Fix crash deleting support files (#20)
- Fix launched apps crashing when launched with VPN (#10)
- Fix localhost device sometimes not being detected as localhost
- Improve error message when trying to start VPN mode with VPN profile disabled
- Fix refreshing app list in VPN mode
1.1.0
- Jailbreak OR resigned with a paid developer account only: Run apps on the local device using a VPN tunnel
1.0.2
- Add macOS version of Jitterbug (GUI) with built-in support for generating pairing files
1.0.1
- Added home screen shortcuts for saved hosts
- Fixed busy spinner not showing for importing files
- Workaround pairing popover not showing on iOS 14.6
