TkBattery, by Jim Turner c. 2016
tkbat.pl [--options=values]
tkbat.pl [-d|--debug] [--config=<configfile> [--pollmsec=#[60000]] [--geometry=wxh+x+y] [--windowmgr=[0]|1] [--apmchkd=[0]|1|2]
tkbat.pl --help (display usage message)
This program displays a nice graphic and text showing the battery status. I wrote this because wmpower and wmbattery no longer work with modern kernels.
How to set up:
1) Copy tkbat.pl to /usr/local/bin/, or whereever.
2) Copy the images (warnlobat.xpm and susplobat.xpm) to /usr/share/pixmaps/ (or whereever, or use your own - if creating a config file and using the --apmchkd option).
3) The optional file: $HOME/.config/tkbat.cfg takes the format (defaults shown below): Any line starting with "#" is ignored as a comment. See example (default) below:
#LOCATION ON SCREEN (X,Y) IF NOT BEING SWALLOWED BY WHARF: geometry=+100+100
#POLL BATTERY STATUS EVERY # MILISECONDS:
pollmsec=60000
#BORDER APPEARANCE (CHOICES: flat, groove, raised, ridge, sunken):
relief=ridge
#OVERRIDEDIRECT ARGUMENT 0=MANAGED BY WINDOWMANAGER (DECORATE)
#1=BYPASS WINDOWMANAGER (NO DECORATION). USE 0 IF DOCKING IN
#WINDOWMAKER OR AFTERSTEP.
windowmgr=0
#COLOR WHEN FULLY CHARGED ON A/C:
accolor=blue
#COLOR WHEN CHARGING ON A/C:
chargecolor=cyan
#NORMAL COLOR WHEN DISCHARGING (ON BATTERY)
normalcolor=green
#BACKGROUND COLOR:
bgcolor=black
#COLOR OF REMAINING PORTION OF BATTERY ICON WHEN NOT FULLY CHARGED:
batcolor=black
#WARNING COLOR WHEN DISCHARGING (ON BATTERY WHEN BELOW warnpct %):
warncolor=yellow
#PERCENT REMAINING BELOW WHICH COLOR CHANGES FROM GREEN TO YELLOW):
warnpct=25
#ALERT COLOR WHEN DISCHARGING (ON BATTERY WHEN BELOW alertpct %):
alertcolor=red
#PERCENT REMAINING BELOW WHICH COLOR CHANGES FROM YELLOW TO RED):
alertpct=11
debug=0
#FONT TO DISPLAY TIME AND PERCENT REMAINING TEXT:
font=-*-lucida console-bold-r-*-*-14-*-*-*-*-*-*-*
#WHETHER OR NOT TO DISPLAY ALERT IMAGES WHEN BELOW 7% AND HIBERNATE
#BELOW 4%:
apmchkd=0
#ADDITIONAL apmchkd OPTIONS:
#PERCENT REMAINING BELOW WHICH THE WARNING IMAGE POPS UP ONSCREEN:
#NOTE: THIS IS SEPARATE FROM "warnpct" WHICH TURNS THE FOREGROUD YELLOW!
warnPct=7
#PERCENT REMAINING BELOW WHICH THE CRITICAL IMAGE POPS UP ONSCREEN AND
#THE USER IS GIVEN hibernateDelay (15) SECONDS TO PLUG IN A/C POWER
#OR THE SYSTEM WILL GO INTO HIBERNATION:
suspPct=4
#X VIEWER PROGRAM TO DISPLAY THE POPUP IMAGE(S):
imageViewer=/usr/bin/feh
#THE WARNING AND CRITICAL IMAGES TO BE POPPED UP:
warnImage=/usr/share/pixmaps/warnlowbat.xpm
errImage=/usr/share/pixmaps/susplowbat.xpm#OPTIONAL COMMAND / SCRIPT TO EXECUTE WHEN THE WARNING IMAGE IS
#POPPED UP, IE. PLAY A SOUND FILE, SAVE WORK, ETC.:
warnCmd=""
#OPTIONAL COMMAND / SCRIPT TO EXECUTE WHEN THE CRITICAL IMAGE IS
#POPPED UP, IE. PLAY A SOUND FILE, SAVE WORK, ETC.:
errCmd=/usr/local/bin/play /home/turnerjw/Music/shuttingdown10sec.wav
#COMMAND / SCRIPT USED TO HIBERNATE THE SYSTEM WHEN CRITICAL:
s2dCmd=sudo /usr/local/bin/s2disk
#DELAY (IN SECONDS) TO WAIT AFTER DISPLAYING THE "CRITICAL" POPUP IMAGE
#AND ACTUALLY HIBERNATING THE SYSTEM (NOTE: ONE MORE STATUS CHECK IS MADE
#AFTERWARDS AND THE HIBERNATE IS ABORTED IF A/C POWER IS THEN DETECTED)!
hibernateDelay=15
4) To make this app. appear in your AfterStep/Windowmaker "wharf", add the following to your config file:
*Wharf TkBat - MaxSwallow "TkBat" /usr/bin/nice -n 5 /usr/local/bin/tkbat.pl --apmchkd=1 &5) run tkbat.pl -h to view which options can be set on the command-line (options set on the command line overrule those set in the configuration file).
6) Enjoy!