Your company here — click to reach over 10,000 unique daily visitors

xscreensaver-getimage-file - Man Page

select a random image file for use by screen savers


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


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.


xscreensaver-getimage-file accepts the following options:


Print diagnostics.


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


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


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.


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


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


See Also

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


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

Referenced By


6.09-1.fc41 (11-Jun-2024) X Version 11 XScreenSaver manual