github.com/doums/bato @v0.3.1

bato

A program to send battery level notifications

features - prerequisite - install - configuration - usage - license

Features

Tiny configuration in toml.

Desktop notification:

• level full
• level low
• level critical
• charging
• discharging

Prerequisite

A desktop notification server, like Dunst

Install

• latest release
• AUR package

Configuration

By default, bato looks for the config file ~/.config/bato/bato.toml (XDG dir spec).\ To use a custom file, run with the --config flag.\ If the config file is not found or invalid, bato prints an error and exits.

All config options are detailed here.

[!TIP] Keep tick_rate low to save battery. Bato uses udev to listen to AC events,\ so it notifies instantly on charger plug/unplug.

Example:

tick_rate = 30 # sec
critical_level = 5
low_level = 20
full_design = true

[charging]
summary = "Battery"
body = "Charging"
icon = "battery-good-charging"

[discharging]
summary = "Battery"
body = "Discharging"
icon = "battery-good"

[full]
summary = "Battery"
body = "Full"
icon = "battery-full"

[low]
summary = "Battery"
body = "Low"
icon = "battery-low"

[critical]
summary = "Battery"
body = "Critical!"
icon = "battery-caution"
urgency = "critical"

Usage

Run bato via your window manager or desktop environment autostart system

Example with XMonad

myStartupHook = do
    spawnOnce "dunst"
    spawnOnce "bato -lfile"

[!TIP] By default bato logs to stdout. To log into a file run with -lfile. Logs are located in ~/.cache/bato/

bato -h

License

Mozilla Public License 2.0