Skip to content

Building IPA

Jump to bottom
SoCuul edited this page Jun 23, 2025 · 9 revisions

This page has been adapted from: https://github.com/qnblackcat/uYouPlus/wiki/Building

Requirements

  • A GitHub account
  • A decrypted Instagram IPA (you must get this yourself)

Steps

  1. Fork this repository
  2. Upload your decrypted IPA file to a cloud storage service, and get a direct download link to the file. Make sure the file is set to viewable by anyone with the link. Some examples are provided for Google Drive and OneDrive.
  3. In your forked repository:
    • Go to the Actions tab
    • Select the Build and Package SCInsta workflow on the left sidebar
    • Click Run workflow in the blue highlighted box
    • Enter the direct download link for your decrypted IPA and click the green Run workflow button
    • After waiting several minutes for the building to finish, click on the workflow run once the icon shows a green check
    • Finally, download the SCInsta artifact from the page and unzip the file to get the build SCInsta IPA
GitHub Actions page

Troubleshooting

Case 1

If the building fails, and you receive this error:

Creating the IPA file...
[*] extracting ipa..
[!] not a zip/ipa file
[*] deleting temporary directory..
Error: Process completed with exit code 1.

it means that your download link is incorrect.

To know if you have a direct link, paste it into your browser and click enter. If the .ipa file starts downloading immediately, you have a direct link.
Otherwise, please try one of the other file direct link methods listed above.

Case 2

If the building fails, and you receive this error:

Cache not found for keys: iPhoneOS14.5.sdk, iPhoneOS14.5.sdk

it means the ipa file you provided is invalid.

Make sure the ipa file is not inside a zip file, and has .ipa at the end of the file name

Additionally, to check if you have a decrypted ipa file, unzip it and check if it contains a file named iTunesMetadata.plist
If this file exists, you have an encrypted ipa file which will not work with SCInsta, and you will need to find a decrypted ipa to continue.

If your ipa file keeps resulting in this error, try another decrypted ipa from a different source.

Install

After building SCInsta, you can install the tweaked IPA file like any other sideloaded iOS app. If you have not done this before, here are some suggestions to get started.

  • Sideloadly (Free, No notifications*) *Notifications require $99/year Apple Developer Program
  • AltStore (Requires $99/year Apple Developer Program to install without errors, Receives notifications)
  • Signulous ($19.99/year, Receives notifications)
  • UDID Registrations ($9.99/year, Receives notifications)

Doesn't work?

Feel free to share your problem in the discussions forum to get help from the community

Clone this wiki locally