Getting started with CarterWare tweaks

Q: Where do I report a bug?

Open Settings → the tweak → Report a Bug. The form opens with your tweak version, iOS version and iPhone model already filled in. You can also use the bug report form. Every report reaches the developer.

CarterWare makes tweaks for jailbroken iPhones: small add-ons that change how iOS looks and works. This page takes you from a jailbroken phone to your first working tweak. Everything else in the docs builds on it.

Before you start

You need an iPhone jailbroken with Dopamine, which is "rootless" (it leaves the system partition alone). Every CarterWare tweak is built and tested for Dopamine on iOS 15 and later. Each guide lists the exact iOS versions that tweak supports.

Not jailbroken yet? Use the jailbreak finder. Pick your iPhone and iOS version, and it tells you whether your phone can be jailbroken and links to the right steps.

Note: palera1n in rootless mode uses the same package format, so most tweaks install there too, but we test on Dopamine. iPhone 16 and newer can't be jailbroken yet.

Set it up

Jailbreak. Open the Dopamine app and tap Jailbreak. The first time, Dopamine installs a package manager (Sileo or Zebra, whichever you picked) on your Home Screen. That's the app store for tweaks.
Add the CarterWare source. In Sileo, go to Sources, tap +, paste https://tweaks.carterware.net/ and tap Add Source. Keep the trailing slash. Install, update and remove tweaks has the Zebra steps too.
Pick a tweak. Open the CarterWare source. Free tweaks (Mountaineer, CarterBlock, Fold, Fuse and TikTok Warm) install straight away. Paid ones ask you to sign in with your email first. See Buying tweaks and Tweak Pass.
Install it. Tap Get (or the price), then Queue, then Confirm. When Sileo asks, tap Respring. A respring restarts the Home Screen to load the tweak, and takes a few seconds.
Find its settings. Open the Settings app and scroll down. Each CarterWare tweak has its own row with its icon, like Mosaic or CarterEQ. If you use Fold, tweaks live inside its Tweaks Drawer instead.

That's it. If the tweak's row shows up in Settings and its Enabled switch is on, it's working.

Which tweak should I start with?

Make your Home Screen yours: Mosaic changes the grid, lets you place icons anywhere and adds live HTML widgets.
Better sound everywhere: CarterEQ is a 10-band equalizer for all audio.
Fewer ads: CarterBlock is free and blocks ads and trackers in apps and Safari.
Know why something crashed: Mountaineer is free and keeps a readable crash diary. Install it early; it's the first thing to check when something misbehaves.
Games: Game HUD shows FPS and temperature and can lock 120 Hz per app.
Dynamic Island: Island adds a music visualizer and swipe-to-skip around the island.

After a restart

A normal restart turns the jailbreak off, and your iPhone starts up like stock iOS. Your tweaks and their settings are still there. Open Dopamine and tap Jailbreak again to bring them back. This is normal for every current jailbreak, not a CarterWare thing.

Troubleshooting

I don't see the tweak in Settings

Respring once more (in Sileo, or by turning the tweak off and on). Make sure you're still jailbroken: if you restarted, open Dopamine and tap Jailbreak. If you use Fold, look in its Tweaks Drawer. More fixes are in Troubleshooting and Safe Mode.

The Home Screen keeps crashing after I installed something

Restart your iPhone, which turns tweaks off. Then follow Recover from a tweak that crashes the Home Screen.

Questions

Do I need a computer to use CarterWare tweaks?

No. Once your iPhone is jailbroken with Dopamine, you add the source and install everything on the phone itself.

Are CarterWare tweaks free?

Some are. Mountaineer, CarterBlock, Fold, Fuse and TikTok Warm are free with no account. Mosaic, CarterEQ, Island, Game HUD, Rewind and CarterIDE are paid. You can buy them one at a time or get all of them with Tweak Pass for $10 a month.

Will tweaks slow down my iPhone or drain the battery?

Most tweaks only run when you use what they change. A few do continuous work, like Rewind's screen capture or Game HUD's overlay, and their guides say what they cost and how to limit it. If your battery suddenly gets worse, turn tweaks off one at a time to find the cause.

Where do I report a bug?

Open Settings → the tweak → Report a Bug. The form opens with your tweak version, iOS version and iPhone model already filled in. You can also use the bug report form. Every report reaches the developer.