Skip to content

hoobnn/fanfan

Repository files navigation

fanfan

fanfan

A macOS menu bar app that puts you back in charge of your fans.

release macOS Swift license

中文文档

Install

Homebrew

brew tap hoobnn/tap
brew install --cask fanfan

Manual

Download the latest DMG from Releases, or run the install script:

curl -fsSL https://raw.githubusercontent.com/hoobnn/fanfan/main/scripts/install.sh | bash

Requires macOS 26+ (Apple Silicon or Intel). One password prompt on first launch — that's it.

How it works

Writing fan speeds requires root. Instead of running the whole app as root, fanfan installs a tiny C LaunchDaemon that owns the SMC handle and accepts exactly three commands over a Unix socket: PING, SET, AUTO.

fanfan.app  ──unix socket──▶  fanfan-smcd (root)  ──IOKit──▶  SMC

The app itself runs unprivileged. Temperature reads go straight through IOKit.

Star History

Star History Chart

Acknowledgements

Forked from solofan. Thanks to the solofan team.

MIT © 2026 hoobnn

About

macOS menu bar app for fan speed control

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors