What wmalms can do ?
What wmalms cannot do ?
What wmalms might be able to do ?..
Installing i2c drivers and lm_sensors
From a tarball (tar.gz) From RPM package
Window location and appearance.
-display -wmode icon title (-itind)
-geometry -transient -font
-bg -led -fg
-device -pages temperature scale (-cent -fahr)
-refresh -shift -beep
Starting wmalms as a dockable / swallowed applet.
Window Maker BlackBox, FluxBox and clonesControlling wmalms at run time
Gnome KDE (kwm + kpanel) FVWM and clones
Where and Who
wmalms stands for "Another LM_Sensors", since the application needs lm_sensors package for its functionality (see Installation ). The application was designed as a window maker dockable applet (this is how wm sneaked into its name), but you can also run it as a swallowed application with any window or desktop manager that supports swallowing, including gnome, kwm (kde), fvwm and its clones. Alternatively, you can run it as a normal window with any window manager.
wmalms displays the values obtained from a 'health monitoring device', or in plain words, a sensor chip, installed on an i2c or SMBus compatible bus. Usually sensor data include voltage, temperature, fan speed. If you use a Pentium II+ or AMD K7 there is a considerable chance the the sensor chip is present on your motherboard.
Obtain i2c drivers and lm_sensors package from
anf follow instruction in QUICKSTART . See if your
hardware is detected by sensors-detect, if it is, you have
nothing to worry about ! Change /etc/rc.d/rc.modules and /etc/modules.conf
as suggested by sensors-detect, restart the system (unless you know how
to avoid that), and type 'sensors'. If you get something long
and hardly readable :=) you've done it!
http://www.inria.fr/koala/lehors/xpm.htmlThis is where it used to be a while ago, I hope it's still available.
tar -xzf wmalms-1.1.0.tar.gzAfter the application is built, log in as root and type
As usually, ./configure recognises
and accepts environment variables CC and CFLAGS.
You can also specify location of documents, using
The use of parameters is shown by the following example:
export CFLAGS='-march=athlon -mcpu=athlon -O6 '
./configure --prefix=/usr/X11R6 --docdir=/usr/share/doc/wmalms
The following make scripts might also be useful:
make clean - removes all object (.o) files forcing full recompilationThe installed package includes the following files:
make wipe - removes all generated files (objects, binaries, Makefile, cache, etc)
With a binary package skip this paragraph, if you use a source distribution, you need to say
rpm --rebuild wmalms-1.0.0-1.src.rpmand this will create a binary package in usr/src/redhat/RPMS/i586 (it could be i386 or i486 ).
The final step and the only one if you use binary package:
rpm -Uvh wmalms-1.0.0-1.i586.rpm
After installation is complete, drop the administrator privileges and try running:
wmalms -bg navy &Non-transparent background will make the wndow more visible.
You most probably will need to customize
it for to your hardware window manager and taste -
see instructions below.
The description of command line
Not available as a resource
Specifies display name (e.g. grumpy.mynet.net:0), default display is used is omitted.
Run application as a window or as an icon. Possible mode values are:
-docked -iconic and -wnd are equivalent to -wmode d , -wmode i, and -wmode w respectively.
Run as a docked icon (main window is withdrawn). Suits WindowMaker, BlackBox and clones
Run in window mode (main window is mapped, icon is not created). Suits gnome, kde, fvwm, or in case docking/swallowing is not required.
Start with main window iconified. Normally used in combination with Icon Title specification Guess (default)
The application will try to figure out which mode (Docked or Window) will be the best for your window manager.
As is common for an X11 application, geometry specfifies size and/or position of the window in format:
Size is 64(default) or 48.
In order to specify window location, you need to include bothxoffset and yoffset. Each of these values is interpreted as an offset from left / top screen border, if positive, or from right / bottom border , if negative. The offset is always evaluated from the nearest window boundary
-nogeometry disables geometry, specified as a resource. This implies size 64 x 64 and default location.
window size 48x48, use default location
-geom +100+5 size 48, locate at x=100, y=5
-geom -50+5 align to right (leave gap of 50) y=5
-geom -0-0 align to bottom right corner
Hint. Explicitly specified window position normally results in suppressing window manager placement policy. This might be useful if a window manager is configured for manual (mouse) placement, especially with fvwm: GoodStuff will naively attempt mouse placement even for a swallowed window !
Another example when explicit location is needed for a swallowed application is related to FvwmButtons module (used most often with fvwm2). With an old version of FvwmButtons (I hope this has been fixed by now !) the application window will appear on the desktop for a short time during FvwmButtons initialization. If that annoys you, you just need to set location in an off-screen area (-geometry 48-2000-1500).
Apply/don't apply transient hint to the application window. This might affect window decoration. Some WM (like kwm) hide iconify button for a transient window, that allows seing the caption, some others (fvwm and clone) can be configured not to draw a caption for a transient window. Default: -notransient
Font name used for the labels,
given in HPCE format (e.g. . "-*-fixed-medium-*-*--8-80-*-*-*-50-*-*")
or as an alias (e.g. "5x8"). Default font : 5x8 for size 64x64, 5x7 for size 48x48
List of colours used for window background.
Can specify a separate colour for each page separated with comas
or a single colour for all pages, Special colour name none is used for transparent background. Default: none
-led led colour
Colours for sensor readings ("leds")
in normal and alarm state. Specified as two coma-separated colour
-fg colour list
Colour for label for each page coma
separated. If omitted, the default value is substituted,
Usually a motherbord has only a single sensor device, and this device will be processed (wmalms skips the device named eepromsince EEPROM data themselves are not of much use in our case). However it can be a situation when explicitly specified chip name can avoid confusion. You can specified a just chip name (-device w83782d), or a full lm_sensors name including bus and slot (-device w83782d-i2c-0-2d).
Number of display pages (1 - 4) . Each
page has 4 values. Pages are changing at a regular interval of time or on
Show temperatures using Centigrade (default) or Fahrenheit scale.
Alarm mode: if some pages
are in alarm state, only alarmed pages are shown and sound signal
can be generated regularly (see beep
Non-alarm mode (default): always show all pages is sequence
A page is in alarmed state, if at least one value on this pages is beyond the limits, and is not marked as alarm-insignificant (see value parameters below)
. . .
These iare probably the most important
wmalms parameters that specify which sensor value is displayed at each
The values are numbered from 1 to 16: page 1 has values 1 to 4, values 4 to 8 are located on page 2, etc.
For each value you can specify the following parameters, separated by a coma (,):
If you are satisfied with default, you can skip any value (so that several comas appear one after another), and even drop the whole tail: no need to code trailing comas. Don't forget to put the list in quotes ("...") if special characters (like semicolons) or spaces appear inside it !
Here are the fields:
Example: the following lines are equivalent for my chip:
-value8 "in6,,2,-4.2,-7.4"In first case the internal name is specified, while lm_sensors label is used for the second line.
-value1 = ",sysT,2"
Sets wmalms title for value1 to sysT
(system temperature) and increases number of decimal places to 2. Hardware
limits are used.
Specifies interval (in seconds) between consequtive data updates as an integer in range 1 to 60. Default 4.
Specifies interval (in seconds)
between consequtive automatic page changes, in range 4 to 600. Default
shift value cannot be less than refresh value. if it happens refresh value is set to be also shift value.
For efficiency it is recomended (though not necessary) to take shift as a multiple of refresh
(i.e shift / refresh is an integer)
Specifies interval (in seconds) between
consequtive sound signals in alarm state, (e.g.. how annoying is the
alarm) in range automatic page changes, in range 0 to 30.
Value 0 (default), or -nobeep disables sound. A positive -beep interval implicitly turns on alarm processing (specified by -alarm command line argument)
shift value cannot be less
than refresh value. if it happens refresh value is set to be also shift
In case sound is enabled, for efficiency it is recomended (though not necessary) to select beep interval as a multiple of refresh interval and/or vice versa.
Display list of command line arguments
and quit. The list is sent to standard output file.
Help pages is also displayed incase of command line error, where is is followed by an error message.
Include this command line argument to create or update user resource file. The existing resource parameters (if any) are combined with command line arguments (which can overwrite resource settings) and the combined set of parameters is stored in the user resource file.
wmalms -save -geometry -0+5 -refresh 2 -beep 4 -shift 20 -fg "black,dark green,maroon"Next time you just type 'wmalms' and your settings are recovered.
All arguments cant be stored as resources, apart from the following: -display-help -save .
You can control windows in run time.
Tested with gpanel 1.0.55 and enlightenment 0.15.5.
Gnome 2 does not support running
In the appearing kfm form, select Execute tab and type a text similar to the following:
Execute (on top)You can't control the applet in run time, but you can use swallowed icon as a link: clicking it with left button starts the application in non-swallowed mode.
wmalms -bg "dark blue" -transient -geometry -0+5 -wnd
Swallowing on panel
Execute: wmalms -geom 48 -fg "dark blue,dark red,dark green"
Window Title: wmalms
Run in terminal: NOT ticked.
Select OK to create a new icon on the desktop
Drag the icon to panel and wait till the aplication start.
Tested with kwm 0.14 and kpanel 0.20
KDE 2 and 3 do not support
running swallowed applications. Get
*GoodStuff wmalms None Swallow "wmalms" wmalms -fg DarkSlateGray,navy,maroon -geom 48+0+0 &
If you use fvwm2 or fvwm95 and FvwmButtons module with normal icon size (e.g. Module FvwmButtons appear in InitFunction list without MiniButtons parameter), add the following line to ~/.fvwm2rc ( ~/.fvwm95rc for fvwm95):
*FvwmButtons wmalms NULL Swallow "WMalms" Exec wmalms -geometry 48-2000-1500
(See comments regarding -geometry above ).
For all fvwm versions you should be able control the window in run time.
The following key + mouse button combinations force changing displayed page:
+ left mouse - go to the previous (previous alarmed) page
Shift key + right mouse - go to the next (next alarmed) page
This is a safe way to quit wmalms:
Ctrl key + right mouse - quit.
Another way of safe quit is
"Close Window" (appearing also as "Delete", or
Avoid "Kill Window" where possible !
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the
Free Software Foundation, Inc.
675 Mass Ave, Cambridge, MA 02139, USA.
Please send comments (of any
kind!) to me (Michael Glickman):
If you do that, please include 'wmalms' into the subject to help me filter it out of junk mail.
Check Web for my other GNU Linux
and X11 applications: