Installation

Installing TweakInject

Four steps. The Injection page in the app shows the same list, so you can always see what is left.

Requirements

macOS27 or newer.
HardwareApple silicon. Releases are built for arm64 and arm64e; there is no Intel version.
AccessAn administrator account, and the ability to start up in recoveryOS.

1 · Download the application

Download the current release from the releases page and move TweakInject.app into /Applications. Open it once before continuing. It shows which steps are left.

2 · Turn off System Integrity Protection

Required, and it greatly reduces your Mac's security. Shut down, then hold the power button until Loading startup options appears. Choose Options → Continue, then Utilities → Terminal, and run:

recoveryOS Terminal
csrutil disable

Restart into macOS when the command completes.

3 · Complete the setup from the Injection page

Open TweakInject and select Injection. The numbered circles across the page are the setup stations, and each one is a button. Selecting an unfinished station does that stage. Work through them left to right.

  1. SIP. Checks whether step 2 took effect. If the check passes, this station can be clicked to disable Library Validation.
  2. Helper. Installs the one part that needs administrator access. macOS asks you to approve it.
  3. Payload. Installs the files tweaks load from.
  4. Launchd hook. Installs the piece that notices apps starting. Nothing loads until this is in place.
  5. TweakLoader. Confirms the loader is running.
  6. Tweaks. Shows how many tweaks are enabled.
The six stations, left to right. The status strip in the lower-left corner of the window is shown on every page.

4 · Restart userspace

The hook from step 3 only reaches apps started after it, so everything running now needs restarting. Use Userspace Reboot in the utilities below the stations. It restarts everything without rebooting the machine.

Sign back in and open TweakInject. When the status strip reads Injection · Active, setup is complete. Continue to Usage.