Installation
Installing TweakInject
Four steps. The Injection page in the app shows the same list, so you can always see what is left.
Requirements
| macOS | 27 or newer. |
| Hardware | Apple silicon. Releases are built for arm64 and arm64e; there is no Intel version. |
| Access | An 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:
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.
- SIP. Checks whether step 2 took effect. If the check passes, this station can be clicked to disable Library Validation.
- Helper. Installs the one part that needs administrator access. macOS asks you to approve it.
- Payload. Installs the files tweaks load from.
- Launchd hook. Installs the piece that notices apps starting. Nothing loads until this is in place.
- TweakLoader. Confirms the loader is running.
- Tweaks. Shows how many tweaks are enabled.
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.