Skip to content

Latest commit

 

History

History
37 lines (30 loc) · 1.35 KB

README.md

File metadata and controls

37 lines (30 loc) · 1.35 KB

battery-poly

Generates a pretty battery string for multi-battery systems. Based on cogitantium/poly-battery-status-py. Licensed under GPLv3.

Features

  • Uses sysfs for gathering batteries and values on these
  • Calculates time-to-depleted and time-to-full from current power-draw
  • Takes battery-thresholds, such as TLP, into account when calculating time-to-full. Defaults to 100% but is overrideable through arguments.
  • Omits time-to-* when passive (specifically when sysfs delivers a status of Unknown or Full)
  • Takes a Python formatting string for percentage. Default is .2% rendering a percentage with two decimals.

Dependencies

  • python3
  • sysfs (provided by Linux kernel since 2.5)

Config

[battery-poly]
command=$SCRIPT_DIR/battery-poly
LABEL=BAT
interval=5

Two positional arguments are supported; battery-threshold as float and percentage formatting as Python formatting string.

To configure battery-poly for a battery-threshold of 42%, edit the command-line as such:

[battery-poly]
command=$SCRIPT_DIR/battery-poly 0.42

If no decimals are desired for the percentage and battery-threshold is not to be changed, simply put the default value as follows:

[battery-poly]
command=$SCRIPT_DIR/battery-poly 1.0 .0%