Battery watchdog
You cannot 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 5 months ago
COPYING init 5 months ago
Makefile init 5 months ago
PKGBUILD init 5 months ago
README fix help 5 months ago
btw fix help 5 months ago
btw.1 fix help 5 months 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)