xscreensaver-getimage-file - Man Page

select a random image file for use by screen savers

Synopsis

xscreensaver-getimage-file [--verbose] [--no-cache] [--flush-caches] directory-or-URL

Description

The xscreensaver-getimage-file program is a helper program for the xscreensaver hacks that manipulate images.  It is invoked by xscreensaver-getimage(6x) as needed.

It prints the name of a randomly-selected image file.  The directory is searched recursively.  Non-image files and images smaller than 500x500 are excluded.

The directory may also be the URL of an RSS/Atom feed.  Enclosed images will be downloaded and cached locally.

The contents of the directory are cached, for performance.  The cache is re-generated if 3 hours have passed.

Options

xscreensaver-getimage-file accepts the following options:

--verbose

Print diagnostics.

--no-cache

Ignore the cache when searching for images.  This may be slow.

--flush-caches

Discard all caches immediately.  They will be re-generated as needed.

directory-or-URL

If a pathname it is the directory tree whose images should be used.

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.  The URL will be polled again when the cache times out.  Any new images will be downloaded and cached, and any images no longer in the feed will be discarded.

See Also

X(1), xscreensaver(1), xscreensaver-settings(1), xscreensaver-getimage(6x)

Author

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

Referenced By

xscreensaver-settings(1).

6.02-4.fc36 (04-Nov-2021) X Version 11 XScreenSaver manual