NAME

       xscreensaver-getimage-file - put a randomly-selected image on the root window

SYNOPSIS

       xscreensaver-getimage-file [-display host:display.screen] [--verbose] [--name] directory

DESCRIPTION

       The xscreensaver-getimage-file program is a helper program for the xscreensaver hacks that
       manipulate images.  Specifically, it is invoked  by  xscreensaver-getimage(1)  as  needed.
       This is not a user-level command.

       This  program  selects a random image from disk, and loads it on the root window.  It does
       this by figuring out which  image-loading  programs  are  installed  on  the  system,  and
       invoking the first one it finds.

OPTIONS

       xscreensaver-getimage-file accepts the following options:

       --verbose
           Print diagnostics.

       --name
           Don't load an image: instead just print the file name to stdout.

       directory
           The  directory  to search.   The directory will be searched recursively, and all files
           in it are assumed to be images.

SEE ALSO

       X(1),  xscreensaver(1),  xscreensaver-demo(1),  xscreensaver-getimage(1),  xv(1),  xli(1),
       xloadimage(1), chbg(1)

COPYRIGHT

       Copyright © 2001 by Jamie Zawinski.  Permission to use, copy, modify, distribute, and sell
       this software and its documentation  for  any  purpose  is  hereby  granted  without  fee,
       provided that the above copyright notice appear in all copies and that both that copyright
       notice and this permission notice appear in supporting documentation.  No  representations
       are  made  about the suitability of this software for any purpose.  It is provided "as is"
       without express or implied warranty.

AUTHOR

       Jamie Zawinski <jwz@jwz.org>, 14-Apr-01