xscreensaver-getimage-file man page

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 command.

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 efficiency, 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)

Author

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

Referenced By

vidwhacker(6), xscreensaver-getimage(1), xscreensaver-getimage-video(1).

5.36-3.fc26 (21-Oct-2016) X Version 11 XScreenSaver manual