4 a screen saver and locker for the X window system
7 http://www.jwz.org/xscreensaver/
15 The `configure' shell script will attempt to figure out which options are
16 appropriate for your system, and will create config.h and the various
17 Makefiles for you. Run `configure --help' to see how to override these
18 choices, or to specify things like the default installation directory.
19 The file `INSTALL' gives a general overview of use of these sorts of
20 configure scripts (those generated by the GNU autoconf system.)
21 The most important hint is probably this:
23 ./configure --with-motif=/opt/Motif --with-xpm=/usr/local
25 To build on VMS, see README.VMS.
27 If you think you've found a bug, please let me know! No bug report is too
28 small. But first, please read the enclosed `README.debugging' file to find
29 out what kind of information would be most helpful to include in your bug
34 You can try out xscreensaver like so:
39 The XScreenSaver suite of applications uses a client-server model:
40 The `xscreensaver' program is a daemon that runs in the background;
41 it is controlled by the foreground `xscreensaver-demo' program.
43 xscreensaver has an extensive manual -- please read it!
47 The xscreensaver daemon waits until the keyboard and mouse have been idle
48 for a period, and then runs a graphics demo chosen at random. The demo is
49 terminated as soon as there is any mouse or keyboard activity (or, in
50 locking mode, when the proper password is typed.)
52 It is trivially easy to add new display modes to xscreensaver: any program
53 which can be invoked in such a way that it draws on the root window of the
54 screen can be used as a screensaver. You just change a config file --
55 there's no need to recompile or reinstall anything.
59 Along with the xscreensaver daemon itself, this package also includes
60 numerous graphics hacks for use as screensavers. There is nothing
61 magic about these: they are just programs that draw on the root window.
62 More than 150 such programs are included. For details, see the
63 xscreensaver web page, or the enclosed manual pages.
65 The latest version of xscreensaver is always available on the web at
66 http://www.jwz.org/xscreensaver/.
68 Looking for tips on writing your own screensavers? There is an entry in
69 the XScreenSaver FAQ about that: http://www.jwz.org/xscreensaver/faq.html
73 Changes since 4.06: * New hacks, `flurry', `metaballs', `eruption',
74 `popsquares', and `barcode'.
75 * Minor updates to `maze' for high density mazes.
76 * Added double buffering to `fluidballs' and `whirlygig'.
77 * Bug fixes for running xscreensaver to a remote XFree86
78 display (which nobody would ever do...)
79 * Updated `webcollage' (faster Alta Vista searching.)
80 * Updated `glplanet' so the sun sets in the west.
81 * Updated `sproingies' with smooth, unsegmented surfaces.
82 * Fixed Perl version-sensitivity in
83 `xscreensaver-getimage-file'.
84 * Fixed GTK2 scrolling bug in `xscreensaver-demo'.
85 Changes since 4.05: * New hack, `glblur' (disabled by default, since it
86 requires fast OpenGL texture support.)
87 * New hack, `halftone'.
88 * Updates to `endgame', `queens', `bumps', `glplanet',
89 `engine', and `circuit'.
90 * New version of `menger' that uses far fewer polygons.
91 * Fixed minor bug in `critical' that could cause some
92 bogus X servers to crash.
93 * Better labels in `molecule': the labels now appear to
94 be attached to the atoms, instead of floating in front
96 * Fixed bug that could rarely cause GL hacks to fail to
97 double-buffer (causing intermittent flickering.)
98 * Fixed a relative-URL-parsing bug in `webcollage'.
99 * Fixed a bug that (sometimes) caused the window manager
100 close box to kill `xscreensaver-demo' with a crash
101 instead of a graceful exit.
102 * Updated xscreensaver.pam to the Red Hat 7.3 way.
103 * More Gnome2-related configure crap.
104 * Updated to latest `config.guess' and `config.sub'.
105 * Fixed occasional core dump in `distort'.
106 * Added a Linux fsck failure and kernel panic to `bsod'.
107 * Added MacOS X kernel panic to `bsod'.
108 * Fixed a bug in `bsod' (all bsod bugs are ironic.)
109 * Fixed a bug that caused `xscreensaver-gl-helper' to
110 print a nonsense visual ID with some versions of
111 `printf': this could cause GL programs to display
112 incorrectly (e.g., flickery.)
113 Changes since 4.04: * More `configure' tweaks to try and get things working
114 on systems that both Gtk 1.x and 2.x installed.
115 * New hack, `endgame'.
116 * Minor updates to `gltext'.
117 Changes since 4.03: * Support for GTK 2.x / GNOME 2.x.
118 * The `configure' script will now use `pkg-config' if
119 you have it, in preference to `gtk-config', etc.
120 * New hacks, `lavalite', `queens', and `anemone'.
121 * Minor updates to `spheremonics', `gltext', `xmatrix'.
122 * You can use the mouse to manually spin most of the GL
123 hacks now (when they are displaying in a window.)
124 * Fixed a bug in `webcollage' (due to recent Alta Vista
125 url changes) that was causing it to try and load
126 incorrect image URLs.
127 * Made `xscreensaver-getimage' use gdk_pixbuf if it is
128 available: this means that those hacks that load images
129 will no longer rely on "xv", "xloadimage", etc. This
130 will close a race condition that could sometimes cause
131 your desktop background to be changed; and also makes
132 it possible for those programs to operate on image
133 files when running in windowed mode.
134 * `webcollage' can now be used in conjunction with
135 `driftnet' to display images snooped from your local
136 ethernet instead of obtained from search engines.
137 * Added man pages for all the hacks that didn't have
139 Changes since 4.02: * New hack, `spheremonics'.
140 * Minor updates to `webcollage', `cage', `moebius',
141 `morph3d', `boxed', `circuit', and `helix'.
142 * `pulsar' and `extrusion' can now load texture JPEGs.
143 * `rubik' now does non-square cubes.
144 * `fluidballs' now does various sizes of balls.
145 * `menger' and `sierpinski3d' now also show polygon
147 * `molecule' displays real subscripts in the formulae.
148 * GTK internationalization/localization support.
149 * Better detection of the various versions of libxml.
150 * Upgraded to autoconf 2.53 (from 2.13.)
151 Changes since 4.01: * Plugged a few minor leaks in `xscreensaver' and
153 * New hacks, `cubenetic' and `fluidballs'.
155 * Fixed sphere projection error in `glplanet'; installed
156 a better image of earth.
157 * Added Win2K and MacOS 1 crashes to `bsod'.
158 * Put back previous (better) version of `forest' that
159 was accidentially downgraded in the last release.
160 * New version of `bumps'.
161 * Made FPS computation in GL hacks more efficient: it
162 will influence the results less, thus resulting in
163 higher (but more accurate) reported frame rates.
164 Changes since 4.00: * New hacks: `twang', `glsnake', `boxed', `sballs',
166 * New hacks `apollonian', `euler2d', `juggle',
167 `polyominoes' and `thornbird', from xlockmore.
168 * Merged recent xlockmore changes into `ant', `braid',
169 `demon', `discrete', `drift', `fadeplot', `forest',
170 `grav', `hopalong', `ifs', `laser', `lightning',
171 `lisa', `lissie', `loop', `mountain', `penrose',
172 `rotor', `sierpinski', `slip', `sphere', `spiral',
173 `strange', and `vines'.
174 * Fixed the `gltext' bug that sometimes caused
175 horizontal lines to vanish again. This time for sure.
176 * Sped up `webcollage' by adding a C helper program to
177 replace the PPM pipeline. It also pastes images
178 semi-transparently now.
179 * Added support for the gdk_pixbuf library: if this lib
180 is available, then `blitspin', `xflame', and `flag'
181 can load GIF, JPEG, and PNG images in addition to XPM
183 * Fixed a rare race condition where the desktop-grabbing
184 hacks could sometimes leave the screen wedged, if the
185 user moved the mouse exactly when they were grabbing
186 the screen image (it would un-wedge the next time the
187 saver timed out or was activated.)
188 * Fixed incorrect colors in the screen-grabbing GL hacks
189 (`gflux' and `flipscreen3d'.)
190 * Made SIGHUP restart the daemon process (though using
191 `xscreensaver-command -restart' is still the preferred
193 * Tweaks to `xspirograph'.
194 * Minor configure and portability tweaks.
195 Changes since 3.34: * Redesigned `xscreensaver-demo' GUI: it now includes
196 small-preview and per-hack configuration dialogs.
197 * Added three new modes of operation: `One Screen Saver',
198 `Blank Screen', and `Don't Blank' (in addition to the
199 historical `Random Screen Saver').
200 * Configure now defaults to installing the hacks in
201 <prefix>/lib/xscreensaver/ instead of <prefix>/bin/.
202 (Most distros already did it this way.)
203 * New GL hacks, `menger', `engine', `flipscreen3d'.
204 * Made `sierpinski3d' be more colorful.
205 * New versions of `xmatrix' and `nerverot'.
206 * Fixed a bug in `starwars' that made the font be drawn
207 with thin lines in -root mode.
208 * Fixed a bad colormap bug in `crystal' that could make
209 *subsequent* hacks malfunction!
210 * Made `gflux' able to grab screen images (`-mode grab').
211 * Updated `webcollage' for recent search engine changes.
212 * Removed most command-line options to `xscreensaver':
213 just edit the ~/.xscreensaver file instead.
214 * Improved behavior on multi-screen and Xinerama systems:
215 the mouse now stays on the screen where the user left
216 it, and the password and splash dialogs always appear
217 on the screen that has the mouse.
218 * Made the splash dialog use more Gtk-like colors;
219 made it have only two buttons, "Settings" and "Help".
220 * Made `sonar' understand `.ssh/known_hosts2' format
221 files, and be better about stripping out illegal
223 Changes since 3.33: * Turned `memoryLimit' off by default, sigh. Apparently
224 some versions of the GL libraries (appear to) allocate
225 hundreds of megs for every GL program, so `memoryLimit'
226 was causing GL programs to malfunction or crash on
228 * Improved fading on TrueColor XFree86 4.1.x systems.
229 * New GL hack, `circuit'.
230 * Added `fuzz' mode to `decayscreen'.
231 * New version of `whirlygig'.
232 * Added links to `xplanet' and `sphereEversion'.
233 * Fixed rare race condition that could make `sonar' hang.
234 * Fixed potential crash in `speedmine'.
235 * Made `xscreensaver-demo' not crash when imageDirectory
236 was set to a non-existent directory.
237 * Made `xscreensaver-getimage-video' invoke XawTV's
238 `streamer' program better.
239 * Made `phosphor' and `starwars' deal with CR, LF,
240 or CRLF line endings.
241 * Changes for Cygwin compilation environments.
242 * Made `sonar' compile on systems that can't ping.
243 * Configure changes for HPUX 10.20.
244 * Made PAM code work on Red Had 4.2 systems.
245 * Made `xscreensaver-command -deactivate' work when the
246 saver is not active: what that does is reset the idle
247 timer, as if keyboard input had been detected. This
248 was added for the benefit of people writing DVD-playing
249 software: they can now prevent the screensaver from
250 kicking in by sending a -deactivate message once a
251 minute while the movie is playing and not paused.
252 * Various minor portability tweaks.
253 Changes since 3.32: * New hacks, `speedmine' and `whirlygig'.
254 * Sped up `pyro', made the explosions look a bit better.
255 * Added better stars to `glplanet' and `starwars'.
256 * Many internal changes to `webcollage'.
257 * Some new options to `attraction'.
258 * Minor fix to `noseguy' to avoid un-erased pixels.
259 * Rewrote the screen-eraser effects so that they complete
260 in the same amount of time regardless of how slow
261 your X server is (some of them were glacial on servers
263 * Fixed a potential free memory reference that could
264 sometimes cause a crash at startup.
265 * Possibly fixed a problem that could cause the daemon
266 to crash with an X error. I was never able to
267 reproduce this problem, but I think I might have
268 figured out what caused it.
269 * Worked around a problem that caused PAM authentication
270 to fail on some Red Hat 7.x systems.
271 * Added a `memoryLimit' parameter that controls the
272 amount of memory a graphics hack may allocate: if they
273 try to allocate more than this, malloc() will fail
274 (and they will exit or (safely) crash, rather than
275 hogging memory.) Default is 50M.
276 * Made `gnome-help-browser' be the default way to display
277 man pages in `xscreensaver-demo', if running on a
279 Changes since 3.31: * The image-manipulating hacks (`slidescreen', etc.) can
280 now operate on randomly chosen image files from disk,
281 or on frames captured from the system's video input,
282 instead of (or in addition to) manipulating images of
284 * Rewrote `vidwhacker' to use the new image-grabbing
286 * Made fading work on TrueColor XFree86 4.x systems.
287 * Fixed a subtle rendering bug in `atlantis' (the fish
289 * Made `atlantis' have a texture simulating light
290 reflections from the surface of the ocean.
291 * Fixed up label placement in `molecule'.
292 * Better color bars in `xteevee'.
293 * Made `install-strip' not try to strip scripts.
294 Changes since 3.30: * Put in more sensible defaults for DPMS, and updated
295 the documentation to reflect the fact that all your
296 DPMS settings are now belong to xscreensaver.
297 * Fixed the `xscreensaver.spec' file so that `--force'
299 * New versions of `rotzoomer' and `nerverot'.
300 * Fixed an OSF/1 compilation problem in `molecule'.
301 Changes since 3.29: * New hacks, `molecule', `dangerball', and `rotzoomer'.
302 * New version of `gflux'.
303 * Made `gltext' able to display the current time.
304 * Fixed a floating-point-precision problem in `gltext'
305 that sometimes caused horizontal lines to vanish.
306 * Removed the `-window-id' option from the hacks:
307 it never worked right, and was unnecessary.
308 * Made the `starwars' hack use thicker lines, antialias
309 the text, and fade out at the far edge instead of just
311 * Fixed an SHM segment leak in `moire'.
312 Changes since 3.28: * Better rendering of the new logo.
313 * New hack, `gltext'.
314 * Added `-planetary' option to `gears', to draw a
315 different kind of gear system.
316 * Made motion and rotation be smoother in `gears',
317 `glplanet', `moebius', `rubik', and `sierpinski3d'.
318 * Improved coloration in `sierpinski3d'.
319 * Made the GL hacks react to window size changes.
320 * Made most of the GL hacks take a -fps option (like
321 `pulsar' did), so you can use them to benchmark your
323 * Fixed the previous fix to `sonar'.
324 * Minor fix to `nerverot'.
325 Made sonar able to ping hosts on DEC OSF1.
326 * Eliminated a bogus "didn't get enough colors" warning
327 in some of the hacks.
328 Changes since 3.27: * New logo for xscreensaver!
329 * New hacks, `starwars' and `stonerview'.
330 * Made the motion of the bouncing ball in `stairs' be a
332 * Made newly-added screenhacks be added to .xscreensaver
333 automatically: if there are hacks in the app-defaults
334 file that are not also in ~/.xscreensaver, they will
335 be added to the end of the list.
336 * Redid the `Screensaver Options' part of the control
337 panel; xscreensaver now lets you configure your DPMS
339 * Fixed some Makefile problems with non-GL builds.
340 * Fixed detection of MesaGL for version 3.3.
341 * Better workaround to Red Hat 7.0's broken gcc.
342 * Added Sparc Solaris kernel panic to `bsod'.
343 Changes since 3.26: * New hacks: `zoom' and `whirlwindwarp'.
344 * Fixed a free-memory-reference bug in `sonar'.
345 * Better error handling when there are no suitable GL
347 * Added diagnostic dialog when xscreensaver-demo is
348 unable to launch xscreensaver (e.g., when running as
350 * Fixed a bug that caused screenhack argument changes
351 to be ignored when xscreensaver-demo was running as
352 root (if "root" and "nobody" have different home
354 * Made the programs default to ":0" if $DISPLAY is unset.
355 * Made the `-verbose' output include information about
356 which server extensions were supported at compile time.
357 * Worked around Red Hat 7.0's broken gcc 2.96.
358 * Updated default delays on the GL hacks to look better
359 on machines with super-fast 3D hardware.
360 * Install `screensaver-properties-capplet' to work around
361 the usual egregious GNOME lossage.
362 Changes since 3.25: * Added "enabled" checkboxes in the list of hacks in
363 xscreensaver-demo (Gtk version only.)
364 * New hacks `hyperball', `xrayswarm', and `gflux'.
365 * New versions of `nerverot', `galaxy', and `hypercube'.
366 * Small fixes to `phosphor', `shadebobs', `xflame',
368 * Added external helper program `xscreensaver-gl-helper'
369 to figure out which X visual to use for OpenGL
371 * Configure updates for XFree86 4.0, and for BSD.
372 * Made it be more tolerant of bogus /etc/group files.
373 * When installing the PAM config file, first try to just
374 copy an existing "xdm" or "login" config file, so that
375 xscreensaver does authentication in the same way as the
377 Changes since 3.24: * New hack, `nerverot'.
378 * Added BSD kernel panic to `bsod'.
379 * New version of `shadebobs'.
380 * New version of `petri'.
381 * Updated `webcollage' to handle recent Altavista URL
382 format changes; made it search the AP photo gallery.
383 * Revamped command-line options of `sonar' and made it
384 properly handle subnets.
385 * The `bubbles' hack can now trickle up or down the
387 * The `xsublim' hack can now read its text from programs.
388 * Support for GLE version 3 in `extrusion'.
389 * Fixed compilation problems in `maze'.
390 * Fixed a rare crash in `flow'.
391 * Fixes for minor installation problems.
392 Changes since 3.23: * Added `-ignorant' option to `maze' hack.
393 * Updates to `critical', `bsod', `xflame', and `flow'.
394 * Added support for Kerberos 5 (via its Kerberos 4
395 compatibility layer.)
396 * Fixed a bad leak in `xteevee'.
397 * Updated `webcollage' to handle recent Altavista URL
399 * Removed xscreensaver-demo's `Ok' and `Cancel' buttons,
400 since they were confusing people: all changes are now
402 * Made xscreensaver-demo install itself into the Gnome
404 Changes since 3.22: * Fixed some misplaced text fields in the Motif version
405 of xscreensaver-demo; fixed a crash in the Gtk version
406 that would happen if the programs list was empty.
407 * Fixed a recently-introduced bug in `pulsar'.
408 * Made `sierpinski3d' use solid tetrahedrons instead of
410 * Added `-trace' option to `xmatrix'.
411 * Added new hacks `xteevee' and `xspirograph'.
412 Changes since 3.21: * Fixed some bugs in xscreensaver-demo.
413 * Rewrote the Motif version of xscreensaver-demo to
414 match the new Gtk version.
415 * The Athena toolkit is no longer supported.
416 Changes since 3.20: * Tweaked the xscreensaver-demo UI (Gtk only.)
417 * Fixed a few visual selection bugs. I think the proper
418 GL visual should be used with nVidia systems now.
419 * Made the Makefiles obey $install_prefix.
420 * Made the `xscreensaver.spec' file able to generate both
421 GL and non-GL packages simultaneously.
422 Changes since 3.19: * Added new hacks `ripples' and `sierpinski3d'.
423 * Made `xscreensaver-command -exit' be silent when no
424 screen saver was running (instead of complaining.)
425 * Made `webcollage' and `vidwhacker' use `xloadimage'
426 when available (in addition to `xli' and `xv'.)
427 * Improved memory usage in `petri' and gave it a hard
428 cap on how much memory it can allocate.
429 * Added `-watch' option to `xscreensaver-command'.
430 * Made `xscreensaver-demo' come up with the
431 most-recently-run hack selected by default.
432 * Rewrote the Gtk version of `xscreensaver-demo'.
433 It's a lot easier to use now.
434 * Extended the format of the programs list in the
435 .xscreensaver file, for the benefit of the new
436 capabilities of `xscreensaver-demo'.
437 NOTE: you might want to delete your ~/.xscreensaver
438 file and allow it to be re-created! The old one
439 should still work, but xscreensaver-demo won't be as
441 Changes since 3.18: * Fixed gcc dependencies in `bumps' and `ccurve'.
442 * New hack, `extrusion'.
443 * Some of the web sites that `webcollage' was using as
444 its sources changed formats; tweaked it to understand
446 * Added typeahead in the password dialog: if the screen
447 is locked, and you unlock it by typing a character,
448 that key will be automatically inserted in the
449 password dialog (unless it is Return, Enter, Space,
450 or a non-printing key like Shift.)
451 * Made `xmatrix' take a `-small' option, since some
452 folks with tiny screens prefer a smaller font.
453 Changes since 3.17: * New versions of `shadebobs', `lmorph', and `distort'.
454 * Added `ccurve', `blaster', and `bumps' hacks.
455 * Replaced `forest' hack with a rewritten version.
456 * Worked around a Xinerama server bug.
457 * Fixed a bug I introduced in 3.10 that caused some
458 hacks to print out superfluous warnings about not
459 having gotten enough colors.
460 * Made `sproingies' obey the `-delay' option.
461 * Fixed a portability bug in `shadebobs'.
462 * Made `webcollage' and `vidwhacker' use `xli' in
463 preference to `xv', if it is available.
464 * Added a new source of images to `webcollage'.
465 * If running under KDE, xscreensaver will add itself to
466 KDE's list of screensavers (via xscreensaver.kss.)
467 * Improved detection of GL libraries.
468 * Made the password dialog include the date and time.
469 Changes since 3.16: * New version of `webcollage' -- deals better with
470 corrupted images, and can use an http proxy.
471 * New hack, `xsublim' (run it in the background,
472 rather than adding it to the programs list.)
473 * The xscreensaver daemon was leaking a file descriptor
474 each time you edited your .xscreensaver file. Fixed.
475 Changes since 3.15: * New version of `shadebobs'.
476 * Improved image selection in `webcollage', and sped it
478 * Made configure find the right version of perl.
479 * Rewrote the CGI part of `webcollage'.
480 * `make clean' was deleting some things it shouldn't.
481 * Fixed a typo in the default programs list.
482 Changes since 3.14: * Added `webcollage' and `shadebobs' hacks.
483 * Added a `-stdout' arg to `vidwhacker' so that it can
484 be used in a pipeline.
485 * Made `petri' use less memory.
486 Changes since 3.13: * Various improvements to the Gtk port.
487 * Turned off PAM by default on Solaris, since PAM seems
488 generally to be misconfigured out-of-the-box.
489 * Made the `--without-gtk' configure option work.
490 * Made configure check the Gtk version number, since it
492 * Fixed a bug in the code that attempted to prevent
493 changes of screen resolution while the screen is
495 * Fixed a race condition in `xscreensaver-demo' that
496 could cause an X error at startup.
497 * Added `-transparent' option to `deluxe'.
498 * Added `petri' hack.
499 Changes since 3.12: * Ported `xscreensaver-demo' to Gtk.
500 * Made it possible to build Motif, Gtk, and Athena
501 versions of `xscreensaver-demo' in the same directory
502 without reconfiguring.
503 * Made `xscreensaver-demo' chase symlinks before writing
504 the .xscreensaver file, so that if .xscreensaver is
505 itself a symlink, the underlying file will be replaced
507 * Some Makefile and configure tweaks for Solaris and
509 * Made it possible to set the fire color in `xflame'.
510 * Made transparency work in TrueColor (for `goop' and
512 * Fixed a multi-head bug introduced by the virtual
514 Changes since 3.11: * Made it so that you can't scroll the screen while the
515 lock dialog is up (with XFree86 virtual viewports.)
516 * Fixed a bug in `flag' that caused bob's chin to get cut
517 off after a few iterations.
518 Changes since 3.10: * Made `xjack' be black-on-white-ish, so that it looks
519 less like a computer screen and more like the
520 typewritten paper it's supposed to be.
521 * New version of `pulsar'.
522 * Fixed Solaris compilation problem in `phosphor'.
523 * Made xscreensaver notice XFree86's virtual root window
524 hack, so that if the X server's root window is larger
525 than the monitor's displayable resolution, the screen
526 saver will limit itself to the area that actually
527 appears on the screen.
528 * Made the xscreensaver daemon do a better job of
529 picking the visual class that should be used for GL
530 programs. Less user intervention should be needed
531 now: you can use the logical visual name `GL' instead
532 of having to figure out by hand which one to use.
533 * Oops, the visual was defaulting to "best" instead of
534 "default", because the .xscreensaver file was not being
535 loaded quite early enough.
536 * Made configure figure out how to build icmp ping
537 support into the `sonar' hack automatically.
538 * Made warnings about not being able to read shadow
539 passwords not be printed if compiled with PAM support.
540 * Improved PAM startup diagnostics.
541 * Worked around the Solaris PAM bug that was causing
542 crashes there, so now PAM is turned on by default.
543 * Made configure detect the number of arguments that
544 pam_strerror() takes, since on Linux, this apparently
545 changed between 2.0 and 2.2, sigh.
546 * Made the /proc/interrupts kludge look for "PS/2 Mouse"
547 as well as "keyboard".
548 * Made xscreensaver notice when there has been a sudden
549 large jump in wall-clock time, and if so, lock right
550 away, instead of waiting for "lockTimeout" to expire
551 first. (Laptops need this for safer recovery from
553 * Added `-throttle' option to `xscreensaver-command'.
554 Changes since 3.09: * Added `phosphor', `xmatrix', and `pulsar' hacks.
555 * Fixed a bug in the color allocator that sometimes
556 caused `starfish' to fall back to monochrome.
557 * Reduced the amount of code that runs before root
558 privileges are disavowed: "normal" and "shadow"
559 passwords now do some initialization as root, but the
560 PAM and Kerberos authorization schemes will be
561 initialized while running as "nobody". Supposedly
562 this closes a potential security hole when using
564 * Added some more sanity checking to configure.
565 Changes since 3.08: * Added `compass', `squiral', `xflame', `wander',
566 `spotlight', and `critical' hacks.
567 * Added some new modes to `decayscreen'.
568 * Made `deluxe' work in monochrome.
569 * Generalized usage of the Double-Buffer server extension
570 in several hacks (`compass', `deluxe', `interference',
571 `kumppa', and `moire2'.)
572 * Fixed another visual-depth problem in `rd-bomb'.
573 * The screen saver will now defer blanking if neither
574 the keyboard nor the mouse could be grabbed. Instead,
575 it will just try again in a few minutes. This fixes
576 a bad interaction between xscreensaver and programs
577 like VMware that hold the mouse and keyboard grabbed
579 * Added a new erase mode (expanding spiral.)
580 Changes since 3.07: * Fixed some bugs in my port of `t3d'.
581 * Added `penetrate' and `deluxe' hacks.
582 * When linking against Motif 2.x, also link against XPM.
583 * Added support for using /proc/interrupts for idle
584 detection on Linux. Now xscreensaver shouldn't kick
585 in when the user is active on a non-X virtual console.
586 * Upgraded to autoconf 2.13.
587 Changes since 3.06: * Configure tweaks (sometimes -lXmu wasn't getting linked
588 in properly; check for _Xsetlocale in -lXintl.)
589 * Portability fixes for sonar.c.
590 * Fixed a compilation problem when you have GL but don't
592 * Made configure notice when MesaGL requires -lpthread.
593 * Made `flame' ignore SIGFPE (not sure if this is the
594 right fix; it seems only to be needed on FreeBSD.)
595 * Kludged `rd-bomb' work on visuals that are of depth 24
596 but that *do not* support pixmaps of depth 32.
597 * Fixed `halo' to work properly in TrueColor.
598 * Changed `xscreensaver.spec' to install the hacks in
599 /usr/X11R6/lib/xscreensaver/ by default, since that's
600 where recent Red Hat distributions put them.
602 * Updated versions of `crystal', `hopalong', and `flow'
604 * Imported `demon' and `loop' modes from xlockmore.
605 Changes since 3.05: * Oops, the "default-n" visual descriptor was broken;
606 it was always installing a colormap if the
607 `installColormap' preference was set, meaning that
608 `xearth', `xv' and friends were using the wrong
609 colors on 8-bit systems.
610 * Turned off HAVE_PING in `sonar', since it compiles
611 on some Linux systems, but not others of similar
613 Changes since 3.04: * Fixed an off-by-1 in `distort'.
614 * Added `sonar' hack.
615 * New version of `glplanet' (with stars.)
616 * Made all hacks exit when you type `q' or `ESC' at them,
617 and made them obey the WM_DELETE_WINDOW ClientMessage.
618 * Fixed a nonfatal buffer overrun in lament (note:
619 lament still doesn't work with MesaGL 3.0: it dies in
620 lambda_textured_triangle1(), which is Mesa's bug, not
622 Changes since 3.03: * Added an `xscreensaver.spec' file, to make it easier
623 for other folks to generate RPMs.
624 * Made the password code work on HPUX in the situation
625 where: ``enhanced security'' is available; but not
626 used; but the user typed a password more than 8
627 characters long anyway. FTSOHPUX.
628 Changes since 3.02: * Made locking work when passwd aging is enabled.
629 * Added support for PAM (Pluggable Authentication
630 Modules.) It is still turned off by default, though,
631 since it doesn't seem to work on Solaris 2.6, and has
632 been behaving erratically on Red Hat 5.1.
633 * Made each possible authentication method be tried in
634 turn until one succeeds; this means that Kerberos is
635 being used, we will first check Kerberos, and if that
636 fails, will then consult the local password file.
638 * Save and restore the bits under the passwd dialog,
639 to avoid leaving a black rectangle behind when
640 unlocking is cancelled.
641 Changes since 3.01: * Not everyone has sys/select.h, sigh...
642 Changes since 3.00: * Some fixes to `reflect'.
644 * Made it log unsuccessful attempts to unlock the screen
646 * Fixed a bug where `xscreensaver-demo' could be seeing
647 a different programs list than `xscreensaver' did.
648 Changes since 2.34: * The xscreensaver daemon no longer links against Motif
649 or Athena: demo-mode and the preferences panel are no
650 longer built in to the daemon, but are now handled by
651 an external program, `xscreensaver-demo'.
652 (I decided that this, along with the recent addition
653 of the `.xscreensaver' config file, justified bumping
654 the version number to 3.00, since this is a fairly
655 major architectural change.)
656 * Lines in the `*programs' resource may now begin with
657 the character "-", meaning "don't run this hack."
658 In this way, it's possible to disable a hack without
659 throwing away the information about it (making it
660 easier to change your mind later.) Eventually the
661 preferences/demo mode GUI should represent this as a
662 checkbox or something.
663 * Fixed a short race condition where it was possible for
664 xscreensaver to die with a BadWindow error if it was
665 blanking the screen just as another window was being
667 * Made it possible to disable specific modes in `bsod'.
668 Changes since 2.33: * Fixed a bug that was making `pipes' generate way too
669 many valves. Made the viewpoint in `pipes' be selected
670 randomly instead of always being -10 degrees.
671 * Fixed a bug in the XSHM code, in the case where the
672 server supports the XSHM extension but is not the same
673 machine as the client.
674 * Made `rd-bomb' default to taking up the whole screen.
675 * Made it not try to do fading/unfading if no PseudoColor
677 * Initial attempt at supporting VT-locking (doesn't work
679 * Eliminated the `captureStdout' resource; now
680 `captureStderr' controls both streams.
681 * Added `-capture-stderr' and `-no-capture-stderr'
682 command-line arguments.
683 * Added `glplanet' hack.
684 * When a hack is selected with `xscreensaver-command
685 -select', that hack will be used until further notice
686 (until the saver turns off, or another activation
688 Changes since 2.32: * Made `xscreensaver-command' print error messages:
689 the xscreensaver daemon now responds to ClientMessage
690 events by writing a response message on a window
691 property, instead of just writing to its stderr.
692 * Made the ~/.xscreensaver file be automatically reloaded
693 when the file date changes.
694 * The password dialog and splash screen no longer depend
695 on Motif or Athena. This should clear up a number of
696 focus problems, and is the first step on the path
697 toward moving all of the Motif/Athena/whatever code
698 out of the xscreensaver daemon, and into external
700 * Don't complain about LessTif 0.86 any more, since the
701 new password dialog makes that problem go away.
702 * Configure tweaks for Irix 6.5, SunOS 5.something.
703 * New `-reflect' option to `distort'.
704 Changes since 2.31: * Added reading and writing of a ~/.xscreensaver file,
705 so that the Preferences panel can save its settings.
706 * New version of `rubik'.
707 * Added `-select N' argument to `xscreensaver-command'.
708 * Oops, left out some of the `bubbles3d' files...
709 Changes since 2.30: * The cursor was invisible in the password dialog. Fixed.
710 * Made configure warn against MesaGL 2.6.
711 * Fixed X error at startup when using non-default visual.
712 * New version of `crystal', `ant', and `atlantis' from
714 * New hack, `bubble3d'.
715 * Added some new modes to `bsod'.
716 Changes since 2.29: * Changed the order in which -lSM and -lICE are linked
717 to be after Motif instead of before (Lesstif on Irix
719 Changes since 2.28: * Work around a bash bug in configure.
720 * Tweaked HPUX paths again. FTSOHPUX.
721 * Made configure recommend against LessTif 0.86, due
722 to a bug in that version that causes a security hole
723 in the screen locking code. LessTif 0.87 will fix it.
724 * Made all of the `--with' options to `configure' accept
725 a directory option as well (so that --with-motif=/FOO
726 will add -I/FOO/include -L/FOO/lib). I believe this is
727 the Configure Party Line of how do to such things.
728 * Fixed a bug where the mouse was left un-grabbed
729 after the first time the graphics hack was changed
730 (simplified all of the mouse-grabbing logic.)
731 * Maybe possibly perhaps made `vidwhacker' really not
732 leave stray xv windows around. This time for sure.
733 * Added a new erase mode (random dots fizzling out.)
734 * Added `-prefs' argument to `xscreensaver-command',
735 that brings up the Preferences dialog directly (it
736 seems that nobody ever noticed the `Preferences' button
737 on the Demo Mode dialog, maybe this will help.)
738 * Added a splash screen. Turn it off with *splash:false.
739 Changes since 2.27: * Better macsbug text in `bsod'.
740 * New version of `distort' with many new modes.
741 * Plugged a leak in `coral'.
742 * Tweaked configure for HPUX.
743 * Removed some compiler warnings.
744 * More consistent usage of stderr versus stdout.
745 * More diagnostics should an X error occur.
746 * Fixed a possible crash in SGI-specific unfading code.
747 Changes since 2.26: * Improved version of `distort'.
748 * Made `lament' compile against OpenGL 1.0 (though it
749 still requires 1.1 to work properly.)
750 * Updated my email address and home page.
751 Changes since 2.24: * Improved motion in `rd-bomb'.
752 * Added XSHM (shared memory extension) support to the
753 `distort', `interference', `moire', `rd-bomb', and
754 `swirl' hacks, which speeds them up a bit.
755 * Added `lament' hack.
756 Changes since 2.23: * Tweaked the order of the -L options again.
757 * Cleaned up configure's `--help' message.
758 * Added `kumppa' hack.
759 * Smarter maze-solving algorithm in `maze'.
760 * Took `xlyap' out of the default list of hacks, since
761 it's just incredibly buggy (and slow.) Maybe someday
762 someone will fix it...
763 * Added `distort' hack, but didn't add it to the default
764 list (yet) because it's still too slow.
765 * Made the Athena demo dialog look more like the Motif
766 version; it has a text-entry field now, too.
767 * Made the Athena password dialog echo asterisks, like
768 Motif does, instead of using a flyspeck font.
769 * Some random configure tweaks.
770 * Added a `timestamp' resource that makes the `-verbose'
771 messages include the time at which they were printed.
772 Changes since 2.22: * The fix for SGI's ``scheme'' nonsense broke things, and
773 let the user's "*background" resource show through.
774 Fixed it in a different way.
775 Changes since 2.21: * Added support for the DPMS server extension (Display
776 Power Management System.)
777 * Made configure advertize the `--enable-subdir' option a
778 little more, since that seemed to cause some people
779 stress. Also, made that directory be built into the
780 xscreensaver executable, as a hardcoded prefix to
781 $PATH. (Might help, shouldn't hurt.)
782 * Made configure prefer the two-arg gettimeofday to the
783 one-arg version, since AIX doesn't have any prototypes.
784 * Made it work with Xaw3d (the 3D Athena library.)
785 * Made `make install' create directories as necessary.
786 * New version of lmorph from Sverre.
787 * Added `crystal' and `discreet' hacks from xlockmore.
788 * Added a new mode to `bsod'.
789 Changes since 2.20: * Made `xscreensaver-command -time' use different words.
790 (It now describes the two states as "screen blanked
791 since..." and "screen non-blanked since..." instead of
792 "active since..." and "inactive since..." which a lot
793 of people interpreted as meaning the opposite of what
795 * Improved some error messages, in the hopes of making
796 the distinction between the xscreensaver and
797 xscreensaver-command programs more obvious.
798 * Rewrote (and reorganized) parts of the xscreensaver and
799 xscreensaver-command manual pages.
800 * Renamed xscreensaver's `-lock' command-line option to
801 be `-lock-mode', to avoid confusion with the `-lock'
802 option to xscreensaver-command, which does a totally
804 * Removed xscreensaver's `-demo' command-line option for
805 a similar reason; use `xscreensaver-command -demo'
807 * Disabled SGI's ``scheme'' nonsense in a better way than
808 fully-qualifying the background colors in every single
810 * Fixed some other minor cosmetic problems when *sgiMode
812 * Fixed an X error in `bsod -root' (how ironic...)
813 Changes since 2.19: * Fixed a bug that caused the mouse to sometimes not be
814 grabbed properly (meaning the window manager menu could
815 pop up over the demo-mode display.)
816 * Fixed a bug that made the stderr output sometimes get
818 * Fixed a bug that made the demo-mode scrollbar move too
820 * Protected against a possible buffer overflow.
821 * Made `vidwhacker' not leave stray xv windows around.
822 * New version of `ant' so that Bagley doesn't calve.
823 * Make configure on AIX get XShm from the right library.
824 Changes since 2.18: * One file was missing from the tar file. Fixed.
825 Changes since 2.17: * Oops, atlantis wasn't being built by default. Fixed.
826 * Added `epicycle' hack.
827 * Added `interference' hack.
828 * Added `truchet' hack.
830 * Added some new modes to `vidwhacker'.
831 Changes since 2.16: * Added a -window-id argument to most hacks, so that they
832 can draw on arbitrary externally-provided windows.
833 * Synched with xlockmore 4.11a01.
835 * Added `atlantis' GL hack.
836 * Renamed `puzzle' hack to `jigsaw', since xlock already
837 had a different mode called `puzzle'.
838 * Made it self-configure properly when Motif 2.1.0 is
839 being used (requires -lXp now, sigh...)
840 Changes since 2.15: * Made `flag' able to do XPM images.
841 * New look for the xscreensaver logo (`xroger').
842 * Fixed compilation error on Suns with adjunct passwords.
843 * Got multi-architecture builds working again.
844 * Some configure tweaks for building on HPUX and Solaris.
845 * Fixed bug in decayscreen.
846 * Fixed typo in passwd.c.
847 * Made `cynosure' not die when colormap is full.
848 Changes since 2.14: * Added `cynosure' hack.
849 * Added `moire2' hack.
850 * Tweaked `erase.c' some more.
851 * Made unfading a bit smoother.
852 * Added `vidwhacker' hack (not installed by default.)
853 * Added `stairs' hack.
854 * Split `escher' into `cage' and `moebius', as per
856 * Changed subprocess handling to use sigaction() instead
857 of signal() if it's available (this is necessary for
858 SCO but should work fine on other systems too.)
859 * Various other tweaks.
860 Changes since 2.13: * Better fix for the Motif drag-and-die lossage.
861 * Put in some kludges to work around a LessTif bug.
862 * XScreenSaver is known to work with LessTif 0.82 now.
863 * Made fading work on high-end SGI video hardware.
864 * Fixed another SGI-specific bug in screen grabbing;
865 will the madness never cease?
866 * Fixed another crash in `xlyap'.
867 Changes since 2.12: * Made `decayscreen' do directions other than down.
869 * Fixed a crash in `xlyap'.
870 * Added CDE info to the man page, removed `cde.txt'.
871 * Configure tweaks for Zippy.
872 * Turned off the signal handling in `bubbles' because
873 it was sometimes failing to die.
874 * Added `hacks/xscreensaver-sgigl.c' to make it possible
875 to run SGI's ElectroPaint hack (/usr/demos/bin/ep)
876 with xscreensaver. Finally!
877 * Fixed a buffer overrun in the locking code that some
878 wily, malicious cracker must have slipped in.
879 * Disabled Motif drag-and-drool in the dialog box
880 buttons, since it's broken in some old versions of
882 Changes since 2.11: * Added `README.debugging'.
883 * Added `puzzle' hack.
884 * Added `xlyap' hack.
885 * Added `default-n' as a visual name, so that one can
886 have -install on by default, but turn it off for
887 certain poorly-behaved hacks (like xv.)
888 * Added support for grabbing frames of external video
889 (on SGI) to the screen-grabbing hacks (decayscreen,
890 slidescreen, slip, blitspin, and puzzle.)
891 * Improved look of tiles in `slidescreen'; fixed its
892 color allocation problem.
893 Changes since 2.10: * Tweaked `blitspin', added it to the default list.
894 * Added `lissie', `mountain', `triangle', `worm',
895 `rotor', and `ant' from xlockmore.
896 * Updated `sierpinski', `galaxy', and `lisa'.
897 * Thickened the lines in `braid' and `lmorph'.
898 * Updated VMS makefiles.
899 * Renamed `fract' to `vines'.
900 * Added `xjack' hack.
901 * Made a few more hacks use erase.c, and added a few
903 * Fixed compilation problem with Sun's version of OpenGL.
904 * Added ability to use sigaction() instead of signal()
905 to work around a SCO kernel bug.
906 Changes since 2.09: * Fixed colormap bugs in `rd-bomb'; sped up `coral'.
907 * Configure tweaks for *BSD.
908 Changes since 2.07: * New hacks `rd-bomb' and `coral'.
909 * New version of `maze' with some new algorithms.
910 * New colorized version of `rocks'.
911 * Fixed a bug in qix on 64-bit machines.
912 * Fixed a bug in the -time option.
913 * Fixed a bug in configure related to LessTif.
914 Changes since 2.06: * Minor header tweaks in windows.c and flag.c.
915 * Made multi-architecture ($VPATH) builds work properly.
916 * Merged new GL stuff from xlockmore (rubik, morph3d.)
917 * Fixed intermittent crashes in `imsmap' and `munch'.
918 * Added `fadeplot' hack from xlockmore.
919 Changes since 2.05: * Merged in VMS support from Patrick Moreau.
920 Changes since 2.04: * Fixed a MIT-SCREEN-SAVER-related crash, and tweaked
921 configure to detect the extra-random -Xss library.
922 Changes since 2.03: * HP configure tweaks. Detect and warn about LessTif.
923 * Fixed low-color behavior of `goop', `pyro', `starfish',
924 `greynetic', `flame', `halo', and `moire'.
925 Changes since 2.02: * Fixed flicker in `pipes'. Fixed 3d in `bouboule'.
926 * Added `munch' hack.
927 * Added basic dependencies to the Makefile.in files.
928 Changes since 2.01: * Fixes for compiling with the MIT saver extension.
929 * Made the yow/fortune program be a configure option.
930 * Various configure tweaks.
931 Changes since 2.00: * Added `goop' and `starfish' hacks.
932 * Added colomap cycling to `halo'.
933 * Made `attraction' use the new colormap allocator.
934 * Added better $PATH diagnostics.
935 * There was a bug in frand! Color selection should be
937 Changes since 1.34: * Converted to use `configure' instead of `imake'.
938 * ANSI C is now required.
939 * Added Kerberos locking support, from Nat Lanza.
940 * Made the stderr text use overlay planes, if possible.
941 * Reworked the xlockmore compatibility stuff again.
942 * Added `gears', `superquadrics', `escher', `pipes',
943 and `sproingies' hacks (depend on OpenGL.)
944 Changes since 1.33: * Fixed some bugs, made fading be a little smoother.
945 Changes since 1.32: * Made it work with multi-headed displays.
946 * Generalized sub-process management (Unix sucks!)
947 * Added interactive mouse frobbing to Julia.
948 * Added (untested) support for HPUX shadow passwords.
949 * Made normal non-shadow passwords be checked if the
950 shadow passwords aren't accessible for some reason.
951 Changes since 1.31: * Removed *colorPrograms and *monoPrograms resources:
952 made it possible to specify the desired visual on a
954 * Cleaned up / restructured the driver: no more globals.
955 * Made the Motif and Athena dialogs share more code.
956 * Probably fixed some Athena colormap-installation bugs.
957 * Fixed screen grabbing (cmap) on SGI 12-bit PseudoColor.
958 * Fixed divide-by-zero in bright random colormaps.
959 * Added an improved version of xlock's `flag' hack.
960 * Made unfading work better, and not flicker on SGIs.
961 * Added `sphere', `forest', `lisa' hacks from xlockmore.
962 * Added (untested) support for SunOS Adjunct passwords.
963 Changes since 1.30: * Improved colors and colormap cycling of many hacks.
964 * Cleaned up xlockmore compatibility layer.
965 * Made `blitspin' able to grab an image off the screen.
966 * Ported `swirl' and `bouboule' hacks from xlockmore.
967 * Made the driver more careful about not leaving bits on
968 the screen, or allowing other windows to raise
969 themselves: it now re-blanks the screen every so often.
970 * Added `-time' option to `xscreensaver-command'.
971 * Improved SGI screen-grabbing some more: now it can grab
972 TrueColor screens into PseudoColor windows and have the
973 colors still come out semi-reasonably.
974 Changes since 1.29: * Made `slidescreen' and `decayscreen' work better on
975 SGIs when windows of different visuals are present, by
976 using the XReadDisplay() extension to get a true 24-bit
977 image out of the frame buffer.
978 * Made `noseguy' be in color, if compiled with XPM.
979 * Ported `braid', `drift', `fract', `galaxy', `grav',
980 `ifs', `julia', `laser', `lightning', `penrose',
981 `sierpinski', `slip', `spiral', and `strange' hacks
983 * Merged `hopalong' hack with a more recent version.
985 Changes since 1.27: * Added `deco', `moire', and `kaleidescope' hacks.
986 * Merged in support for non-Motif locking and demo mode.
987 * Made `blitspin' and `bubbles' work in TrueColor.
988 * Fixed a stupid bug I introduced in `imsmap'.
989 * Added `poly' and `gravity' options to `qix'.
990 Changes since 1.26: * Added support for SGI SCREEN_SAVER extension.
991 * Made `fade' and `unfade' work on 8-bit SGIs.
992 * Made the dialog boxes more Motify.
993 * Added `bubbles' hack.
994 Changes since 1.25: * Added `lmorph' hack.
995 * Added viscosity and mouse-control to attraction.
996 * Fixed possible bad color choices in qix and attraction.
997 * Added ramp-mode to halo.
998 * Added a new RNG, which is faster and more portable
999 than using the RNG in libc.
1000 * Made locking work on SCO.
1001 * Various other minor tweaks that I don't remember.
1002 Changes since 1.24: * Made it capture the stdout/stderr of its subprocesses
1003 and present them on the screensaver window itself.
1004 * Made demo mode work correctly with non-default visuals
1005 and color maps, instead of always using the defaults.
1006 * Added -visual argument to all included screenhacks.
1007 * Support for the R6 MIT-SCREEN-SAVER server extension.
1008 * Made the demo mode list scroll properly.
1009 * Added `pedal' hack.
1010 Changes since 1.23: * Fixed some private-colormap oddities in slidescreen,
1011 decayscreen, and xroger. Fixed apparent conservation-
1012 of-mass problem in pyro; made the shrapnel round.
1013 Changes since 1.22: * Minor tweaks for IRIX5; fixed locking race condition.
1014 Changes since 1.21: * Minor tweaks for X11R6.
1015 * Fixes for non-default visuals.
1016 Changes since 1.20: * Fixed bug in color blitspin; added default image.
1017 * Added diagnostics to noseguy. Fixed off-by-one
1018 error in flame. Added some missing casts.
1019 Changes since 1.18: * Added `flame' hack.
1020 * Fixed a minor Motif dialog text field bug.
1021 * Fixed yet another XPointer-not-defined-in-R4 bug.
1022 Changes since 1.17: * Added support for shadow password files.
1023 * Fixed some Motif-related locking bugs.
1024 * Added diagnostics when locking is disabled.
1025 * Made blitspin able to use the XPM library.
1026 * Added `decayscreen' hack.
1027 Changes since 1.16: * Added `halo' hack.
1028 Changes since 1.15: * Portability fixes.
1029 Changes since 1.14: * Broke the driver up into more source files.
1030 * Moved the hacks into their own directory.
1031 * Made all `time' parameters accept the 00:00:00 syntax,
1032 so that even the parameters which are normally read as
1033 minutes can be specified in seconds.
1034 * Added colormap cycling to `imsmap'.
1035 * Made hyper work with K&R compilers.
1036 Changes since 1.13: * Added `orbit' option to `attraction' hack.
1037 * Added `lock-timeout' option.
1038 * Cleaned up options of `maze' hack.
1039 Changes since 1.8: * Added demo mode, and locking.
1040 * Added `maze' hack.
1041 * Added `norotate' option to `rocks' hack.
1042 Changes since 1.4: * Works when run from XDM before anyone logs in.
1044 * Can use `xv' as a slideshow without using up colormap
1045 entries while the screen is not blanked.
1046 * Fixed a BadDrawable error in non-XIdle mode.
1047 * Added `blitspin' and `imsmap'.
1048 Changes since 1.0: * Current list of included hacks is now: qix, helix,
1049 rorschach, attraction, greynetic, rocks, pyro,
1050 hopalong, and noseguy.