iSMC

About

iSMC is an Apple System Management Controller (SMC) CLI tool that attempts to query SMC for a number of well known keys and determine their type and value, classifying them into temperature, power, current, voltage, fan and battery readouts. It will also attempt to give a human-readable description of each found SMC key.

Typically various desktop and server Apple hardware should work and most definitely all Intel-based Mac computers.

Installation

There are two ways of installing iSMC (tool works only on macOS computers):

Manual

Download your preferred flavor from the releases page and install manually.

Using go get

go get github.com/dkorunic/iSMC

Usage

Usage:

$ iSMC help
Apple SMC CLI tool that can decode and display temperature, fans, battery, power, voltage and current
information for various hardware in your Apple Mac hardware.

Usage:
  iSMC [flags]
  iSMC [command]

Available Commands:
  all         Display all known sensors, fans and battery status
  batt        Display battery status
  curr        Display current sensors
  fans        Display fans status
  help        Help about any command
  power       Display power sensors
  temp        Display temperature sensors
  volt        Display voltage sensors

Flags:
  -h, --help   help for iSMC

Use "iSMC [command] --help" for more information about a command.

Usage of all commands is self explanatory and all commands have short and long aliases (bat vs. batt vs. battery, cur vs. curr vs. current etc.). There are no flags and/or switches.

Related work

I have taken a look at many Apple SMC related projects and took inspiration from them:

SMCKit Apple SMC library & tool in Swift: github.com/beltex/SMCKit
SMC API in pure C: github.com/beltex/libsmc
iStats Ruby Gem for Mac stats: github.com/Chris911/iStats
smcFanControl tool to control fans in Objective-C (this includes smc-command to query raw SMC keys): github.com/hholtmann/smcFanControl
FakeSMC Hackintosh kext: github.com/RehabMan/OS-X-FakeSMC-kozlek
VirtualSMC Hackintosh kext: github.com/acidanthera/VirtualSMC
osx-cpu-temp to display CPU temperature in pure C: github.com/lavoiesl/osx-cpu-temp
Linux kernel applesmc.c: github.com/torvalds/linux/blob/master/drivers/hwmon/applesmc.c
low-level Go bindings for devnull SMC tool: github.com/panotza/gosmc

Todo

Planned features:

fetch and decode SMC key descriptions from SMC,
generate random SMC keys and fetch/decode if available/usable,
store those extra (random) SMC keys in permanent configuration file,
add support for missing types (si*, hex_, pwm, etc.),
various code cleanups (some parts are downright horrible).

Bugs, feature requests, etc.

Please open a PR or report an issue. Thanks!

L6TLin/iSMC