Skip to content

naufaldi/mac-fan-ctrl

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

74 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FanGuard

A native macOS fan control utility built with Tauri v2 (Rust backend) and Svelte 5 (frontend). Monitor temperatures and manage fan speeds through Apple's System Management Controller (SMC).

Beta — This app is in active development. Please report issues on GitHub.

Features

  • Real-time temperature monitoring via SMC and IOKit sensors
  • Per-fan speed control: automatic, constant RPM, or sensor-based curves
  • TestFlight/App Store build path with sandboxed monitoring-only behavior
  • Menu bar tray with live CPU temperature display
  • Custom preset save/restore
  • Emergency thermal override safety system
  • Light and dark mode (follows macOS system appearance)

Requirements

  • macOS 13 Ventura or later (Intel or Apple Silicon)
  • Fan speed control requires running as root — the app will prompt on first use

Installation

Direct Download

Download the latest .dmg from Releases. Release builds are Developer ID signed and notarized by Apple, so macOS Gatekeeper accepts them on first launch.

Homebrew

Homebrew 5+ requires trusting third-party taps before install or upgrade:

brew tap naufaldi/tap
brew trust naufaldi/tap
brew install --cask fanguard

Upgrade:

brew upgrade --cask fanguard

Development

# Install dependencies
pnpm install

# Run full app (frontend + Rust backend)
pnpm tauri dev

# Run with fan control (requires root)
sudo pnpm tauri dev

# Frontend unit tests
pnpm test

# Rust unit tests
cd src-tauri && cargo test

# Lint
pnpm biome:check

# Direct Developer ID/Homebrew build flavor
pnpm tauri:build:direct

# TestFlight/App Store Connect build flavor
pnpm tauri:build:testflight

Prerequisites

  • Node.js 18+
  • pnpm 8+
  • Rust 1.77.2+
  • Xcode Command Line Tools

License

MIT

About

Native macOS fan control and temperature monitoring app. Read sensors, set custom fan speeds, and create thermal profiles via Apple SMC. Built with Tauri v2, Rust, and Svelte 5. Supports Intel and Apple Silicon Macs.

Topics

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors