Support

Having trouble?

Run the doctor first — 12 checks, each with a fix.

Step one

Run the doctor

gcoolers doctor
  • macmonbundled sensor reader
  • heatwatch-fanfan helper binary
  • fan helper root-owned/Library/Application Support/Gcoolers/bin
  • sudoers pathpoints at the root-owned helper, not a stale one
  • passwordless fan sudo/etc/sudoers.d/gcoolers
  • LaunchAgent plist~/Library/LaunchAgents
  • LaunchAgent loadedcom.gcoolers.daemon
  • daemon binary reachable by launchdProgramArguments path resolves
  • daemon heartbeatstate.json age, zone, peak
  • SMC sensorscpu/gpu via macmon
  • Gcoolers.app~/Applications
  • notificationson/off · hot_minutes

Common failures

passwordless fan sudo

The sudoers rule is missing or was rejected.

gcoolers install
LaunchAgent loaded

The governor is not running, so nothing is controlling the fans.

launchctl load ~/Library/LaunchAgents/com.gcoolers.daemon.plist
daemon heartbeat

The agent is loaded but the daemon has not written state recently.

tail -n 50 ~/Library/Logs/gcoolers.log
Gcoolers.app

The menu bar app never compiled — usually missing Xcode Command Line Tools.

xcode-select --install && gcoolers menubar
SMC sensors

The sensor reader returned nothing, so there is no telemetry to act on.

gcoolers doctor

Email

support@gcoolers.com — include Mac model, macOS, Gcoolers version, profile, gcoolers doctor, and relevant log lines.

Bugs

Reproducible issues belong on GitHub.