Battery

The bash version of this project is abandoned in favour of the C version which is faster and much nicer.

Simple utility to monitor the battery in a stylish manner.

Small version:

Version with some extra options:

Installation

git clone https://github.com/sasheto-phizika/battery.git
cp battery/battery ~/.local/bin # user installation
sudo cp battery/battery /usr/bin # system installation

Usage

Basic:

battery

Options

• -l: monitor the battery live (close with q or Esc)
• -s: print a small inline battery instead
• -f: print a slightly thicker battery
• -d: print the current capacity as a number inside of the battery (does not work with -s)
• -p=(mode): specify mode to be printed with -d (c for capacity, m for time left or to full, t for temperature)
• -e: disable extra core color pattern for different modes
• -m: print minimal text output
• -c: use an alternate charging symbol (requires nerd fonts)
• -n: remove colors
• -b=(bat_number): specify the battery number (default is the lowest one)

Configuration

You can create ~/.config/battery/battery.conf in order to change the colors and the default flags (the flags then become toggles that do the opposite).

Default configuration:

# colors can be [red | green | yellow | blue | magenta | cyan | white | black | none] 
# or a hex code with capital letters "#0000FF" 

color_100p="green" #core color between 60-100%
color_60p="yellow" #core color between 20-60%
color_20p="red" #core color between 0-20%

color_temp="magenta" #core color in 't' mode
color_time_full="cyan" #core color in 'm' mode when chargning
color_time_left="blue" #core color in 'm' mode when discharging

color_shell="white" #color of the outer shell
color_charge="cyan" #color of the charging symbol
mode='c'

colors=true 
live=false 
minimal=false
small=false
digits=false
fat=false
alt_charge=false

The config file is just sourced as a bash script, so technically it can be used to run any code at the start and there has to be no whitespace between the equals signs. Be careful not to run random commands.