wmufo - Animated SETI@home dock app monitor

wmufo [-b] [-d DIRECTORY] [-g GEOMETRY] [-h] [-p] [-s UPDATE] [-t TIMEOUT] [-v]

wmufo is an animated dock app which monitors and controls multiple SETI@home clients. The display can alter between an animated display and statistics display.

-b

Activate broken window manager fix (if alien face diplayed)

-d [...]

Specify a SETI@home directory to monitor (overriding configuration file) and may be used multiple times as follows: -d [...] -d [...]

-g [{+-}X{+-}Y]

Set initial window position

-h

Show help

-p

Specify command line for running setiathome process

-s [...]

Time in milliseconds between statistics updates

(Default is 2500)

-t [...]

Timeout from statistics display to animation

(Default is 4 cycles, setting 0 will disable)

-v

Verbose debugging

The animation features a moving starfield, a large flying saucer UFO, and multiple alpha blended glowing ball UFO's. On mouse over the cursor will disappear and be replaced by a ball UFO whose colour depends on the status of the setiathome process. If the current status is pending upload or download of a workunit the sprites will move vertically instead of horizontally.

(Not all window managers support the cursor replacement.)

The statistics provides information on the currently selected SETI@home directory. It alternates between two sequences made up of five lines before returning to the animation.

title [SETI X]

displays title with X=AB..J if multiple directories

progress [12.34% X]

displays the progress where X is program status

(R running, T paused, S sleeping, U stopped)

cpu [01:23:45 ]

displays the total cpu time spent on workunit

timeleft [01:23:45 ]

displays the time left before completion of workunit

nwus [TX: 123]

displays the number of units sent

nresults [RX: 123]

displays the number of units received (dufunct)

pid [PID: 1234]

displays the PID of the seti@home client

bar [=====----]

displays the progress as a graphic bar

totalcpu [PT: 12/34]

displays the total cpu time as either days and hours or years and days

Left click on the animation to change to the statistics

Left click on the top-left quarter of the statistics to change to the animation

Left click on the rest of the statistics to change to the next directory (if one SETI@home directory only, then change to the animation)

Middle click runs or kills the SETI@home client

Right click pauses or continues the SETI@home client

Mouse wheel up or down changes to the next or previous directory

The configuration file for wmufo is shared with wmseti. The file .wmsetirc is stored in the home directory. The configuration covers the SETI@home directories, the setiathome command line and the statistics display,

The setidir parameter defines the directories to be monitored. It can be defined multiple times. A ~/ is expanded to the home directory and ~user/ is expanded to another users home directory. (Default is ~/setiathome)

The setiprg parameter defines the program to be run. Either the full path or simply the program name if it is in $PATH can be used. Alternatively "true" could be used as a dummy program. (Default is setiathome)

The timeout parameter defines the number of cycles before the statistics changes back to the animation. Setting 0 will disable the timeout. (Default is 4)

The update parameter defines the time in milliseconds between statistics updates. (Default is 2500)

The 1 2 ... 10 values set the statistics display, 1 to 5 for the first and 6 to 10 for the second. Possible values are; title, prog, cpu, timeleft, nwus, nresults, pid, bar or totalcpu.

wmufo -D ~/seti/alpha -D ~/seti/beta -g -0+64

.wmsetirc

setidir ~/seti

setidir ~user/seti

setidir /path/to/another/setiathome/dir

setiprg /path/to/program/setiathome -options

timeout 6

1 title

2 prog

3 cpu

4 timeleft

5 nresults

6 title

7 prog

8 cpu

9 bar

10 totalcpu

Please report any bugs you may find to:

http://sourceforge.net/projects/wmseti

Alan Swanson <alan.swanson@ukfsn.org>

http://wmseti.sourceforge.net

http://www.swanson.ukfsn.org