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

NAME

6       xscreensaver-getimage-file  -  select  a  random  image file for use by
7       screen savers
8

SYNOPSIS

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

DESCRIPTION

14       The  xscreensaver-getimage-file  program  is  a  helper program for the
15       xscreensaver hacks that manipulate images.  It is invoked  by  xscreen‐
16       saver-getimage(6x) as needed.
17
18       It prints the name of a randomly-selected image file.  The directory is
19       searched recursively.  Non-image files and images smaller than  500x500
20       are excluded.
21
22       The directory may also be the URL of an RSS/Atom feed.  Enclosed images
23       will be downloaded and cached locally.
24
25       The contents of the directory are cached, for performance.   The  cache
26       is re-generated if 3 hours have passed.
27
28

OPTIONS

30       xscreensaver-getimage-file accepts the following options:
31
32       --verbose
33           Print diagnostics.
34
35       --no-cache
36           Ignore the cache when searching for images.  This may be slow.
37
38       --flush-caches
39           Discard  all  caches  immediately.   They  will  be re-generated as
40           needed.
41
42       directory-or-URL
43           If a pathname it is the directory tree whose images should be used.
44
45           If a URL is specified, it should be the URL of an RSS or Atom  feed
46           containing  images.   The first time it is accessed, all of the im‐
47           ages in the feed will be downloaded to  a  local  cache  directory.
48           The URL will be polled again when the cache times out.  Any new im‐
49           ages will be downloaded and cached, and any images no longer in the
50           feed will be discarded.
51

SEE ALSO

53       X(1),  xscreensaver(1),  xscreensaver-settings(1),  xscreensaver-getim‐
54       age(6x)
55

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

AUTHOR

66       Jamie Zawinski <jwz@jwz.org>, 14-Apr-2001.
67
68
69
70X Version 11               6.02-4.fc35 (09-Nov-20x2s1c)reensaver-getimage-file(6x)
Impressum