1webcollage(6x)                XScreenSaver manual               webcollage(6x)
2
3
4

NAME

6       webcollage - a collage of random images from the World Wide Web
7

SYNOPSIS

9       webcollage  [--display  host:display.screen] [--root] [--window-id num‐
10       ber] [--window-id  id]  [--verbose]  [--timeout  secs]  [--delay  secs]
11       [--background  bg]  [--no-output]  [--urls-only]  [--imagemap filename-
12       base] [--size WxH] [--opacity ratio] [--filter command] [--filter2 com‐
13       mand]  [--http-proxy host[:port]] [--dictionary dictionary-file] [--di‐
14       rectory dir] [--fps]
15

DESCRIPTION

17       This screen saver creates collages out of random images from the  World
18       Wide  Web.   It  finds  the images by feeding random words into various
19       search engines, then pulling images (or sections of images) out of  the
20       pages  returned.  One satisfied customer described it as "a nonstop pop
21       culture brainbath".
22
23       You can also see it in action at https://www.jwz.org/webcollage/
24

OPTIONS

26       webcollage accepts the following options:
27
28       --root or --window-id number
29               Draw on the specified window.  Images are placed  on  the  root
30               window using the xscreensaver-getimage(6x) program.
31
32       --verbose or --v
33               Print diagnostics to stderr.  Multiple -v switches increase the
34               amount of output.  -v will print out the URLs  of  the  images,
35               and  where  they  were placed; -vv will print out any warnings,
36               and all URLs being loaded; -vvv will print information on  what
37               URLs were rejected; and so on.
38
39       --timeout seconds
40               How  long  to wait for a URL to complete before giving up on it
41               and moving on to the next one.  Default 30 seconds.
42
43       --delay seconds
44               How long to sleep between images.  Default 2 seconds.   (Remem‐
45               ber that this program probably spends a lot of time waiting for
46               the network.)
47
48       --background color-or-file
49               What to use for the background onto which  images  are  pasted.
50               This  may  be  a color name, a hexadecimal RGB specification in
51               the form '#rrggbb', or the name of an image file.
52
53       --size WxH
54               Normally, the output image will be made to be the size  of  the
55               screen  (or  target window).  This lets you specify the desired
56               size.
57
58       --opacity ratio
59               How transparently to paste the images together, with 0.0  mean‐
60               ing "completely transparent" and 1.0 meaning "opaque."  Default
61               0.85.  A value of around  0.3  will  produce  an  interestingly
62               blurry image after a while.
63
64       --no-output
65               If  this  option  is  specified, then no composite output image
66               will be generated.  This is only useful when used  in  conjunc‐
67               tion with --verbose.
68
69       --urls-only
70               If  this  option  is  specified, then no composite output image
71               will be generated: instead,  a  list  of  image  URLs  will  be
72               printed on stdout.
73
74       --imagemap filename-base
75               If  this  option is specified, then instead of writing an image
76               to the root window, two files will be created: "base.html"  and
77               "base.jpg".   The  JPEG will be the collage; the HTML file will
78               include that image, and a series of clickable rectangles  link‐
79               ing  the  sub-images  to the pages on which they were found, as
80               seen    on    the    web    version    of     WebCollage     at
81               https://www.jwz.org/webcollage/
82
83       --filter command
84               Filter  all  source  images  through this command.  The command
85               must take a PPM file on stdin, and write a new PPM file to std‐
86               out.  One good choice for a filter would be:
87
88                    webcollage -root -filter 'vidwhacker -stdin -stdout'
89
90
91       --filter2 command
92               Filter  the  composite image through this command.  The -filter
93               option applies to the sub-images; the -filter2 applies  to  the
94               final, full-screen image.
95
96       --http-proxy host:port
97               If  you  must go through a proxy to connect to the web, you can
98               specify it  with  this  option,  or  with  the  $http_proxy  or
99               $HTTP_PROXY environment variables.
100
101       --dictionary file
102               Webcollage  normally  looks at the system's default spell-check
103               dictionary to generate words to feed into the  search  engines.
104               You can specify an alternate dictionary with this option.
105
106               Note that by default, webcollage searches for images using sev‐
107               eral different methods, not all  of  which  involve  dictionary
108               words,  so  using  a "topical" dictionary file will not, in it‐
109               self, be as effective as you might be hoping.
110
111       --directory dir
112               Instead of searching the web for images, use  the  contents  of
113               the given directory.
114
115       --fps   Display the current frame rate and CPU load (MacOS only).
116

NOTES FOR FEDORA USER

118       Webcollage  on  Fedora  uses '-directory' option by default, so it does
119       not connect to internet and uses image files on your local disk. If you
120       want webcollage to search for image files on net, use webcollage.origi‐
121       nal .
122

ENVIRONMENT

124       DISPLAY to get the default host and display number.
125
126       XENVIRONMENT
127               to get the name of a resource file that  overrides  the  global
128               resources stored in the RESOURCE_MANAGER property.
129
130       XSCREENSAVER_WINDOW
131               The window ID to use with --root.
132
133       http_proxy or HTTP_PROXY
134               to get the default HTTP proxy host and port.
135

FILES AND URLS

137       /usr/dict/words, /usr/share/lib/dict/words, or /usr/share/dict/words to
138       find the random words to feed into to various search fields,  including
139       Google, Bing, Flickr, Imgur and Tumblr.
140

BOOBIES

142       The Internet being what it is, absolutely anything might show up in the
143       collage including -- quite possibly -- pornography, or even nudity.
144

BUGS

146       Animating GIFs are not supported: only the first frame will be used.
147

SEE ALSO

149       X(1), xscreensaver(1), convert(1), vidwhacker(6x), dadadodo(1),  drift‐
150       net(1), EtherPEG, EtherPeek, https://www.jwz.org/webcollage/
151
153       Copyright © 1998-2022 by Jamie Zawinski.  Permission to use, copy, mod‐
154       ify, distribute, and sell this software and its documentation  for  any
155       purpose  is  hereby  granted without fee, provided that the above copy‐
156       right notice appear in all copies and that both that  copyright  notice
157       and this permission notice appear in supporting documentation.  No rep‐
158       resentations are made about the suitability of this  software  for  any
159       purpose.  It is provided "as is" without express or implied warranty.
160

AUTHOR

162       Jamie Zawinski <jwz@jwz.org>, 24-May-1998.
163
164
165
166X Version 11               6.08-1.fc38 (17-Oct-2023)            webcollage(6x)
Impressum