Skip to content

Latest commit

 

History

History
73 lines (51 loc) · 2.5 KB

README.md

File metadata and controls

73 lines (51 loc) · 2.5 KB

./battery_charge

battery_charge is a simple cross-platform command line utility (python3) for checking battery status.

All the script does is to show the current battery percentage and whether it is charging.

Dependency

  • Python 3
  • Linux: upower UPower command line tool (comes with the system for Ubuntu)
  • OS X: ioreg (comes with the system)
  • Windows: wmi python module
    • install with pip install wmi using the pip from python 3

Install

  • ./setup.py install (run with sudo on Linux)

Platform Tested

  • Windows 10
  • OS X 10.10.5 (Yosemite)
  • Ubuntu 14.04 (Trusty Tahr)

Usage

You will need to put "X:/Python3X/Scripts" into your PATH on Windows.

$ battery_charge
99 ac_power

Use read command to get both the battery percentage and the status into variables.

$ bat_info=`battery_charge | tr -d '\r\n'`
$ read bat_percentage bat_status <<< $bat_info
$ echo $bat_percentage
95
$ echo $bat_status
discharging

About Battery Status

Status Value Linux Mac Windows
discharging battery is discharging same same
charging battery is charging same same
ac_power battery is fully charged same as Linux battery is not necessarily fully charged, but the system is running on AC adapter

Use with zsh (or any other shell)

You could create a battery segment on $PS1 using this script with Oh-my-zsh + agnoster theme.

Here are some demos. See demo/zsh_prompt for more detail.

Mac

  • Running on AC adapter

mac ac

  • Charging

mac_charging

Windows

  • Changing from Battery to AC adapter

win_battery_ac

  • Low Battery Warning (<20%)

win_low_battery

License

The MIT License (MIT)