xscreensaver-getimage-file6
Select a random image file for use by screen savers
Usage
xscreensaver-getimage-file [--verbose]
[--no-cache]
[--flush-caches]
directory-or-URL
Overview
The xscreensaver-getimage-file program is a helper program for the xscreensaver hacks that manipulate images. It is invoked by xscreensaver-getimage(6) 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/