README.md

power

A (very) configurable and (hilariously) over-engineered power (AC and battery) status blocklet for i3blocks.

Appearance	Description
	AC connected
	AC disconnected, battery discharging
	AC disconnected, battery charging
	AC connected, no summary
	AC disconnected, battery discharging, no summary
	AC disconnected, battery charging, no summary

[power]
command=$SCRIPT_DIR/power
markup=pango
interval=1

Configuration parameters can be passed by:

command line arguments (e.g. $ power -S -p 15 -A)
"instance" in the blocklet's section of the i3blocks config file, e.g.:
```
 [power]
 ...
 instance=-S -p 15 -A
 ...
```
shell environment variables (e.g. $ bat_show_summary=no bat_crit_percent=15 ac_show=no power)
if using a recent enough i3blocks version (see here), by dynamic block properties in i3blocks config file, e.g.:
```
 [power]
 ...
 bat_show_summary=no
 bat_crit_percent=15
 ac_show=no
 ...
```

NOTE: Shell ENV overrides dynamic prop overrides instance overrides CLI

Default?	Option	CLI / instance	Shell ENV / dynamic prop
	Print help/usage and exit	`-h`	N/A
	Enable debug messages to STDERR	`-d`	`debug=$TRUE`
	Print config to STDERR	`-c`	`show_config=$TRUE`
Y	Show summarized stats if multiple batteries present	`-s`	`bat_show_summary=$TRUE`
	Show stats for each battery if multiple batteries present	`-S`	`bat_show_summary=$FALSE`
10%	Set battery critical level	`-p $NUMBER`	`bat_crit_percent=$NUMBER`
Y	Use battery last full capacity	`-f`	`bat_full_type=last`
	Use battery design (factory) capacity	`-F`	`bat_full_type=design`
Y	Show battery [dis]charging duration	`-t`	`bat_show_time=$TRUE`
	Don't show battery [dis]charging duration	`-T`	`bat_show_time=$FALSE`
Y	Show AC state	`-a`	`ac_show=$TRUE`
	Don't show AC state	`-A`	`ac_show=$FALSE`