NAME

       xstarfish - tiled root window wallpaper generator

SYNOPSIS

       xstarfish [ options ]

DESCRIPTION

       XStarfish  generates colourful, tiled images using random numbers fed through mathematical
       functions and draws them on the background of your desktop. It does not use  source  image
       files, so it can generate its images nearly forever without running out of material.

OPTIONS

       -h, --help, --usage
              Print the message you're reading now.

       -v, --version
              Current version of the program.

       -d, --daemon INTERVAL [UNITS]
              Fork off into the background. XStarfish will generate a pattern, sleep for INTERVAL
              UNITS, then repeat. Valid units are: seconds, minutes, hours, days, weeks.  Seconds
              are the default interval.

       -p, --pidfile
              Creates  a  $HOME/.xstarfish* file containing the pid of the daemon if xstarfish is
              forking into the background.0

       --display DISPLAY
              Name of the target display.

       -g, --geometry W[xH]
              Size of desired image. If you omit  the  height,  a  square  pattern  WxW  will  be
              generated.

       -o, --outfile FILE
              Specify  an  output  file.  If you use this option, xstarfish will write a png file
              instead of setting the X11 desktop.

       -z, --zoom X[xY]
              Zoom factor of image.  If you omit the y-scale, a  uniform  zoom  of  XxX  will  be
              applied.

       -s, --size SIZE
              An  approximate  size  in  English.  Valid size arguments are small, medium, large,
              full, and random. Full size creates patterns  the  exact  size  of  your  display's
              default  monitor.  Small,  medium,  and  large  are  randomly  sizes at appropriate
              fractions of the default monitor size. Random can be any size from 64x64 up to  the
              whole monitor. Size always overrides geometry.

       -r, --random SEED
              Seed for rand() call - for debugging purposes.

NOTES

       The default size is 256x256.

AUTHOR

       Mars Saxman <mars@redplanetsw.com>

                                                                                     XSTARFISH(1)