NAME

       wmgtemp - Temperature sensor dock app for Window Maker

SYNOPSIS

       wmgtemp [options]

DESCRIPTION

       wmgtemp  is  a  dock-app for Window Maker that graphically displays the CPU and System temperatures using
       the lm_sensors package. It displays the CPU and System temperature values, a scaling graph of temperature
       history, high-temperature warning lights and temperatures in degrees Celsius, Fahrenheit or Kelvin.

       The temperature graph is auto scaling, meaning that if the max or min temperature boundary is crossed the
       graph will be scaled to display the temperature. A red line marks the upper boundary whereas a blue  line
       indicates  the  lower  boundary.  When all the temperatures being displayed are within the boundaries the
       graph will be scaled back to the preset values for min/max and  the  boundary  indicator  lines  will  be
       removed.

       The  high temperature warning lights located on the left of the temperature type indicators show amber or
       red when the warning or high temperatures are  reached  respectively.  Normal  operating  temperature  is
       indicated by no light.

OPTIONS

       -h, --help
              display the usage information

       -s, --scale=SCALE
              show temperatures using SCALE temperature scale. SCALE=celcius, fahrenheit or kelvin.
              Default: celcius

       -S, --sensorconf=PATH
              specify the PATH to the lm_sensors config
              Default: /etc/sensors.conf

       -g, --graph=STYLE
              display graph as STYLE. STYLE=line or block.
              Default: line

       -H, --high=TEMP
              display red warning light at TEMP degrees celcius.
              Default: 50

       -w, --warn=TEMP
              display amber warning light at TEMP degrees celcius.
              Default: 45

       -u, --update=SEC
              update the display every SEC seconds.
              Default: 1

       -m, --min=TEMP
              set the lower bound of the graph to TEMP degrees celcius.
              Default: 20

       -M, --max=TEMP
              set the upper bound of the graph to TEMP degrees celcius.
              Default: 35

       -1, --feature1=F1
              set the feature for CPU
              Default: temp1

       -2, --feature2=F2
              set the feature for SYS
              Default: temp2

       -c, --chip=CHIP
              specify the chip sensor to use
              Default: auto

       -a, --execat=TEMP
              execute a command at TEMP degrees celcius.
              Default: none

       -e, --exec=COMMAND
              execute COMMAND when the 'execat' temperature is reached.
              Default: none

       -t, --swap
              swap/transpose temperature values

       -q, --quiet
              Don't display any messages

FILES

       ~/.wmgtemprc   User configuration.

       The format of this file is:

              # wmgtemp example config
              scale:celcius
              graph:line
              high:50
              warn:45
              update:1
              min:25
              max:35
              execat:80
              exec:shutdown -h 10
              swap:n
              quiet:y
              feature1:temp1
              feature2:temp2

USAGE

   Graph
       You can cycle through the graph types by clicking on the graph display area.

   High Temperature Toggle
       You  can  toggle  the  displaying  of high temperatures by click on the temperature for the corrosponding
       temperature. The viewing of high temperatures is  indicated  by  an  amber  arrow  to  the  left  of  the
       temperature. The current temperatures will continue to be displayed on the graph.

   Temperature display TOGGLE
       You may toggle the displaying of a temperature on the graph by clicking on the corrosponding type. e.g To
       toggle the display of the CPU temperature click on CPU. The type indicator (CPU or  SYS)  will  disappear
       and  the  temperature will not be displayed on the graph, although the temperature value will continue to
       be displayed.

   Temperature Scale Cycling
       You may change the scale the temperatures are displayed in by clicking on either of the CPU or SYS  scale
       indicators. The cycle order is C -> K -> F

BUGS

       Blank lines in the config file cause a Segmentation Fault.

SEE ALSO

       sensors.conf(5), libsensors(3), wmaker(1x)

AUTHOR

       wmgtemp was written by Roger Dunce <kronos@fluxcode.net>

                                                  February 2001                                       wmgtemp(1)