1xscreensaver-getimage-file(1) XScreenSaver manualxscreensaver-getimage-file(1)
2
3
4

NAME

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

SYNOPSIS

10       xscreensaver-getimage-file [-display  host:display.screen]  [--verbose]
11       [--name] [--no-cache] directory-or-URL
12

DESCRIPTION

14       The  xscreensaver-getimage-file  program  is  a  helper program for the
15       xscreensaver hacks that manipulate images.  Specifically, it is invoked
16       by  xscreensaver-getimage(1)  as needed.  This is not a user-level com‐
17       mand.
18
19       This program selects a random image from disk, and loads it on the root
20       window.   It does this by figuring out which image-loading programs are
21       installed on the system, and invoking the first one it finds.
22

OPTIONS

24       xscreensaver-getimage-file accepts the following options:
25
26       --verbose
27           Print diagnostics.
28
29       --name
30           Don't load an image: instead just print the file name to stdout.
31
32       directory-or-URL
33           If a directory is specified, it will be  searched  recursively  for
34           images.   Any  images  found  will eligible for display.  For effi‐
35           ciency, the contents of the directory are cached for  a  few  hours
36           before it is re-scanned.
37
38           If  a URL is specified, it should be the URL of an RSS or Atom feed
39           containing images.  The first time  it  is  accessed,  all  of  the
40           images  in  the feed will be downloaded to a local cache directory.
41           If a few hours have elapsed since last time, the URL will be polled
42           again,  and  any new images will be cached, any images no longer in
43           the feed will be expired.
44
45       --no-cache
46           Update the cache immediately, even if it is  not  time  yet.   This
47           will re-scan the directory, or re-poll the RSS feed.
48

SEE ALSO

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

54       Copyright © 2001-2012 by Jamie Zawinski.  Permission to use, copy, mod‐
55       ify,  distribute,  and sell this software and its documentation for any
56       purpose is hereby granted without fee, provided that  the  above  copy‐
57       right  notice  appear in all copies and that both that copyright notice
58       and this permission notice appear in supporting documentation.  No rep‐
59       resentations  are  made  about the suitability of this software for any
60       purpose.  It is provided "as is" without express or implied warranty.
61

AUTHOR

63       Jamie Zawinski <jwz@jwz.org>, 14-Apr-01
64
65
66
67X Version 11               5.45-1.fc33 (10-Dec-202x0s)creensaver-getimage-file(1)
Impressum