File	Date	Author	Commit
INSTALL	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
JBattery	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
JBattery.7z	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
JBattery.pro	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
JBattery.pro.user	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
Makefile	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
QBatteryReader.cxx	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
QBatteryReader.h	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
QJBatteryTrayIcon.cxx	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
QJBatteryTrayIcon.h	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
QSimpleHalBatteryReader.cxx	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
QSimpleHalBatteryReader.h	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
QUpdaterThread.cxx	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
QUpdaterThread.h	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
README	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
README~	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
apm_defs.h	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
build.sh	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
copyright	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
main.cxx	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
moc_QBatteryReader.cpp	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
moc_QJBatteryTrayIcon.cpp	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
moc_QSimpleHalBatteryReader.cpp	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
tray_full.xpm	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
tray_full_poweron.xpm	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
tray_high.xpm	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
tray_high_poweron.xpm	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
tray_low.xpm	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
tray_low_poweron.xpm	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
tray_low_warning.xpm	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
tray_medium.xpm	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
tray_medium_poweron.xpm	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit
tray_probing.xpm	2010-09-10	João Ricardo Lourenço	[4df0ab] Initial commit

Read Me

JBattery is what I consider an improvement over wmbattery in terms of
what the modern end-user wants. It uses large parts of wmbattery's code, but has
re-written it using Qt4 libraries. Previously, I used a modified wmbattery
battery called jbattery which was wmbattery with additional gtk code to display
a tray icon. JBattery is a real attempt at rewriting wmbattery.

All X-specific code that was in wmbattery has been removed from JBattery.
The role of JBattery is now that of staying in the tray and displaying
info. Additionally, it can notify the user via command-line interfaces assumed
to exist in the host machine. It can also play warning messages
through either an old (wmbattery based) OSS-module or the new command-line
paplay utility.

   To be run, JBattery needs:
      -- notify-send
      -- paplay
      -- s2ram (with root access, to suspend the machine)
      
   To be compiled, JBattery needs:
      -- Qt4 libraries
      -- qmake-qt4
      -- libhal
      -- libdbus-1
      -- libpthread
      -- librt

It should be fairly easy to get a working JBattery windows version. It is only
a matter of writing a QWindowsBatteryReader, provided that the apm_info struct
is available. Additionally, the sound code can be #ifdef'ed to windows-simple
sound code. Notifications can be ported with windows-specific code as well.
      
JBattery is incomplete. It works in my system, but all other modules that I
could have made built-in were disabled and removed. It uses the HAL interface
which is trully dead now. I like it, however. 
Code and Art is GPL'ed
                                 --
                                      João Ricardo Lourenço <jorl17.8@gmail.com>

--------------------------------------------------------------------------------

wmbattery displays the status of your laptop's battery in a small icon. This
includes if it is plugged in, if the battery is charging, how many minutes
of battery life remain, battery life remaining (with both a percentage and a
graph), and battery status (high - green, low - yellow, or critical - red).

wmbattery is based on wmapm by Chris D. Faulhaber <jedgar@speck.ml.org>
-- see the copyright file for more information.

wmapm is a nice program - why have I modified it into wmbattery? Here are
some improvements in wmbattery:

  - Improved icon layout. I crammed the same information into less space
    while making the icon more elegant and visually pleasing (IMHO).
  - Easier to drag onto dock.
  - It consumes a little less memory.
  - Uses only 10 colors.
  - You can run in on a different display via -d (broken in wmapm).
  - Support for getting battery status from the sonypi driver instead of APM,
    for some Sony laptops that do not have apm support.
  - ACPI support, including multiple battery support and battery charging
    completion countdown timer.
  - HAL support.
  - Can make its own estimatess of time remaining or time until full
    charge, even if APM does not.

Conversely, here are some reasons to stick with wmapm:

  - You like its look.
  - It has a neat rainbow-colored progress bar.
  - It has buttons to suspend the laptop and stuff.
  - It may be more actively and/or better maintained. Or not. 
    Decide for yourself.

Still, forking is evil, and if I was doing this all over again, I suppose
I'd try to add theme support to wmamn so it could morph into wmbattery with
a theme. Oh well.

The homepage for wmbattery is <http://kitenet.net/~joey/code/wmbattery/>

-- Joey Hess <joey@kitenet.net>