fookb: Make WUtil required instead of optional.
[dockapps.git] / wmbattery / README
blob8f8987cb4673e7d48334a5315761dbd1da15adac
1 wmbattery displays the status of your laptop's battery in a small icon. This
2 includes if it is plugged in, if the battery is charging, how many minutes
3 of battery life remain, battery life remaining (with both a percentage and a
4 graph), and battery status (high - green, low - yellow, or critical - red).
6 wmbattery is based on wmapm by Chris D. Faulhaber <jedgar@speck.ml.org>
7 -- see the copyright file for more information.
9 wmapm is a nice program - why have I modified it into wmbattery? Here are
10 some improvements in wmbattery:
12   - Improved icon layout. I crammed the same information into less space
13     while making the icon more elegant and visually pleasing (IMHO).
14   - Easier to drag onto dock.
15   - It consumes a little less memory.
16   - Uses only 10 colors.
17   - You can run in on a different display via -d (broken in wmapm).
18   - Support for getting battery status from the sonypi driver instead of APM,
19     for some Sony laptops that do not have apm support.
20   - ACPI support, including multiple battery support and battery charging
21     completion countdown timer.
22   - HAL support.
23   - upower support.
24   - Can make its own estimatess of time remaining or time until full
25     charge, even if APM does not.
27 Conversely, here are some reasons to stick with wmapm:
29   - You like its look.
30   - It has a neat rainbow-colored progress bar.
31   - It has buttons to suspend the laptop and stuff.
32   - It may be more actively and/or better maintained. Or not.
33     Decide for yourself.
35 Still, forking is evil, and if I was doing this all over again, I suppose
36 I'd try to add theme support to wmamn so it could morph into wmbattery with
37 a theme. Oh well.
39 The homepage for wmbattery is <http://kitenet.net/~joey/code/wmbattery/>
41 -- Joey Hess <joey@kitenet.net>