exelban/stats

macOS system monitor in your menu bar

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:

brew install stats

Requirements

Stats is supported on the released macOS version starting from macOS 10.15 (Catalina).

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
• 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)

What if you don't see sensors (M1 macs)?

Sensors data on the first generation of M1 mac could be obtained only from HID services. It's disabled by default because it consumes a lot of CPU and energy. You can enable it in the Sensors module settings with the option HID sensors.

It's only valid for M1 Apple Silicon macs. If you don't see sensors on another mac, please open an issue for that.

How to show the CPU frequency?

The CPU frequency is available only on Intel-based macs. You need to have installed Intel Power Gadget (IPG) for that. It allows receiving the CPU frequency from the IPG driver. There is no way to obtain a CPU frequency on Apple silicon macs.

How to reduce energy impact or CPU usage of Stats?

Stats tries to be efficient as it's possible. But reading some data periodically is not a cheap task. Each module has its own "price". So, if you want to reduce energy impact from the Stats you need to disable some Stats modules. The most inefficient modules are Sensors and Bluetooth. Disabling these modules could reduce CPU usage and power efficiency by up to 50% in some cases.

Why my issue was closed without any response?

Most probably because it's a duplicated issue and there is an answer to the question, report, or proposition. Please use a search by closed issues to get an answer. So, if your issue was closed without any response, most probably it already has a response.

Supported languages

• English
• Polski
• Українська
• Русский
• 中文 (简体) (thanks to chenguokai, Tai-Zhou, and Jerry)
• Türkçe (thanks to yusufozgul)
• 한국어 (thanks to escapeanaemia and iamhslee)
• German (thanks to natterstefan and aneitel)
• 中文 (繁體) (thanks to iamch15542 and jrthsr700tmax)
• Spanish (thanks to jcconca)
• Vietnamese (thanks to xuandung38)
• French (thanks to RomainLt)
• Italian (thanks to gmcinalli)
• Portuguese (Brazil) (thanks to marcelochaves95 and pedroserigatto)
• Norwegian Bokmål (thanks to rubjo)
• 日本語 (thanks to treastrain)
• Portuguese (Portugal) (thanks to AdamModus)
• Czech (thanks to mpl75)
• Magyar (thanks to moriczr)
• Bulgarian (thanks to zbrox)
• Romanian (thanks to razluta)
• Dutch (thanks to ngohungphuc)
• Hrvatski (thanks to milotype)
• Danish (thanks to casperes1996 and aleksanderbl29)
• Catalan (thanks to davidalonso)
• Indonesian (thanks to yooody)
• Hebrew (thanks to BadSugar)
• Slovenian (thanks to zigapovhe)
• Greek (thanks to sudoxcess and vaionicle)
• Persian (thanks to ShawnAlisson)
• Slovenský (thanks to martinbernat)
• Thai (thanks to apiphoomchu)
• Estonian (thanks to postylem)
• Hindi (thanks to patiljignesh)

You can help by adding a new language or improving the existing translation.

License

MIT License

stats's Issues

[Feature Request] Selection of network interface

Using the tool for a month now and i'm really happy about it. Just one little thing is bothering me: When connected to a docking station the network diagram only shows the WLAN interface. I would really appreciate if the tool would allow the manual selection of the interface of which the stats are shown. Another enhancement would be to be able to configure an autoselection of the used interface (automatically switching from wlan to lan if plugged in).

Any way i can help?

Feature request: adjust CPU load check frequency

Stats is showing an average energy impact of 1.16 in the last 12 hours I ran, ranking as 7th among all my apps. This is a little higher than I’d like. I’d love to set the CPU load poll interval to something like 5 - 10 seconds and hopefully reduce the load.

Show RAM memory pressure

macOS activity monitor shows a memory pressure graph with red/yellow/green colors. Would be great for stats to visualize the yellow and red as well in the menu bar. For my Mac, entering the "yellow zone" is a significant performance impact and I would like to know that.

Feature request: the disk monitor should show a usage chart similar to the one for RAM and CPU

Crash after app launch

The app closes automatically after some seconds and reports that dispatch queue com.repeat.queue crashed.

I'm running macOS Version 10.15.4 (19E287) on a MacBook Pro (16-inch, 2019).

Crash Report

The scope of the CPU/RAM charts is narrowed every time the mode is switched

Upgrade 2.1.6 to 2.1.7 fails

App-supported Stats upgrade 2.1.6 to 2.1.7 fails. Clicking "Check for new version" shows the new version dialog, plus the respective notification. However the install fails.

The DMG file is downloaded, but the Finder window does not show, nor is there an upgrade started.

Opening the DMG file in finder and moving Stats to Applications works.

Catalina 15.4 illegal hardware instruction

Hi!

Trying to get this to work, and Im seeing the following error in the terminal when running this on Catalina 15.4:

[1] 13626 illegal hardware instruction /Applications/Stats.app/Contents/MacOS/Stats

Menu bar item is blank when starting Stats with menubar hidden

Thanks for reading this issue report. Recently I use Stats everyday and I found if I launch Stats with "automatically hide and show menu bar" turned on, the item of menu bar of Stats will be totally blank. I'm not familiar with macOS developing and can't figure out why just by walking through the source code. Could you help me to check this issue?

macOS Version: 10.15.4
Step to Reproduce:

1. Quit Stats Completely.
2. Turn on "Automatically hide and show the menu bar" in Preference.
3. Open Stats again.

Current network speed not updating in popup

Related to #53 (Holy thanks for implementing this feature so fast!)
Works like a charm, even the autodetection! But i found a litte Bug: Where the small icons show the current speed the big ones in the popup view stay at 0.

App crashing right after start

When I install the app it open for a second or two and crashes right after. Can't get it to stay open.

Update screenshots in readme

Feature enhancement: Show list of `Apps Using Significant Energy` in the battery (expanded) widget

That's the only missing piece from the macOS native battery icon, and a very useful thing.

Also, when the battery's health is in the "Check Battery" state, I think there should be more prominent cues (macOS does it)

App Release / Update frequency

Love this app. Any chance we can have a dropdown in settings on how frequently to check for updates? I am getting bombarded by so many releases. This is a GOOD thing that the app is active, but would love it if there's an option to check maybe once a week.

App not visible in the Menu Bar

After accidentally disabling all modules I can no longer access the app to enable them. I have tried reinstalling the app but to no luck. App is running the background (visible in the Activity Monitor) but I don't see a way to enable any module.

P.S. I am new to MacOS so maybe I just don't know how to do it, any help would be appreciated.

Feature request: Network Traffic graphs like CPU and RAM

Please allow showing the network traffic as a graph that shows the historic rates like it's the case for CPU and RAM. Thanks!

Battery status won't show at manubar on v2.0.1

Happy to see Stats comes to v2. While when updated to v2.0.1, the battery status won't show at menubar whether the switch turned on or off. Could you please check that issue?

macOS Version: macOS 10.15.6 Beta (19G36e)
Hardware: MacBook Pro 13'' (2015)

The battery monitor is displayed at startup, even if turned off

Unchecking 'colorize' does not prevent the bars from changing color under load

When I uncheck the 'colorized' checkbox for either CPU, RAM or SSD, the bars still change color depending on their load. Even restarting doesn't fix it.

Not really relevant for the bug btw, but thanks for 2.0.0! It looks and functions quite nicely : )

Feature request: 1 NSStatusItem per widget

This would reduce by half the # of clicks needed to get to the detail pane. It would also allow the user to customise the order of the status items via cmd-dragging.

Not in brew anymore?

Error: Cask 'stats' is unavailable: No Cask with this name exists. Did you mean one of these?

Icon

The existing icon was just found somewhere in the internet.
I will be very helpful if someone will help with the new logo.

Memory / Battery tabs on details popover show no useful data when plugin is disabled

I don't have the memory plugin enabled, but the details popover still has a memory tab that shows a bunch of initial values. Probably better to either hide the tab, or have a separate plugin setting that enables / disables the corresponding tab.

Controll fans (SMC?)

It would be a great feature to control fan speed.
Very nice app btw! ;-)

Average Energy Impact at 5%

Over the last few days I’ve been observing Stats ranking 2nd the energy impact list.

#21 would probably help with this, but maybe it’s also worth looking at other ways to improve CPU usage. E.g. can data for the Overview and Top Processes sections only be acquired when the popover is shown?

Feature request: upon double clicking one of the indicators in the menu bar, launch Activity Monitor.app and navigate to the respective tab

You could probably use AppleScript for this.

Use Sparkle updater framework

The current update method is probably very lightweight, but it's a bit janky by having to restart the app myself and having to unmount and delete the .dmg. Not to mention, there is always a chance for hidden bugs.

With Sparkle it will take care of everything for you. It will automatically tell when there is an update, the user can choose if he wants auto-update or not, and the app will update itself and then restart without any leftover .dmg files!

Unchecking monitors doesn't work

Unchecking various monitors (cpu, ram, disk, etc) doesn't work.

OS: Mojave 10.14.6

Feature request: single bar for CPU

Instead of showing the CPU utilization per core, would it be possible to provide just a single bar (that just shows what the CPU % stat does, only now with a bar)?

Be able to copy network values

It would be nice if you could copy the values in the network tab, like the public IP and the physical address, with one click.

The SSD bar gets very wide when changing the config for it

If you look at this:

You can see that the SSD bar is very wide. Restarting the application fixes it

Some of the fonts are too thin on 10.14+

On macOS 10.14+, because of the lack of subpixel antialiasing, some of the fonts are too thin and have jagged edges.

Feature Request: Touchbar Stats

Hey there,

I would like to ask if it would be a big deal to add support to show Stats on the Touchbar of an Macbook?
It would be sometimes awesome to have them shown in fullscreen applications.

P.s. I love your commitment with this application! :-)

Best regards
Pantehr368

thermals in menu ?

In previous version i was capable of seeing temperature of specific cpu and gpu. with latest version , i am see no option in configuration

wrong temperature readings

Hi, I am getting wrong temperature reading with my quad core iMac Late 2017.

209°C seems a bit hot ;-)

Can Stats report CPU PECI?

and it only reports 2 cores and show the other two when I activate "show hyper threading cores"

Grammar on update-complete notification

Should be "updated to v.[version-number]"

The chart label display is bugged

The "Chart with value" mode is broken

Please see the screenshot.

App Store support (name conflict)

I would like to deploy the application to the App Store. But there is the app called Stats already.
So there are two options:

• select a new name for the app and rename the app
• I can deploy the app with mStats name to App Store, but use the Stats on github

The first option will be better. But I cannot choose a good name for the app. So I need some help with it.
The second option a little bit confusing. App will have two different names (mStats in App Store, and Stats on github).

Sensors not showing correctly

Battery triggers system notification below 10% even when charging

Hi,

As it seems (haven't done much testing on that), whenever the battery level is below 10%, every time the level changes by 1%, a system notification is triggered. Skipping the part that this might be configurable, I had the computer battery down to 4% then I plugged it back in: it triggered the notification when charged to 5%, then 6%, 7%, etc.. until 10%.

These notifications are very useful when discharging, but I believe it doesn't make sense to trigger these notifications when charging.

Can't view dropdown while in another app's fullscreen mode

I'm not terribly sure if this is fixable or not, but if I'm in fullscreen mode for another app (e.g. Slack), I see nothing when I click on a stats icon. It appears to open the dropdown on the desktop that doesn't host a fullscreen app.

Battery icon doesn't appear in darkmode

Light mode:

Dark mode :

Battery meter appears on re-launch even if disabled

To reproduce:

• uncheck the battery meter to disable it.
• relaunch stats.

Observation:
The battery meter reappears, and must be checked / unchecked to be hidden.

Feature request: add a setting to change the scope of the CPU/RAM usage charts

As of now, the CPU and RAM charts only display usage data for the last 7 seconds. It would be helpful to have a setting that would allow to change the scope of the charts to e. g. the last 15, 30 or 60 seconds.

Feature request: display the names of the indicators in the Chart/Chart with value modes

The names could be displayed vertically in order to save space (see the attachment).

colour coding for "based on utilization" settings

Hi,
when selecting a colour coding for "based on utilization" the colour seems to ba orange per default (if levels are low/ normal)
My assumption would be the colour to be green-ish if the utilization is low or normal or CPU, RAM, SSD and should then become orange or red-ish if higher or critical levels are reached. (I think it was similar to this in one of the more early versions of stats).
Currently the change seems to be from orange to red when high/critical levels are reached, which I don't really find logical. Green to red/orange for me would seem more intuitive.
cheers
bluegrover

Feature Request: Different battery icons when plugged/unplugged to power

Hi,

Thanks for putting this awesome app together. It is really helpful on my daily work.

It would be great to have some way of visually telling, just by looking at the menu bar whether AC power is on or not.

Well, I can obviously see the computer itself, but I had an issue a while ago on the previous laptop, when some of the USB ports were not working at all, so even though I had the cable plugged in, the battery was not charging. And on a different occasion, it was - apparently - a software problem: even though the cable was plugged, MacOS "thought" it wasn't, so eventually it put the computer to sleep "believing" the battery was drained. After a reboot, everything was normal.

Hence, it would be nice-to-have some indication of the AC Power status (without having to click on it).

Thanks once again!

Cheers,
Alex

Make the bars different colors

Right now they are all blue, which is slightly confusing if labels are disabled. I like it however, because its a very clean and compact look.

If all the bars had slightly separate colors, they would be easier to distinguish.

Another option would be a centered small letter for each type inside the bar. For CPU you would use a C, for RAM a R, for SSD a S, etc.

CPU usage

  #26  should show you your CPU, not eat it. Could you try lowing the CPU **and battery** usage?