Skip to content

Chris911/iStats

Repository files navigation

iStatsGem 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 /Chris911/iStats

Advanced usage

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

  1. Runistats scanto scan your computer for SMC sensors
  2. Enable extra sensors by runningistats enable keyoristats enable all
  3. Runistatsoristats extrato 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 Zabbixlow-level discovery. See the accompanying template and agent config in theintegrationsdirectory.

Releases

No releases published

Packages

No packages published