xscreensaver-getimage-file(1)					XScreenSaver manual				     xscreensaver-getimage-file(1)

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  (C)  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)