Using TweakInject

Installed Tweaks and Process Manager

These are the two lists you will spend the most time in. Click any entry and it expands in place; click it again to close it.

In Installed Tweaks, an expanded tweak shows buttons for Preferences, Details, Edit Filter and Reveal in Finder. You can also right-click a tweak to get Open Preferences, Reveal in Finder, Copy Identifier and Delete Tweak. The ... button at the end of the entry opens the same menu.

In Process Manager, an expanded process lists the tweaks that load into it, each with its own switch. A separate switch turns injection off for that process entirely.

Repositories and the install sheet in the store expand the same way, to show a source's tweaks or what a package contains.

Installing a tweak

Tweaks come in three forms. All three install the same way.

Format	What it is
.deb	A transport format that installs a .bundle or a .dylib along with extra information about it. The most common way a tweak is distributed.
.bundle	A tweak that is self contained as a folder, which may also hold its assets and target information.
.dylib	A tweak as a plain library. Needs extra configuration naming the applications it targets.

Open Installed Tweaks and drag the file onto the panel at the top of the page, or click the panel to pick one. Import Tweak above it does the same. Anything you install from the store appears here too.

Before anything is installed, TweakInject reads the tweak's targeting and shows it to you. You can add or remove applications, exclude ones you would rather it left alone, or load a different .plist entirely. Nothing is installed until you confirm.

Disabling a tweak leaves it installed but stops it loading. Apps that are already open carry on as they were, so quit and reopen the one you care about, or use Restart UI for the Dock and Finder.

Uninstalling a tweak

Right-click the tweak in Installed Tweaks and choose Delete Tweak. The ... button at the end of its entry has the same option. Apps that already have the tweak loaded keep it until they are restarted.

Configuring a tweak

Tweaks that have settings can be configured from within TweakInject. Click the tweak in Installed Tweaks and press Preferences.

The same settings appear in System Settings under Tweaks once PreferenceLoaderX is installed. It comes from the store, and tweaks that need it pull it in on their own.

Changes apply straight away, even in apps that are already open, unless the tweak says otherwise.

Keeping tweaks out of an app

You can exclude apps per tweak, or per process.

To limit one tweak, open it in Installed Tweaks and press Edit Filter. Add or remove the apps it targets, or exclude the ones it should skip.

To limit a single app, open Process Manager, expand the process, and switch off either the tweaks you don't want in it or injection for the whole process. Some system processes are protected and can't be switched off, and binaries that enforce library validation only accept tweaks once you turn that off on the Injection page.

The store

TI Store lists tweaks that can be installed in one step, with any dependencies resolved automatically. Each entry shows a description, artwork and the architectures it was built for.

The Signed indicator at the top of the page means the catalogue is intact. If that check ever fails, installs are blocked.

No account is needed to browse or install. Signing in is only for publishing.

Buying a tweak

Some tweaks in the store are paid, and their entries show a price.

Choosing to buy one opens the checkout in your browser, and the app shows a sheet that waits for the payment. When the payment goes through, the license is activated on your Mac automatically and the tweak installs. You don't need to enter anything. If you close the sheet before paying, finishing the checkout still unlocks the tweak.

The order confirmation email includes a license key. Keep it. You only need it to activate the tweak on another Mac, up to five in total, or to restore a purchase: open Settings, then Purchases & Licences, and choose Restore. Restore re-checks licenses already stored in your Keychain, or takes a key if you have one to enter.

Each activation comes with an offline receipt that lasts 60 days. TweakInject renews it on its own whenever the app is running. To keep receipts current without opening the app, install the background refresher (TI_ReceiptRefresher) from the same Settings section. It renews licenses weekly. A Renew button next to each license forces a renewal if you want one now.

To move a license to a different Mac, use Deactivate on the old one. That frees a slot and removes the tweak from that machine; the license itself stays valid.

Third-party repositories

Repositories lists the sources the store draws from. Select Add and enter a repository's address to include it; its tweaks then appear in the store alongside the rest.

Turning injection off

Injection can be suspended from the Injection page. Tweaks stay installed but stop loading, which is what you want when you need to run an app without them. The status strip in the lower-left corner of the window always shows the current state.

Safe Mode

Safe Mode stops every tweak loading without uninstalling any of them.

It turns itself on when it is needed. If a tweak crashes the Dock, Finder, Spotlight, the window server or the wallpaper, your next login starts with every tweak switched off.

You can also engage it deliberately with Engage Safe Mode in the utilities on the Injection page. While it is active, the Injection page shows a Safe Mode indicator and a menu bar item offers Exit Safe Mode.

To return to normal, disable the tweak you suspect in Installed Tweaks, then select Exit Safe Mode. Leaving Safe Mode restarts userspace so that everything comes back with tweaks loaded.

Restarting userspace

Some changes only reach apps started afterwards, and the Dock, Finder and window server cannot simply be quit. Userspace Reboot, in the utilities on the Injection page, restarts everything without rebooting the machine. It ends your session the same way signing out does, so save your work first.

Restart UI is the lighter option, restarting the Dock, Finder and related components only.

Diagnostics

Process Manager lists everything running, what has loaded into each, and lets you exempt any of them. Use it when one app misbehaves with a tweak that works fine elsewhere.

Logs records what loaded where and what failed. Check it first when a tweak is installed and enabled but seems to do nothing.

Publishing your own tweaks

Sign in with GitHub and Developer Center appears in the sidebar, listing the tweaks you have published and the submissions you have sent. Submissions carry their files with them, so there is nothing to host yourself, and you can withdraw one before it is reviewed.

The account only identifies you. TweakInject asks for no repository access. Documentation covers submitting and updating a tweak in full.

Settings

Appearance, including the colour theme, along with diagnostics and maintenance actions such as clearing cached store artwork.

Send Feedback is at the bottom of the page. No account needed, though signing in first means you can get a reply.