Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
109 lines (72 sloc) 1.98 KB


battery is a macOS utility for analyzing battery properties.



brew tap nickolasburr/pfa
brew install battery


Add battery to your PATH (e.g. /usr/local/bin):

curl -fsL > /usr/local/bin/battery

Make executable:

chmod +x /usr/local/bin/battery


  • -A, --amperage: Show battery amperage (in milliamps).
  • -C, --is-charging: Show whether battery potential is under capacity and in a power-gain (charging) state.
  • -F, --is-fully-charged: Show whether battery is at capacity and not in a power-gain (charging) state.
  • -K, --cycle-count: Show number of completed charge/discharge cycles.
  • -M, --minutes-until-charged: Show minutes remaining until battery is fully charged.
  • -O, --minutes-until-discharged: Show minutes remaining until battery is fully discharged.
  • -P, --is-power-connected: Show whether battery is connected to an external power source (e.g. AC power outlet).
  • -S, --serial-number: Show battery serial number.
  • -T, --temperature: Show battery temperature in Fahrenheit, Celsius, and Kelvin.
  • -V, --voltage: Show battery voltage (in millivolts).
  • -W, --manufacturer: Show battery manufacturer.


Show battery amperage

battery -A

# => 673mA

Show the number of completed charge/discharge cycles

battery -K

# => 249

Show minutes until battery is fully discharged

battery -O

# => 35

Show if the battery is connected to a power source

battery -P

# => false

Show battery serial number

battery -S

# => E93VG22TC81H0B1F3

Show battery temperature (in Fahrenheit, Celsius, and Kelvin)

battery -T

# => 30.66 °C
#    87.18 °F
#    303.81 °K

Show battery voltage

battery -V

# => 12375mV

Show battery manufacturer

battery -W

# => SMP