#command-line-tool #notifications #battery #linux

app battered

Make the most of your laptop's battery life with custom actions and informative desktop notifications

5 releases (3 breaking)

new 0.8.0 May 7, 2025
0.7.0 Apr 27, 2025
0.6.1 Mar 16, 2025
0.6.0 Mar 8, 2025
0.5.0 Feb 18, 2025

#554 in Command line utilities

Download history 83/week @ 2025-02-15 24/week @ 2025-02-22 9/week @ 2025-03-01 135/week @ 2025-03-08 135/week @ 2025-03-15 15/week @ 2025-03-22 1/week @ 2025-03-29 128/week @ 2025-04-26 116/week @ 2025-05-03

244 downloads per month

MIT license

59KB
1K SLoC

battered

crates.io

battered Icon

Make the most of your laptop's battery life with custom actions and informative desktop notifications.

Written in Rust, battered uses minimal system resources.


Table of Contents

Features

  • Unlimited custom actions
  • Customizable desktop notifications with placeholder values
  • Optional action and notification on connecting power supply
  • Configurable poll interval

Usage

First, make sure you've configured some actions. Then simply run battered:

battered

Installation

battered is available on crates.io and can be installed from there:

cargo install battered

If you're using Arch Linux you can also install it from the AUR using your favorite AUR helper (e.g. paru):

paru -Syu battered

Configuration

battered looks for a configuration file in the following places:

  1. $XDG_CONFIG_HOME/battered/config.toml
  2. $HOME/.config/battered/config.toml
  3. /.config/battered/config.toml if $HOME is not set

The summary and body fields of the [action.notify] table support optional placeholders which will be replaced with calculated values. The following placeholders are available:

Placeholder Description
$percentage Current battery level in percent

By default battered will monitor the first battery it finds. Use the serial_number config value to pick a specific battery instead. One way to find the serial number is through sysfs. E.g. find the serial number of BAT0:

cat /sys/class/power_supply/BAT0/serial_number

Example config:

interval = 60                        # Battery level check interval in seconds; optional; defaults to 120; integer
serial_number = "31415"              # Serial number of battery; optional; defaults to first battery; string

[[action]]
percentage = 0.25                    # Run action below this threshold; required; decimal
command = "./powersave.sh enable"    # CLI command to run; optional; string
[action.notify]                      # Notification settings; optional; table
summary = "Battery low!"             # Notification summary; required within action.notify table; string
body = "Battery below $percentage%!" # Notification body; optional; string
urgency = "Critical"                 # Notfication urgency; optional; defaults to `Normal`; enum[ Low | Normal | Critical ]
icon = "battery-caution"             # Notification icon; optional; defaults to "battery-discharging"; string
timeout = 0                          # Notification timeout in ms; optional; defaults to desktop default; integer; `0` means no timeout

# There can be as many `action` entries as desired, and order doesn't matter
[[action]]
percentage = 0.95
[action.notify]
summary = "Battery discharging"

# Special action to run after connecting to AC
# Options are the same as for regular actions
[on_ac]
percentage = 0.10                  # Only run if battery level above this threshold; optional; decimal
command = "./powersave.sh disable"
[on_ac.notify]
summary = "Battery charging"
urgency = "Low"
icon = "battery-good-charging"
timeout = 300

Logging

Logging is configured via the RUST_LOG env variable. The provided systemd unit example sets the log level to WARN by default.

License

battered is distributed under the terms of the MIT license.

Dependencies

~3–29MB
~421K SLoC