xscreensaver-getimage-file(1) XScreenSaver manualxscreensaver-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] [--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 com-
       mand.

       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 effi-
           ciency, 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 (C) 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  war-
       ranty.

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



X Version 11                  5.30 (11-Sep-2014) xscreensaver-getimage-file(1)
