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-cache
39           Discard  all  caches  immediately.   They  will  be re-generated as
40           needed.
41
42       directory-or-URL
43           If it is a pathname, it will be searched recursively for images.
44
45           If it is a URL, it should be an RSS or Atom feed, or an  HTML  page
46           whose metadata links to its feed.  All of the feed's images will be
47           downloaded to a local cache.  The URL will  be  re-polled  periodi‐
48           cally, downloading any new images and removing expired ones.
49

FILES

51       Depending on your operating system, the filename cache will be one of:
52
53               $HOME/.cache/xscreensaver/xscreensaver-getimage.cache
54               $HOME/tmp/.xscreensaver-getimage.cache
55               $HOME/.xscreensaver-getimage.cache
56               $HOME/Library/Caches/org.jwz.xscreensaver.getimage.cache
57
58       Images from feeds will be downloaded and cached at one of:
59
60               $HOME/.cache/xscreensaver/SUBDIR/
61               $HOME/tmp/.xscreensaver-feeds/SUBDIR/
62               $HOME/.xscreensaver-feeds/SUBDIR/
63               $HOME/Library/Caches/org.jwz.xscreensaver.feeds/SUBDIR/
64

SEE ALSO

66       X(1),  xscreensaver(1),  xscreensaver-settings(1),  xscreensaver-getim‐
67       age(6x)
68

70       Copyright © 2001-2022 by Jamie Zawinski.  Permission to use, copy, mod‐
71       ify,  distribute,  and sell this software and its documentation for any
72       purpose is hereby granted without fee, provided that  the  above  copy‐
73       right  notice  appear in all copies and that both that copyright notice
74       and this permission notice appear in supporting documentation.  No rep‐
75       resentations  are  made  about the suitability of this software for any
76       purpose.  It is provided "as is" without express or implied warranty.
77

AUTHOR

79       Jamie Zawinski <jwz@jwz.org>, 14-Apr-2001.
80
81
82
83X Version 11               6.04-1.fc36 (06-Jun-20x2s2c)reensaver-getimage-file(6x)
Impressum