bat

NAME
    bat -- battery management utility for Linux laptops 

SYNOPSIS
    bat [-chprst] [-t num]

DESCRIPTION
    The following options are available:

    -c, --capacity  
        Print the current battery level.
    -h, --help      
        Print this help document.
    -p, --persist   
        Persist the current threshold between restarts.
    -r, --reset    
        Undoes the persistence setting of the charging threshold between 
        restarts.
    -s, --status
        Print the charging status.
    -t, --threshold num
        Print the current charging threshold limit.
        If num is specified, which should be a value between 1 and 100, this
        will set a new charging threshold limit.
    -v, --version
        Display version information and exit.

About

The goal is to replicate the functionality of the ASUS Battery Health Charging utility for ASUS laptops on Windows which aims prolong the battery's life-span ^{1 2}.

Disclaimer

This has only shown to work on ASUS laptops. For Dell systems, see smbios-utils, particularly the smbios-battery-ctl command, or install it using your package manager. For other manufacturers there is also TLP.

There have also been some problems setting the charging threshold inside of a virtual machine.

Installation

Precompiled binaries (Linux x86-64) are available from the GitHub releases page, the latest of which can be downloaded from here.

After downloading the binary, give it permission to execute on your system by running the following command. For example, assuming the binary is located in the user's Downloads folder:

$ chmod +x $HOME/Downloads/bat

Alternatively, the application can be build from source by running the following Go command.

$ go build ./cmd/bat/

Tip: Place the resulting binary in a directory that is in the $PATH environment variable such as /usr/local/bin/. This will allow the user to execute the program from anywhere on their system.

Another tip: Rename the binary to something else if another program with the same name already exists on your system i.e. bat.

Examples

# Print the current battery charging threshold.
$ bat --threshold

# Set a new charging threshold, say 80%.
# (requires superuser permissions).
$ sudo bat --threshold 80

# Persist the current charging threshold setting between restarts
# (requires superuser permissions).
$ sudo bat --persist

Requirements

Linux kernel version later than 5.4 which is the earliest version to expose the battery charging threshold variable.

To persist the threshold setting between restarts, the application relies on systemd, particularly a version later than 244, and Bash which are bundled with most Linux distributions.