Common Issues
Frequently encountered issues and their solutions for Impactor.
My device does not appear in Impactor?
Windows
Reinstall iTunes & reboot your computer. Then open iTunes while your device is connected and make sure you tap on “Trust” from the popup on your iDevice. Trying a different USB cable or port may also help.
How do I trust the app? How do I fix “Untrusted Developer”?
Go to Settings > General > Profiles/VPN & Device Management and once there, tap on the email you used to sideload, then trust it.
File contains a virus or potentially unwanted software?
You might be sideloading a jailbreak, like Chimera or TrollInstallerX, just make sure your anti-virus allows these apps or disable it entirely (not recommended).
Failed to get package bundle: Zip error: i/o error?
Unfortunately some apps may contain characters in filenames that Windows does not support compared to UNIX filesystems, theres no way around this apart from manually fixing the filenames within the .ipa itself.
Changed phone number, unable to log in?
Most sideloaders (including Impactor) hardcode some values which cause a few Apple ID’s to fail to send SMS 2FA to devices, for now you can use a burner Apple ID which wouldn’t have these changes.
Security keys are unsupported?
Logging in with an Apple ID with a security key attached is unsupported, it destroys anisette data. Either use a burner Apple ID or remove them entirely.
__LINKEDIT segment contains data after signature.
Some binary may be signed by something that used the coretrust bug, use a different .ipa.
What kind of .dylibs or .debs can I add to my IPA? App crashes on launch after injecting dylib/deb/framework.
All dylib/deb/framework files are supported by Impactor, however, some of these files are specifically made for the jailbreak environment and will cause crashes when sideloaded on non-jailbroken devices. Impactor will automatically attempt to update the injected files to support non-jailbroken devices, but it’s not always guaranteed.
Not opening on my decade old hardware?
There’s a rare chance you may be running extremely old hardware, causing Impactor to not launch properly.
This is unfortunately a bug with iced, and you would need to force enable software rendering.
Set ICED_BACKEND=tiny-skia environment variable.
Drag & Drop not working on Linux
This is unfortunately a bug with iced, a patch update will be released once it supports drag & drop for Wayland.