xscreensaver-getimage-file - put a randomly-selected image on the root window


xscreensaver-getimage-file [-display host:display.screen] [--verbose] [--name] directory


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.


xscreensaver-getimage-file accepts the following options:
 Print diagnostics.
 Don’t load an image: instead just print the file name to stdout.
 The directory to search. The directory will be searched recursively, and all files in it are assumed to be images.


X(1), xscreensaver(1), xscreensaver-demo(1), xscreensaver-getimage(1), xv(1), xli(1), xloadimage(1), chbg(1)


Copyright © 2001 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 <>, 14-Apr-01

openSUSE Logo