xscreensaver-getimage - put some randomly-selected image on the root window
program is a helper program for the
xscreensaver hacks that manipulate images. This is not a user-level command.
This program selects a random image, and puts it on the specified window or
pixmap. This image might be a snapshot of the desktop; or a frame captured
from the system's video input; or a randomly-selected image from disk.
If only a window ID is specified, the image will be painted there. If both a
window ID and a pixmap ID are specified, then the image will be painted on the
pixmap; and the window may
be modified as a side-effect.
reads the ~/.xscreensaver
configuration information. It uses these settings:
- Whether it is acceptable to grab snapshots of the desktop.
The security paranoid might want to turn this off, to avoid letting people
see (but not touch!) your desktop while the screen is locked.
- Whether it is acceptable to grab frames of video from the
system's video input. Grabbing of video is done by invoking the
- Whether it is acceptable to display random images found on
disk. Selection and loading of images is done by invoking the
- When loading images from disk, this is the directory to
find them in. The directory will be searched recursively for images.
It may also be the URL of an RSS or Atom feed, in which case a random image
from that feed will be selected instead. The contents of the feed will be
cached locally and refreshed periodically as needed.
If none of the three options are set to True, then video colorbars will be
When grabbing desktop images, the window
argument will be unmapped and
have its contents modified, causing flicker. (This does not happen when
loading image files or video frames.)
, xscreensaver(1) xscreensaver-demo(1)
Copyright © 2001-2011 by Jamie Zawinski. Permission to use, copy, modify,
distribute, and sell this software and its documentation for any purpose is
hereby granted without fee, provided that the above copyright notice appear in
all copies and that both that copyright notice and this permission notice
appear in supporting documentation. No representations are made about the
suitability of this software for any purpose. It is provided "as is"
without express or implied warranty.
Jamie Zawinski <firstname.lastname@example.org>, 14-Apr-01