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

X Version 11                                   5.15 (28-Sep-2011)                  xscreensaver-getimage-file(1)