NAME

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

SYNOPSIS

       xscreensaver-getimage-file [-display host:display.screen] [--verbose] [--name] [--no-cache] directory-or-
       URL

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-or-URL
           If  a  directory  is  specified,  it  will be searched recursively for images.  Any images found will
           eligible for display.  For efficiency, the contents of the directory  are  cached  for  a  few  hours
           before it is re-scanned.

           If a URL is specified, it should be the URL of an RSS or Atom feed containing images.  The first time
           it  is  accessed,  all of the images in the feed will be downloaded to a local cache directory.  If a
           few hours have elapsed since last time, the URL will be polled again, and  any  new  images  will  be
           cached, any images no longer in the feed will be expired.

       --no-cache
           Update  the  cache  immediately, even if it is not time yet.  This will re-scan the directory, or re-
           poll the RSS feed.

SEE ALSO

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

COPYRIGHT

       Copyright  ©  2001-2012  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.45 (08-Dec-2020)                  xscreensaver-getimage-file(1)