Graft

Graft

Put tweaks into the iOS apps you own and install them on your iPhone or iPad, from your Mac, over USB or Wi-Fi. A free Apple ID is enough.

Version 1.1, signed and notarized by Apple. For Apple silicon Macs on macOS 15 or later. Free and open source under the MIT license.

Graft for Mac showing five example apps in the sidebar and one app's tweaks, delivery state and Build & Install button.

How a build goes

Pick where the app comes from and how it reaches your device.

The app comes from
It reaches your device by
  1. Get the IPA

    Bring a decrypted IPA you already have. Graft checks that its bundle id matches the app, and that every binary in it is decrypted.

  2. Attach tweaks

    Search canister.me or add a free APT repo. A package fetched from canister.me is checked against its published SHA-256. Your own .deb and .dylib files work too.

  3. Build

    cyan injects the tweaks. The IPA stays unsigned and keeps its original bundle id, because LiveContainer signs it when you import it. This works with a free Apple ID.

  4. Deliver

    Graft pushes it into LiveContainer's Documents over USB or Wi-Fi. Import it in LiveContainer and the tweaks load.

Terminal
$ graft --add-app https://apps.apple.com/app/id123456789 --delivery livecontainer$ graft --provide-ipa ~/Downloads/Example.ipa --app example$ graft --fetch com.example.sometweak  # from canister.me$ graft --attach-tweak some-tweak.deb --app example$ graft example  # build and deliver

In the Mac app it's the same build: add the app, drop the IPA on it, attach tweaks, and press Build & Install.

Beyond the build

Finds LiveContainer
Uses LiveContainer however it got onto your device: SideStore, AltStore, iloader or Impactor. With a paid account, Graft can also install, update and sign it for you, so guest apps keep their logins. Up to three can sit side by side.
Keeps tweaks current
Checks canister.me and your APT repos for newer versions, and updates every app that uses a tweak in one step.
Rolls back
Archives builds for each app version, so you can put one you shipped before back on the device without rebuilding.
Knows what's stale
Tells you when a device is behind your config, and why: a rebuilt tweak, or a new version of the app.
Runs builds on your Mac
Makes a build that also loads under PlayCover on an Apple silicon Mac.
Scripts cleanly
Add --json to any command for newline-delimited JSON events. That's how the Mac app talks to it.

Install

The Mac app

Download it, open the zip, and move Graft.app to Applications. The app runs the CLI for everything it does, so install that too.

Download for Mac

The CLI

Install it with pipx, then let it set itself up.

$ pipx install git+https://github.com/GreenglassT/Graft$ graft --init$ graft --check

--init asks whether you have a paid developer account, copies in your certificate and profile if you do, and finds your device. --check lists any tool that's missing.

You'll need

  • A free Apple ID, with LiveContainer on your device. Install it with SideStore, AltStore, iloader or Impactor, which also refresh it every 7 days, then import the certificate in LiveContainer's settings so it can sign the apps you add.
  • Or a paid Apple Developer account, with a development certificate and a provisioning profile that includes your device. It adds sideloading apps directly, and lets Graft install and sign LiveContainer for you.
  • An Apple silicon Mac. The app needs macOS 15 or later, and the CLI needs Python 3.11 or later.
  • An iPhone or iPad paired with that Mac, over USB or Wi-Fi
  • cyan, which injects the tweaks, and the Xcode Command Line Tools (xcode-select --install), which Graft uses to check that an IPA is decrypted. Sideloading with a paid account also needs zsign and libimobiledevice. The README has a one-line install for each, and graft --check prints the ones you're missing.

Questions

Does Graft work with a free Apple ID?
Yes. Graft builds the tweaked IPA unsigned and pushes it into LiveContainer, which signs it when you import it. You install LiveContainer with SideStore, AltStore, iloader or Impactor, which also refresh it every 7 days. A paid developer account adds installing apps directly, and lets Graft install LiveContainer for you.
Do I need a jailbreak?
No. Graft installs onto a regular iPhone or iPad. A jailbroken device is only one of the three ways to get a decrypted IPA.
Does Graft come with tweaks or apps?
No. A fresh install starts empty. You bring the app, and the tweaks come from canister.me, an APT repo, or your own .deb and .dylib files.
Does Graft ask for my Apple ID?
No, never for your Apple ID or password. LiveContainer signs with its own certificate, or Graft uses your developer certificate with a paid account. To download from the App Store, you sign in to ipatool yourself in Terminal, and Graft only checks that it's signed in.

Your apps, your devices

Graft is for apps you've obtained with your own Apple ID, on your own devices. Don't redistribute decrypted or modified IPAs. It ships with no tweaks and no app files, so a fresh install starts empty. When it downloads from the App Store, your Apple ID and licence are stripped from the copy it keeps.

If Graft saved you a weekend of signing errors, you can buy me a coffee.

Tip on Ko-fi