xscreensaver-getimage-file1

Usage

Overview

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-cache

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

directory-or-URL

If it is a pathname, it will be searched recursively for images.

If it is a URL, it should be an RSS or Atom feed, or an HTML page whose metadata links to its feed. All of the feed's images will be downloaded to a local cache. The URL will be re-polled periodically, downloading any new images and removing expired ones.

Files

Depending on your operating system, the filename cache will be one of:

        $HOME/.cache/xscreensaver/xscreensaver-getimage.cache
        $HOME/tmp/.xscreensaver-getimage.cache
        $HOME/.xscreensaver-getimage.cache
        $HOME/Library/Caches/org.jwz.xscreensaver.getimage.cache

Images from feeds will be downloaded and cached at one of:

        $HOME/.cache/xscreensaver/SUBDIR/
        $HOME/tmp/.xscreensaver-feeds/SUBDIR/
        $HOME/.xscreensaver-feeds/SUBDIR/
        $HOME/Library/Caches/org.jwz.xscreensaver.feeds/SUBDIR/