wmvolt.1.asciidoc

wmvolt(1) Manual Page

NAME

wmvolt - A dockapp to monitor Linux ACPI battery status

SYNOPSIS

wmvolt [options] [--help]

DESCRIPTION

wmvolt is a program to monitor ACPI battery status (using a "new" /sys/class/power_supply/* interface). It’s a dockapp for Window Managers like Window Maker or FVWM.

If the battery status is below some critical point (20% by default), an alarm goes off via constantly toggling the backlight on/off. The app can launch any external program when the battery level is too low.

MOUSE BUTTONS

Left (1)

Toggle the backlight

Right (3)

Stop/start the alarm indicator.

OPTIONS

-W

Activate The Broken Window Manager fix. Required for FVWM.

-l #rgb

A default backlight color.

-L #rgb

A backlight color when AC is off.

-a digit

At which threshold is to raise the alert, [1-99]. (20 is the default).

-b

Turn on the backlight.

-B digit

Explicitly select the battery.

-p

Print all the available batteries.

-n string

A command that runs when the alarm goes off. (None by default.) You can use %s that will be replaced by the current battery load. For example: wmvolt -Wb -n 'xmessage "Your battery is running low (%s%%)!"'.

For other less useful options, run the app w/ --help.

EXAMPLES

Set 2 variants of a backlight:

$ wmvolt -Wb -L '#ff0000' -l '#48d1cc'

AUTHORS

Alexander Gromnitsky <alexander.gromnitsky@gmail.com>, Thomas Nemeth <tnemeth@free.fr> (wmapmload).