whatisgithub

What is fanny-macos-fancontrol?

shahzaibali02/fanny-macos-fancontrol — explained in plain English

Analysis updated 2026-05-18

56SwiftAudience · developerComplexity · 2/5LicenseSetup · moderate

In one sentence

Fanny is a macOS app for monitoring and controlling Mac fan speeds with custom rules, manual sliders, and live temperature readings.

Mindmap

mindmap
  root((Fanny))
    What it does
      Live fan monitoring
      Custom fan rules
      Manual speed control
    Tech stack
      Swift
      SwiftUI
      SMC
    Use cases
      Cool a hot laptop
      Automate fan speed
      Watch temperatures
    Audience
      Mac power users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Manually override macOS fan speeds with sliders or preset buttons.

USE CASE 2

Set rules that automatically ramp fans up when CPU temperature crosses a threshold.

USE CASE 3

Watch live CPU, GPU, and battery temperatures alongside fan speed.

USE CASE 4

Return fan control to macOS automatically when the app closes or resets.

What is it built with?

SwiftSwiftUI

How does it compare?

shahzaibali02/fanny-macos-fancontrolkellyvv/openreshotthanhng8/supertonic-tool
Stars565161
LanguageSwiftSwiftSwift
Setup difficultymoderatemoderatemoderate
Complexity2/53/53/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires macOS 13 Ventura or newer and administrator permission to run the privileged helper.

MIT license: free to use, modify, and distribute, including commercially, as long as you keep the copyright notice.

So what is it?

This is a macOS application for monitoring and controlling the fan speeds on a Mac. By default, macOS manages fans automatically, but this app lets users set their own rules or manually adjust speeds, which can be useful on laptops that run hot during intensive tasks. The app works in two parts. A standard graphical interface built with SwiftUI handles the display and controls, while a separate privileged helper program communicates directly with the System Management Controller, which is the chip inside every Mac that controls hardware like fans, sensors, and battery management. Because writing to that chip requires administrator permission, the app asks for your password the first time you authorize it, then stores that permission for future use. The main features include live fan speed readings with an animated fan graphic, a rules engine where you can define conditions such as ramping fans to 80% whenever the CPU temperature exceeds a threshold, and manual sliders for precise control. Preset buttons let you jump to common speed levels quickly. When the app is closed or reset, fan control is automatically returned to macOS. The rules engine evaluates multiple active rules at the same time and always applies the highest speed among all triggered rules, which the README describes as prioritizing safety. Temperature readings for the CPU, GPU, and battery are shown alongside the fan controls. The app supports both Intel and Apple Silicon Macs and requires macOS 13 Ventura or newer. It is built from source using a shell script that compiles both the graphical app and the privileged helper and packages them into a standard Mac application bundle. The project is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me write a Fanny rule that ramps fans to 80% when CPU temperature exceeds 80 degrees.
Prompt 2
Explain how Fanny's privileged helper communicates with the System Management Controller.
Prompt 3
Walk me through building Fanny from source with its packaging shell script.
Prompt 4
How does Fanny resolve conflicts when multiple fan rules are triggered at once?

Frequently asked questions

What is fanny-macos-fancontrol?

Fanny is a macOS app for monitoring and controlling Mac fan speeds with custom rules, manual sliders, and live temperature readings.

What language is fanny-macos-fancontrol written in?

Mainly Swift. The stack also includes Swift, SwiftUI.

What license does fanny-macos-fancontrol use?

MIT license: free to use, modify, and distribute, including commercially, as long as you keep the copyright notice.

How hard is fanny-macos-fancontrol to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is fanny-macos-fancontrol for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.