/iStats

Ruby gem for your mac stats

Primary LanguageRubyMIT LicenseMIT

iStats Gem Version

iStats is a command-line tool that allows you to easily grab the CPU temperature, fan speeds and battery information on OS X. If you'd like to see more data available feel free to open an issue.

Installation

$ gem install iStats
Note

If you are running an older version of OS X and the install fails you might want to try running this command instead:
sudo ARCHFLAGS=-Wno-error=unused-command-line-argument-hard-error-in-future gem install iStats

Screenshot

All Stats

Sparkline levels

Usage

  - iStats: help ---------------------------------------------------

  istats --help                        This help text
  istats --version                     Print current version

  # Commands
  istats all                           Print all stats
  istats cpu                           Print all CPU stats
  istats cpu [temp | temperature]      Print CPU temperature
  istats fan                           Print all fan stats
  istats fan [speed]                   Print fan speed
  istats battery                       Print all battery stats
  istats battery [health]              Print battery health
  istats battery [time | remain]       Print battery time remaining
  istats battery [cycle_count | cc]    Print battery cycle count info
  istats battery [temp | temperature]  Print battery temperature
  istats battery [charge]              Print battery charge
  istats battery [capacity]            Print battery capacity info

  istats scan                          Scans and print temperatures
  istats scan [key]                    Print single SMC temperature key
  istats scan [zabbix]                 JSON output for Zabbix discovery
  istats enable [key | all]            Enables key
  istats disable [key | all]           Disable key
  istats list                          List available keys

  # Arguments
  --no-graphs                          Don't display sparklines graphs
  --no-labels                          Don't display item names/labels
  --no-scale                           Display just the stat value
  --value-only                         No graph, label, or scale
  -f, --fahrenheit                     Display temperatures in fahrenheit

  for more help see: https://github.com/Chris911/iStats

Advanced usage

iStats now supports extra sensors for advanced users. Here's how to enable that functionality:

  1. Run istats scan to scan your computer for SMC sensors
  2. Enable extra sensors by running istats enable key or istats enable all
  3. Run istats or istats extra to see the extra sensors information.

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

Tested on

Click to expand


MacBook Pro 2016 macOS: 10.12.6 Ruby: 2.4.1
MacBook Pro 2011 OS X: 10.11.6 Ruby: 2.0.0
MacBook Pro 2012 OS X: 10.9.3 Ruby: 1.9.3, 2.0.0, 2.1.1
MacBook Pro 2014 OS X: 10.10.3, 10.10.4 Ruby: 2.1.3
Mac Pro 2013 OS X: 10.12.6 Ruby: 2.0.0

Zabbix Integration

iStats has a "scan zabbix" mode which will emit JSON suitable for use with Zabbix low-level discovery. See the accompanying template and agent config in the integrations directory.