Watsup - compact display of system resources and top processes

DESCRIPTION

   Watsup provides a detailed real-time report of total system and 
   top process resource loadings. 

   Watsup has two kinds of report:
     - a tiny window with basic system load data: CPU, disk, network.
     - a resizable window showing more system details and details
       for the highest resource processes fitting within the window. 

SYNOPSIS

   $ watsup             start the tiny report
   $ watsup details     start the detailed process report
   
   Click on the menu button to get a popup menu:
      quit        quit the application
      details     start detailed report
      user guide  view the user guide
      CLOSE       exit menu and do nothing
   
   Use the drag button to reposition the tiny report to the desired
   corner of the monitor. This is remembered when the app is started.

   The detailed report displays resource loadings for the entire system 
   and for the top processes using those resources:
      • Overall system and top process resources are shown on one page 
      • CPU, memory, disk I/O, network I/O, page fault rates are shown
      • The topmost-ranked processes fitting within the window are shown 
      • Process rank is a weighted sum of recent CPU, fault rate, I/O rate
      • Minimal movement between samples (a process can be easily watched) 
      • Overhead is low, so sub-second sampling periods are practical
      • Optionally filter for desired users, PIDs, or program names
      • Optional omission of idle processes momentarily using no resources
      • A process can be selected with the mouse and killed
      • Window size is adjustable - show only a few processes or 50+

   The report has toolbar buttons for the following functions:
      parms  set sample period and filters for detail process report
      start  start sampling and reporting
      stop   stop sampling and reporting (window is frozen)
      sort   sort process list by descending resource usage
      save   save current window to a file
      quit   terminate the detailed report - panel remains
      help   display the man page (this page)
 
   A process can be killed by clicking it with the mouse. 
   A confirmation dialog follows.
 
   You can reduce the process list to a desired subset by adding filters
   using the [parms] button. Enter text strings to match desired users,
   programs, or PIDs. Wildcards may be used, e.g. 'gnome*' would cause 
   the many gnome-xxxx daemons to be monitored. The last 20 filters are 
   saved and made available for re-selection.
   
   To include root processes, start watsup with 'sudo watsup'.

UNINSTALL
   Debian package: use command: sudo apt remove watsup
   Source tarball: use command: sudo make uninstall
   Binary package: delete 'watsup' files in $HOME/.local/* 
 
SEE ALSO
   The README file has instructions to build watsup from source code.
 
AUTHORS
   Written by Michael Cornelison <mkornelix@gmail.com>
   https://kornelix.net/

