---
name: "wmufo"
section: "1"
platform: "linux"
package: "wmufo"
version: "1.2.1-2"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/wmufo"
---

# wmufo(1)

Animated SETI@home dock app monitor

## NAME

wmufo - Animated SETI@home dock app monitor

## SYNOPSIS

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

## DESCRIPTION

**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.

## OPTIONS

- **-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

## DISPLAY

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

## CONTROL

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

## CONFIGURATION

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.

## EXAMPLES

**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

## BUGS

Please report any bugs you may find to:

- **http://sourceforge.net/projects/wmseti**

  ## AUTHOR

Alan Swanson \<alan.swanson@ukfsn.org\>

http://wmseti.sourceforge.net\
 http://www.swanson.ukfsn.org