macOS utility for analyzing battery properties.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore
README.md
battery

README.md

battery

battery is a macOS utility for analyzing battery properties.

Installation

Homebrew

brew tap nickolasburr/pfa
brew install battery

Manual

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

curl -fsL https://raw.githubusercontent.com/nickolasburr/battery/master/battery > /usr/local/bin/battery

Make executable:

chmod +x /usr/local/bin/battery

Options

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

Examples

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