fanfan

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

★ 37 Open GitHub ↗

macOS menu bar app for fan speed control

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![fanfan](https://raw.githubusercontent.com/hoobnn/fanfan/main/docs/icon.png)

# fanfan

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

[![release](https://img.shields.io/github/v/release/hoobnn/fanfan?style=flat-square)](https://github.com/hoobnn/fanfan/releases/latest)
[![macOS](https://img.shields.io/badge/macOS-26.0%2B-black?style=flat-square)](https://www.apple.com/macos/)
[![Swift](https://img.shields.io/badge/Swift-6-orange?style=flat-square)](https://swift.org)
[![license](https://img.shields.io/badge/license-MIT-green?style=flat-square)](https://raw.githubusercontent.com/hoobnn/fanfan/main/LICENSE)

[中文文档](README.zh.md)

## Install

### Homebrew

```bash
brew tap hoobnn/tap
brew install --cask fanfan
```

### Manual

Download the latest DMG from [Releases](https://github.com/hoobnn/fanfan/releases/latest), or run the install script:

```bash
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

## Acknowledgements

Forked from [solofan](https://github.com/SoloTeamDev/solofan). Thanks to the solofan team.

fanfan

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README