WmTemp  -- A dockapp to monitor the temperature of the HP omnibook,
Toshiba Satellite 3000, and any laptop supported by the omnibook module.


Copyright (C) 2003  Ducrot Bruno  <ducrot@poupinou.org>


Mainly based on WmLonRun version 0.2.0., which is copyrighted by
Seiichi SATO and was released under the GPL.


Please consult wmtemp.c for distribution terms, credits, etc.


platform:
---------
- Any GNU/Linux with the omnibook kernel module.


requirements:
-------------
- libXPM 4.7 or newer.  Older version may not work.
  Available at <ftp://sunsite.unc.edu/Linux/libs/X/>

installation:
-------------

untar as usual, then issue a make.

If 'make' failed, try to edit the Makefile.  If it still don't compile,
write to <omnibook@zurich.ai.mit.edu>  with a [help] in the subject.
If also you had have to edit the sources in order to compile, please report
me.

you should want to do something like:
cp wmtemp /usr/local/bin
for installation purpose.

On RedHat, you can build an rpm package via:
rpmbuild -ta wmtemp-<version>.tar.bz2
then install as usual:
rpm -Uvh wmtemp-<version>.rpm

On Debian, you can build an deb package via:
debian/rules build
debian/rules binary
dpkg -i ../wmtemp_<version>.deb


In order to be able to control the fan, you may want either:
- pass the option 'user=1' to the omnibook kernel module
or
- install an helper program to be used via sudo(8).

For this, just install the shell script 'fan_ctl' in /usr/local/bin:
install -o root -g root -m 755 fan_ctl /usr/local/bin
then edit /etc/sudoers via the command visudo(8) so that it look like:

Define a Cmnd_Alias as for example:

Cmnd_Alias	OMNIBOOK = /usr/local/bin/fan_ctl

Then define an user privilege that look like:

my_login	ALL=(root) OMNIBOOK


You may also add more commands in the command alias in order to be able to
write to some /proc/omnibook/ files via sudo (I have for example such
script in order to turn lcd on/off).


usage:
------
wmtemp -h
to get help.

You can also control the fan by clicking the little wheel.

omnibook kernel module  can be found at same location of this
applet, that is:

http://sf.net/projects/omke/



Note also there is a '-w' option, so you can do something
like 'wmtemp -w' if you want to run this program in a window, instead
as a dockapp.

For instance, AfterStep users should try this (taken from the README of
WmLongRun):
Add below entry to your Wharf
	*Wharf wmtemp - Swallow "wmtemp" wmtemp -w &


For Enlightenment users, the '-bw' option will help you.

For WMaker, or BlackBox, it is straightforward.


I also need feedback, success or failure, so don't hesitate to write me!


-- 
Ducrot Bruno  <ducrot@poupinou.org>
