Skip to content

About

Menu bar app to see your Mac's temperatures and control its fans (Apple Silicon)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

11 Commits

Folders and files

Repository files navigation

Better FanControl

See your Mac's temperatures and control its fans from the menu bar. For Apple Silicon Macs on macOS 14 or later.

Website: https://lucabrockman.github.io/mac-fancontrol/

Use it

  1. Download Better-FanControl.dmg from the releases, open it, and drag the app to Applications.
  2. Open the app. The app is not notarized, so macOS blocks it the first time. Go to System Settings → Privacy & Security, scroll down, and click Open Anyway. You only do this once.
  3. A fan icon with your CPU temperature appears in the menu bar. Click it.

The panel shows:

  • the hottest and average temperature for CPU, GPU, memory, SSD, battery and airflow, plus every raw sensor under All sensors
  • the speed of each fan

To control the fans, click Enable Fan Control and enter your password. The app installs a small helper, because only an admin can change fan speed. Then pick a mode:

  • Auto: macOS controls the fans.
  • Manual: one slider sets a fixed speed for all fans.
  • Curve: the fans ramp from minimum to maximum between two CPU temperatures you pick. Below the start temperature, macOS takes over.

When the app quits or crashes, the fans go back to Auto.

The app checks GitHub for new versions at startup and every 6 hours. When one is out, the panel shows Install Update. After an update the panel asks you to update the helper too.

To remove everything, click Remove Helper in the panel, quit, and drag the app to the Trash.

How it's built

Part What it is
Sources/BetterFanControl The menu bar app. SwiftUI. Reads sensors itself; sends fan changes to the helper. Installs the helper with the macOS admin prompt and updates itself from GitHub releases.
Sources/fancontrold The helper. Runs as root through launchd and listens on /var/run/fancontrold.sock. It accepts only the user who installed it. Fan settings last as long as the app's connection, then every fan returns to Auto.
Sources/SMC Reads and writes the System Management Controller through IOKit. Fan and sensor model, helper protocol.
Sources/fanctl Debug tool: swift run fanctl status prints temperatures and fans, swift run fanctl keys [prefix] dumps raw SMC keys.
scripts/build-app.sh Builds Better FanControl.app with the helper inside, ad-hoc signs it, and makes the DMG and zip.
scripts/smoke-test-app.sh Checks the built app before release: version, arm64 binaries, icon, signature, that the helper refuses to run without root, and that the zip and DMG are valid.
Tests/ Unit tests: SMC value decoding, the kernel struct size, sensor groups, the helper protocol, version comparison for the updater, and the Curve math.
.github/workflows/build.yml Runs the unit tests, builds the app and smoke-tests it on macos-latest. Every push to main that changes the app publishes a GitHub release, but only when all of that passes.
site/ The website: Vite, React, Tailwind and shadcn. .github/workflows/pages.yml deploys it to GitHub Pages on every push to main. Its download button links to releases/latest/download/Better-FanControl.dmg, which the release step attaches next to the versioned DMG.

Develop

scripts/build-app.sh 0.0.1      # builds build/Better FanControl.app
swift run fanctl status         # check the sensors without the app
swift test                      # unit tests

Release

Every push to main that changes the app builds and publishes a release tagged v<VERSION_PREFIX>.<run number> (for example v0.2.4). The release has Better-FanControl-<version>.dmg, a copy named Better-FanControl.dmg for the website, and Better-FanControl-<version>.zip for the in-app updater. To start a new minor or major version, change VERSION_PREFIX in the workflow. Pull requests only build.

License

MIT. See LICENSE.

About

Menu bar app to see your Mac's temperatures and control its fans (Apple Silicon)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages