Battery watchdog
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
ge 837a431cbe fix help 2 weeks ago
COPYING init 2 weeks ago
Makefile init 2 weeks ago
PKGBUILD init 2 weeks ago
README fix help 2 weeks ago
btw fix help 2 weeks ago
btw.1 fix help 2 weeks ago


BTW(1)                           User Commands                          BTW(1)

btw - battery watchdog

btw [-c|--crit level] [-p|--preriod seconds] [-l|--log file]
[-j|--syslog] [-s|--summary text] [-b|--body text] [-w|--watch]
btw --help
btw --version

Send notification when critical battery level reached.

-v, --version
Print version and exit.

-h, --help
Print this help message and exit.

-c, --crit level
Battery critical level in percents [default: 10]

-p, --preriod seconds
Battery check out period in seconds [default: 30]

-l, --log file
Log file [default: ~/.cache/btw.log]

-j, --syslog
Use logger instead of log file.

-s, --summary text
Custom notification title text.

-b, --body text
Custom notification body text.

-w, --watch
Follow to the log file (tail -f).

Run watchdog in background. See application autostart options for your
desktop environment or init system. For example add in your ~/.xinitrc:

btw &

or create ~/.config/autostart/btw.desktop if you have GNOME Desktop:

[Desktop Entry]
Name=Laptop battery watchdog (btw)

btw writes battery status log in log file. Set file by --log option.

Log format:

[date time] [state] [level]%

There is:

[date time]
`date +'%Y-%m-%d %H:%M:%S'` command output.

Battery status, can be 'Charging' or 'Discharging'.

Battery current level in percents.

If --syslog option is passed use following commands to watch log.

btw -jw
# or
journalctl -t btw -f

btw will send notification at every battery checkout while current bat-
tery level is lower than critical level. For example, with following

btw -c 15 -p 30

you will recieve notification every 30 seconds until battery is under
15%. You can set up custom notification text via --summary and --body

Variables can be used in notification:

level Current battery level in percents.

state Battery status, can be full, charging or discharging.

For example:

btw -s 'Battery is very low!' -b 'Status: $state, $level%'

Log file.

Lock file. Prevents unwanted notifications.

acpi(1), notify-send(1)

btw 1.0 2022-10-10 BTW(1)