README

Stats






macOS system monitor in your menu bar

 Installation
 Manual
You can download the latest version here.
This will download a file called Stats.dmg. Open it and move the app to the application folder.

 Homebrew
To install it using Homebrew, open the Terminal app and type:
bash
brew install stats


 Headless (SSH)
To install Stats remotely over SSH and set it up as a remote monitoring agent, run:
bash
curl -fsSL https://cdn.mac-stats.com/install.sh | bash

The script installs the app, enables the Remote module and prints a URL with an authorization code - open it on any device and sign in to your System Stats account to authorize the machine. After that Stats starts streaming metrics to your account and is registered to launch automatically at login and restart if it stops.
The Mac needs an active user session (a locked screen is fine) to run the app; on a fully headless machine Stats will start at the next login.

 Uninstall
Run the uninstall script bundled with the app (requires administrator privileges to remove the SMC helper):
bash
sh /Applications/Stats.app/Contents/Resources/Scripts/uninstall.sh


 Legacy version
Legacy version for older systems could be found here.

 Requirements
Stats is supported on macOS 12 (Monterey) and newer.
Beta versions of macOS are not supported - only stable releases.

 Features
Stats is an application that allows you to monitor your macOS system.

 - CPU utilization
 - GPU utilization
 - Memory usage
 - Disk utilization
 - Network usage
 - Battery level
 - Fan's control (not maintained)
 - Sensors information (Temperature/Voltage/Power)
 - Bluetooth devices
 - Multiple time zone clock

 FAQs

 How do you change the order of the menu bar icons?
macOS decides the order of the menu bar items not Stats - it may change after the first reboot after installing Stats.

To change the order of any menu bar icon - macOS Mojave (version 10.14) and up.

1. Hold down ⌘ (command key).
2. Drag the icon to the desired position on the menu bar.
3. Release ⌘ (command key)

 Stats icons do not appear in the menu bar
macOS 26 introduced a new privacy control under System Settings → Menu Bar. Apps must be explicitly allowed there to display menu bar items. If Stats is running with at least one module active and one widget enabled, but none of its icons show up in the menu bar, this is almost certainly the cause. More details you can find here.

Solution: open System Settings → Menu Bar and toggle Stats ON.

 Desktop widgets not showing the data
Due to a problem with high data load in the system process (chronod) responsible for communication between the app and widgets, communication is disabled by default on the Stats side. To enable it, the macOS widgets option must be enabled in the Stats settings. More details you can find here.

Solution: open Stats Settings and toggle macOS widgets ON.

 Wi-Fi network name shows Unknown
macOS requires Location Services permission to read the Wi-Fi network name. If access for Stats i

Top issues

Latest release

Bug fixes
- fix: fixed Stack widget width jitter and Speed widget clipping with fixed units (3708)
- fix: fixed RAM process list freezing on truncated UTF-8 process names (3730)
- fix: fixed missing Disk preview data

 New features
- feat: added new models to SystemKit (3731)
- feat: added memory pressure percentage to the RAM popup and text widget
- feat: initialized Battery history chart (3401)