CoolHead guide: stop your iPhone dimming the screen when it's hot

Set up CoolHead so heat from gaming, charging or the sun stops dimming your iPhone's screen, pick how far it may dim, and keep the safety limits sensible.

Version 1.0.0iOS 15 – 17Tested on iOS 16.3.1$0.99 one-time, or included with Tweak Pass

When your iPhone warms up, from gaming, charging, navigation or a sunny day, iOS quietly lowers the most brightness your screen can reach. The slider stays where you put it, but the screen gets dimmer until you can barely see it outside. CoolHead stops that. Your iPhone still slows the processor to cool down, and CoolHead lets iOS dim again only when the phone gets critically hot.

Before you start

  • A jailbreak on iOS 15 to 17: rootless (Dopamine, palera1n), RootHide, or rootful (palera1n rootful, XinaA15), with a tweak injector (ElleKit or Substrate) and PreferenceLoader. Not jailbroken yet? Use the jailbreak finder.
  • Sileo or Zebra with the CarterWare source added. See Install CarterWare tweaks.
  • CoolHead costs $0.99 one-time, or it's included with Tweak Pass. See Buying and restoring.
  • Don't use it together with tweaks that turn off iOS's thermal service completely, such as DisableThermalmonitord. Those remove every heat protection; CoolHead only touches screen brightness.

Set it up

  1. Add the CarterWare source https://tweaks.carterware.net/ in Sileo or Zebra and install CoolHead. It starts working right away; no respring (restart of the Home Screen) is needed.
  2. Open Settings → CoolHead. Enabled is on and Keep Brightness is Full.
  3. Look at the Status section. It shows your battery temperature and how hot iOS thinks the iPhone is, for example "Battery 31.5 °C · iPhone Normal", and "Watching. iOS isn't limiting brightness right now."
  4. Use your iPhone the way that used to dim the screen. When iOS tries to dim for heat, Status says "iOS wants to limit brightness to 40% because of heat. CoolHead is keeping it at Full", and counts how often it kept your screen bright.

Common tasks

Stop the screen dimming while gaming

Leave Keep Brightness on Full. Games heat the iPhone more than anything else, and this is when iOS dims the most. The game may still slow down a little when the phone is hot, because iOS keeps limiting the processor; CoolHead only keeps the screen bright.

Keep the screen readable in the sun

Sunlight heats the iPhone and needs the brightest screen at the same time. With Keep Brightness on Full, the screen stays at your brightness or Auto-Brightness level instead of fading. If the phone gets critically hot sitting in direct sun, CoolHead steps aside until it cools, so move it into the shade when you can.

Let the screen dim a little to cool down faster

Set Keep Brightness to 80% or 70%. iOS may then dim the screen down to that point when the iPhone is warm, which sheds some heat, but never further.

Check how hot your iPhone is

Open Settings → CoolHead and read Status. The battery temperature updates every few seconds while you watch, in °C or °F to match your iPhone's settings. The second part (Normal, Warm, Hot, Very Hot, Critically Hot or Overheating) is how hot iOS itself thinks the iPhone is.

Settings explained

Every setting on the Settings → CoolHead screen:

Stops iOS dimming your screen when your iPhone gets warm, like while gaming, charging or in the sun. Your iPhone still slows the processor to cool down, and CoolHead steps aside when it gets truly hot.

Enabled
Switch · on by default

Master switch. Turn it off and iOS dims the screen for heat as usual again, right away; your settings are kept.

Brightness

How far iOS may lower your brightness when the iPhone is warm. Full means heat never dims the screen. Your brightness slider and Auto-Brightness still work as usual.

Keep Brightness
Choice: Full, 90%, 80%, 70%, 60%, 50% · default Full

How far iOS may lower your brightness when the iPhone is warm. Full means heat never dims the screen until the safety limits kick in. 80% or 70% lets iOS dim a little to shed some heat, but never below that point.

Safety

When the iPhone gets this hot, CoolHead lets iOS dim the screen again until it cools down. A dimmer screen is one of the ways an iPhone sheds heat, so leave these as they are unless your screen still dims too early.

Let iOS Dim When
Choice: Critically Hot, Very Hot · default Critically Hot

How hot iOS must think the iPhone is before CoolHead steps aside and lets it dim the screen. Critically Hot is where iOS starts cutting back hard to cool down. Very Hot steps aside earlier, but that is also where iOS starts dimming, so CoolHead keeps the screen bright less often.

Or Battery Reaches
Choice: 40 °C (104 °F), 43 °C (109 °F), 45 °C (113 °F), 48 °C (118 °F) · default 45 °C (113 °F)

CoolHead also steps aside when the battery reaches this temperature, and takes over again once it is 2 °C cooler. 45 °C (113 °F) is a sensible limit; batteries wear out faster when they stay hot.

Status

Refresh Status
Button

Updates the Status section: battery temperature, how hot iOS thinks the iPhone is, whether iOS is trying to dim the screen right now, and how often CoolHead kept it bright.

Support

Opens a short form in Safari with your tweak version, iOS and iPhone model already filled in. Every report reaches the developer.

Report a Bug
Button

Opens a short bug form in Safari with your CoolHead version, iOS version and iPhone model already filled in.

Troubleshooting

The screen still dims when my iPhone is hot

Open Settings → CoolHead and read Status. If it says the iPhone is too hot and CoolHead is letting iOS dim, the safety limits kicked in. That is on purpose: let the phone cool down, or raise Or Battery Reaches one step if it happens at temperatures you're comfortable with. If Keep Brightness is lower than Full, iOS may dim down to that point. Auto-Brightness can also lower the screen in a dark room; that has nothing to do with heat.

Status says CoolHead isn't running

CoolHead runs inside iOS's thermal service, which only loads tweaks when it starts. Reinstall CoolHead in Sileo or Zebra, which restarts that service. If the message stays, restart your iPhone and jailbreak again.

Status says CoolHead is off because the Tweak Pass ended

CoolHead came with your Tweak Pass, and the Pass ended. Renew the Pass or buy CoolHead in Sileo or Zebra, then open Settings → CoolHead again. See Buying and restoring.

Questions

Why does my iPhone screen get dim when it's hot?

A bright screen makes a lot of heat, so iOS lowers the most brightness the screen can reach when the iPhone warms up, even if your brightness slider is all the way up. It happens most while gaming, charging, using navigation or sitting in the sun.

Is it safe to stop my iPhone dimming the screen?

CoolHead only stops the screen dimming. iOS keeps slowing the processor and charging to cool down, and CoolHead lets iOS dim the screen again when the iPhone gets critically hot or the battery reaches the temperature you choose (45 °C by default), until it cools by 2 °C. If the iPhone ever gets hot enough to show its temperature warning, iOS handles that as usual.

Does CoolHead make my iPhone faster when it's hot?

No. CoolHead doesn't change how much iOS slows the processor or the graphics when the phone is warm. It keeps the screen bright, nothing else.

Does CoolHead use more battery?

A brighter screen uses more battery than a dimmed one, so on a hot day you'll use a little more than you did with the screen dimmed. CoolHead itself only reads the temperature every 10 seconds, which costs next to nothing.