Injecting tweaks

This guide shows how to inject .deb files or .dylib files into applications.

What is a tweak?

    A tweak is injectable code which comes in a .dylib or .deb (or in some cases, frameworks) that modifys an app's contents to do a particular task or alter how they behave.

    A .deb file may be confused for a .debian package. However, .deb files are commonly used specifcally in jailbroken iOS to install packages. .ipa files (more specifcally .app folders) also come in .deb's with tweaks injected in them.

    It's important to note that not all .deb's will work! Only .deb files with some sort of injectable framework will be able to be injected. Some .deb files contain .dylib files which are supposed to be injected into processes (like SpringBoard), not apps.

Finding these frameworks

    You can find .deb/.dylib files all over the internet. You can also find them on websites like ios-repo-updates.com. It contains a bunch of debian packages created for jailbroken iOS, and also include some packages that hook into apps.

    A jailbroken package like uYouPlus, which is a hacked Youtube, will inject into the Youtube application. You can extract the .deb to get a .dylib file, and then inject it using a method below without a jailbreak.

    The only difference of these listed methods compared to jailbroken iOS is that jailbroken devices can inject without the need to reinstall applications. Stock iOS (excluding TrollFools) require you to resideload a new .ipa with the .dylib iniected.

    Sideloadly

      Sideloadly is a sideloader that allows you to install apps using Apple ID's. Sideloadly has many other features, including being able to inject frameworks with Cydia Substrate (tweak injection library) and Subsitute (Elucubratus).

      • Before starting this guide, please ensure that Sideloadly is installed.

    1. Once Sideloadly is installed, plug your device into your computer
    2. Drag and drop the .ipa file you want to sideload.
    3. Click on Advanced Options.
    4. At the section that says "Tweak Injection", enable "Inject .dylibs/frameworks".
    5. To the right of that toggle button, there should be a button that says "+dylib/deb". Click on it, and select the .dylib or .deb you would like to inject.
    6. Ensure that "Cydia Substrate" is toggled on.
    7. Then, click "Start".

    TrollFools

      TrollFools is a tweak injector that allows you to inject .dylib's into applications.

      This tool MUST require TrollStore (iOS 14 - 16.6.1 & 17.0) or any sideloader that bypasses coretrust.
    1. Enure that you have TrollStore installed.
    2. With TrollStore installed, install the latest version of TrollFools
    3. Once installed, open the application on your homescreen.
    4. Locate the app you want to inject the .dylib in.
    5. Once found, click "Inject", then select the .dylib file.
    6. Once it is finished, restart the app you just injected the tweak in.