Penguin
Recent Changes
Blame: webcollage(1)
EditPageHistoryDiffInfoLikePages
Annotated edit history of webcollage(1) version 4, including all changes. View license author blame.
Rev Author # Line
1 perry 1 XScreenSaver
2 !!!XScreenSaver
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 ENVIRONMENT
8 FILES AND URLS
9 BUGS
10 SEE ALSO
11 COPYRIGHT
12 AUTHOR
13 ----
14 !!NAME
15
16
17 webcollage - decorate the screen with random images from the web
18 !!SYNOPSIS
19
20
21 __webcollage__ [[-display ''host:display.screen'']
22 [[-root] [[-verbose] [[-delay ''secs''] [[-timeout
23 ''secs''] [[-background ''bg''] [[-filter
24 ''command''] [[-filter2 ''command''] [[-http-proxy
25 host[[:port]]
26 !!DESCRIPTION
27
28
29 The ''webcollage'' program pulls random image off of the
30 World Wide Web and scatters them on the root window. One
31 satisfied customer described it as
32 ''giftopnm__(1), djpeg(1), and
33 xli(1), xv(1), or xloadimage(1)
34 tools.
35
36
37 ''webcollage'' is written in perl(1) and requires
38 Perl 5.
39 !!OPTIONS
40
41
42 ''webcollage'' accepts the following
43 options:
44
45
46 __-root__
47
48
49 Draw on the root window. This option is manditory: drawing
50 to a window other than the root window is not yet
51 supported.
52
53
54 __-verbose__ or __-v__
55
56
57 Print diagnostics to stderr. Multiple ''-v'' switches
58 increase the amount of output. ''-v'' will print out only
59 the URLs of the images; ''-vv'' will print all the
60 commands being run; and ''-vvv'' will print more than you
61 care about.
62
63
64 __-delay__ ''seconds''
65
66
67 How long to sleep between images. Default 1 second.
68 (Remember that this program probably spends a lot of time
69 waiting for the network.)
70
71
72 __-background__ ''color-or-ppm''
73
74
75 What to use for the background onto which images are pasted.
76 This may be a color name, a hexadecimal RGB specification in
77 the form '#rrggbb', or the name of a PPM file.
78
79
80 __-timeout__ ''seconds''
81
82
83 How long to wait for a URL to complete before giving up on
84 it and moving on to the next one. Default 30
85 seconds.
86
87
88 __-filter__ ''command''
89
90
91 Filter all source images through this command. The command
92 must take a PPM file on stdin, and write a new PPM file to
93 stdout. One good choice for a filter would be:
94
95
96 webcollage -root -filter 'vidwhacker -stdin -stdout'
97
98
99 __-filter2__ ''command''
100
101
102 Filter the ''composite'' image through this command. The
103 ''-filter'' option applies to the sub-images; the
104 ''-filter2'' applies to the final, full-screen
105 image.
106
107
108 __-http-proxy__ ''host:port''
109
110
111 If you must go through a proxy to connect to the web, you
112 can specify it with this option, or with the
113 __$http_proxy__ or __$HTTP_PROXY__ environment
114 variables.
115 !!ENVIRONMENT
116
117
118 __DISPLAY__
119
120
121 to get the default host and display number.
122
123
124 __XENVIRONMENT__
125
126
127 to get the name of a resource file that overrides the global
128 resources stored in the RESOURCE_MANAGER
129 property.
130
131
132 __http_proxy__ or __HTTP_PROXY__
133
134
135 to get the default HTTP proxy host and port.
136 !!FILES AND URLS
137
138
139 ''/usr/dict/words'' or ''/usr/share/lib/dict/words''
140 or ''/usr/share/dict/words''
141
142
143 To find the random words to feed to search
144 engines.
145
146
147 ''http://random.yahoo.com/bin/ryl,
148 http://image.altavista.com/'' To find random web
149 pages.
150 !!BUGS
151
152
153 When drawing on the root window, it always uses the default
154 colormap. This is actually a limitation of xv. But
155 regardless, when using this program with xscreensaver, it
156 must be given the __default-n__ visual specification (see
157 the xscreensaver(1) manual for more
158 details.)
159
160
161 Only the GIF and JPEG image formats are
162 supported.
163
164
165 Transparent and animating GIFs are not
166 supported.
167
168
169 It's slow.
170
171
172 Too many of the images that it finds are text, not pictures.
173 This is because most of the web is pictures of text. Which
174 is pretty sad.
175 !!SEE ALSO
176
177
4 perry 178 X(1), xscreensaver(1), xli(1),
1 perry 179 xv(1), xloadimage(1), ppmmake(1),
180 giftopnm(1), pnmpaste(1), pnmscale(1),
181 djpeg(1), cjpeg(1), xdpyinfo(1),
182 perl(1), vidwhacker(1),
183 dadadodo(1)
184 !!COPYRIGHT
185
186
187 Copyright 1998, 1999 by Jamie Zawinski. Permission to use,
188 copy, modify, distribute, and sell this software and its
189 documentation for any purpose is hereby granted without fee,
190 provided that the above copyright notice appear in all
191 copies and that both that copyright notice and this
192 permission notice appear in supporting documentation. No
193 representations are made about the suitability of this
194 software for any purpose. It is provided
195 !!AUTHOR
196
197
198 Jamie Zawinski
199 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.