4 ! a screen saver and locker for the X window system
10 ! See "man xscreensaver" for more info. The latest version is always
11 ! available at http://www.jwz.org/xscreensaver/
14 ! These resources, when placed in the system-wide app-defaults directory
15 ! (e.g., /usr/lib/X11/app-defaults/XScreenSaver) will provide the default
16 ! settings for new users. However, if you have a ".xscreensaver" file in
17 ! your home directory, the settings in that file take precedence.
38 *overlayTextForeground: #FFFF00
39 *overlayTextBackground: #000000
41 *font: *-medium-r-*-140-*-m-*
43 ! The default is to use these extensions if available (as noted.)
44 *sgiSaverExtension: True
45 *mitSaverExtension: False
49 ! This is what the "Demo" button on the splash screen runs (/bin/sh syntax.)
50 *demoCommand: xscreensaver-demo
52 ! This is what the "Prefs" button on the splash screen runs (/bin/sh syntax.)
53 *prefsCommand: xscreensaver-demo -prefs
55 ! This is the URL that the "Help" button on the splash screen loads.
56 *helpURL: http://www.jwz.org/xscreensaver/man.html
58 ! This is how the "Help" button loads URLs (/bin/sh syntax.)
59 ! The "helpURL" will be substituted for up to two occurrences of "%s".
60 *loadURL: netscape -remote 'openURL(%s)' || netscape '%s'
62 ! This is what the "Manual" button in xscreensaver-demo runs (/bin/sh syntax.)
63 *manualCommand: xterm +sb -fg black -bg gray75 -T '%s manual' \
64 -e /bin/sh -c 'man "%s" || read foo'
65 ! Gnome folks might prefer this:
66 !*manualCommand: gnome-help-browser 'man:%s'
69 ! The format used for printing the date and time in the password dialog box
70 ! (see the strftime(3) manual page for details.)
71 *dateFormat: %d-%b-%y (%a); %I:%M %p
72 ! To show the time only:
73 ! *dateFormat: %I:%M %p
78 ! Turning on "installColormap" interacts erratically with twm and tvtwm,
79 ! but seems to work fine with mwm and olwm. Try it and see. If your
80 ! screen turns some color other than black, the window manager is buggy,
81 ! and you need to set this resource to False (or get a WM that works.)
83 *installColormap: True
86 ! Any program which can draw on the root window will work as a screensaver.
87 ! The following resource enumerates them.
89 ! Programs are separated by newlines (specified in resource files with \n).
90 ! Lines may be continued with a lone \ at the end of the line.
92 ! Each line is an `sh' command.
94 ! If the first (non-blank) character on the line is "-", then that means
95 ! that this command is disabled: it's still in the list, but it won't ever
96 ! be used. (This is just to make it easy to disable and then re-enable
99 ! If the first word on the line is the name of a visual followed by a
100 ! colon, then that visual will be used for the program, if it is available.
101 ! If no such visual is available, then the program will be skipped. In
102 ! this way, you can specify that you want certain programs to run only
103 ! on color screens, and others only on mono screens, by making use of the
104 ! magic visual names "color" and "mono". Likewise, if some hacks prefer
105 ! colormaps, but others prefer 24-bit windows, that also can be arranged
106 ! (in this case, by using "PseudoColor:" versus "TrueColor:".)
108 ! Some of the screenhacks are written using OpenGL. OpenGL programs are
109 ! a bit different than normal X programs, in that they prefer visuals that
110 ! are *half* as deep as the screen. You can tell xscreensaver to select a
111 ! good visual for a GL program by using the magic visual name "GL".
113 ! All programs must be launched in such a way that they draw on the root
114 ! window; they should not be spawned in the background with "&". If shell
115 ! metacharacters are used, they must be understandable to `sh', not `csh'
116 ! (the $SHELL variable is not consulted, for unfortunate but good reasons.)
118 ! Be sure to check out Demo Mode: run the `xscreensaver-demo' program to
119 ! edit the current list of programs interactively, try out the various modes,
120 ! and change other parameters. See the man page for details.
123 "Qix (solid)" qix -root -solid -delay 0 -segments 100 \n\
124 "Qix (transparent)" qix -root -count 4 -solid -transparent \n\
125 "Qix (linear)" qix -root -count 5 -solid -transparent \
126 -linear -segments 250 -size 100 \n\
127 - mono: "Qix (xor)" qix -root -linear -count 5 -size 200 \
128 -spread 30 -segments 75 -solid -xor \n\
130 "Attraction (balls)" attraction -root -mode balls \n\
131 "Attraction (lines)" attraction -root -mode lines -points 3 \
133 - "Attraction (poly)" attraction -root -mode polygons \n\
134 "Attraction (splines)" attraction -root -mode splines -segments \
136 "Attraction (orbital)" attraction -root -mode lines -radius 300 \
137 -orbit -vmult 0.5 \n\
143 rorschach -root -offset 7 \n\
148 slidescreen -root \n\
149 decayscreen -root \n\
151 blitspin -root -grab \n\
155 "Ripples (oily)" ripples -root -oily -light 2 \n\
156 "Ripples (stir)" ripples -root -oily -light 2 -stir \n\
157 "Ripples (desktop)" ripples -root -water -light 6 \n\
172 "Grav (trails)" grav -root -trail -decay \n\
187 goop -root -max-velocity 0.5 -elasticity \
190 "Starfish (blob)" starfish -root -blob \n\
193 coral -root -delay 0 \n\
195 triangle -root -delay 1 \n\
202 kaleidescope -root \n\
204 xlyap -root -randomize \n\
208 interference -root \n\
209 truchet -root -randomize \n\
215 "RD-Bomb (mobile)" rd-bomb -root -speed 1 -size 0.1 \n\
224 "Wander (spots)" wander -root -advance 0 -size 10 -circles \
225 True -length 10000 -reset 100000 \n\
229 petri -root -size 2 -count 20 \n\
230 "Petri 2" petri -root -minlifespeed 0.02 \
231 -maxlifespeed 0.03 -minlifespan 1 \
232 -maxlifespan 1 -instantdeathchan 0 \
233 -minorchan 0 -anychan 0.3 \n\
239 xspirograph -root \n\
240 color: bubbles -root \n\
241 default-n: webcollage -root \n\
242 default-n: "WebCollage (whacked)" \
243 webcollage -root -filter \
244 'vidwhacker -stdin -stdout' \n\
245 - default-n: vidwhacker -root \n\
247 @GL_KLUDGE@ GL: gears -root \n\
248 @GL_KLUDGE@ GL: superquadrics -root \n\
249 @GL_KLUDGE@ GL: morph3d -root \n\
250 @GL_KLUDGE@ GL: cage -root \n\
251 @GL_KLUDGE@ GL: moebius -root \n\
252 @GL_KLUDGE@ GL: stairs -root \n\
253 @GL_KLUDGE@ GL: pipes -root \n\
254 @GL_KLUDGE@ GL: sproingies -root \n\
255 @GL_KLUDGE@ GL: rubik -root \n\
256 @GL_KLUDGE@ GL: atlantis -root \n\
257 @GL_KLUDGE@ GL: lament -root \n\
258 @GL_KLUDGE@ GL: bubble3d -root \n\
259 @GL_KLUDGE@ GL: glplanet -root \n\
260 @GL_KLUDGE@ GL: pulsar -root \n\
261 - GL: "Pulsar (textures)" \
262 pulsar -root -texture -mipmap \
263 -texture_quality -light -fog \n\
264 @GLE_KLUDGE@GL: extrusion -root \n\
265 @GL_KLUDGE@ GL: sierpinski3d -root \n\
267 - xdaliclock -root -builtin3 -cycle \n\
268 - default-n: xearth -nofork -nostars -ncolors 50 \
269 -night 3 -wait 0 -timewarp 400.0 -pos \
271 - ssystem -fullscreen :32 \n\
272 - xmountains -b -M -Z 0 -r 1 \n\
273 - "XMountains (top)" xmountains -b -M -Z 0 -r 1 -m \n\
274 - xaos -root -autopilot -incoloring -1 \
275 -nogui -outcoloring -1 \n\
282 ! To display a randomized slideshow of images, you can do something like this:
284 ! default-n: "Slideshow" xv -root -rmode 5 -random -viewonly \
285 ! -wloop -wait 30 $HOME/bitmaps/*.jpg \n\
287 ! or, if you prefer "xli" to "xv", like this: (but note that xli's "-delay"
288 ! option doesn't work in conjunction with "-onroot", so you need to add a
289 ! line for each image individually... "xv" is better in this respect.)
291 ! default-n: xli -quiet -onroot -center -border black \
292 ! $HOME/bitmaps/pic1.jpg \n\
293 ! default-n: xli -quiet -onroot -center -border black \
294 ! $HOME/bitmaps/pic2.jpg \n\
295 ! default-n: xli -quiet -onroot -center -border black \
296 ! $HOME/bitmaps/pic3.jpg \n\
298 ! Note that we've used "default-n" as the visual name, rather than just
299 ! "default": this means "default visual, no install", that is, it's like
300 ! specifying the command-line arguments "-visual default -no-install".
301 ! This is necessary because, when XV or XLI arerunning in "-root" mode, they
302 ! always assume that the default visual and colormap are being used, rather
303 ! than examining the window it is drawing on to see what visual and colormap
304 ! it has. If we didn't force the default visual to be used, we would get an
305 ! X error. If we didn't force the default colormap to be installed, the
306 ! colors would be all wrong. "default-i" may also be used as a visual name
307 ! (meaning, "-visual default -install") but you probably won't ever need
311 ! Some of the GL demos that SGI ships work with XScreenSaver; most don't.
312 ! XScreenSaver includes a program (not built or installed by default)
313 ! called "xscreensaver-sgigl". To use the SGI demos with XScreenSaver,
314 ! build that program, and use it to launch the SGI demos. For example,
315 ! on Irix 6.2, you can do this:
317 ! xscreensaver-sgigl /usr/demos/bin/ep -S
318 ! xscreensaver-sgigl /usr/demos/bin/bongo
320 ! On Irix 6.3, things have moved, so you need to do it like this:
322 ! xscreensaver-sgigl /usr/sbin/ep -S
324 ! You can also use the "ant" demo, but first you need to wrap a shell script
325 ! around it that cds to its home directory, so that it can find its files;
326 ! and also pass it the -S argument, to prevent it from forking. What a mess!
327 ! Basically, the SGI demo writers went out of their way to make my life hell.
331 !=============================================================================
333 ! You probably don't want to change anything after this point.
335 !=============================================================================
338 XScreenSaver.pointerPollTime: 5
339 XScreenSaver.initialDelay: 0
340 XScreenSaver.windowCreationTimeout: 30
341 XScreenSaver.bourneShell: /bin/sh
344 ! Resources for the password and splash-screen dialog boxes of
345 ! the "xscreensaver" daemon.
347 *Dialog.headingFont: *-times-bold-r-*-*-*-180-*-*-*-iso8859-1
348 *Dialog.bodyFont: *-helvetica-bold-r-*-*-*-140-*-*-*-iso8859-1
349 *Dialog.labelFont: *-helvetica-bold-r-*-*-*-140-*-*-*-iso8859-1
350 *Dialog.buttonFont: *-helvetica-bold-r-*-*-*-140-*-*-*-iso8859-1
351 *Dialog.dateFont: *-courier-medium-r-*-*-*-80-*-*-*-iso8859-1
352 *Dialog.foreground: #000000
353 *Dialog.background: #BFBFBF
354 *Dialog.Button.foreground: #000000
355 *Dialog.Button.background: #D0D0D0
356 *Dialog.text.foreground: #000000
357 *Dialog.text.background: #FFFFFF
358 *Dialog.logo.foreground: #FF0000
359 *Dialog.logo.background: #FFFFFF
360 *Dialog.topShadowColor: #E7E7E7
361 *Dialog.bottomShadowColor: #737373
362 *Dialog.logo.width: 200
363 *Dialog.logo.height: 200
364 *Dialog.internalBorderWidth: 30
365 *Dialog.borderWidth: 1
366 *Dialog.shadowThickness: 4
368 *passwd.heading.label: XScreenSaver %s
369 *passwd.body.label: This display is locked.
370 *passwd.user.label: User:
371 *passwd.passwd.label: Password:
372 *passwd.passwdFont: *-courier-medium-r-*-*-*-140-*-*-*-iso8859-1
373 *passwd.thermometer.width: 8
375 *splash.heading.label: XScreenSaver %s
376 *splash.body.label: Copyright © 1991-1999 by
377 *splash.body2.label: Jamie Zawinski <jwz@jwz.org>
378 *splash.demo.label: Demo
379 *splash.prefs.label: Prefs
380 *splash.help.label: Help
383 ! Resources for the Motif dialog boxes of the "xscreensaver-demo" program.
385 *fontList: *-helvetica-medium-r-*-*-*-120-*-*-*-iso8859-1
386 *demoDialog*label1.fontList: *-helvetica-medium-r-*-*-*-140-*-*-*-iso8859-1
387 *cmdText.fontList: *-courier-medium-r-*-*-*-120-*-*-*-iso8859-1
388 *label0.fontList: *-helvetica-bold-r-*-*-*-140-*-*-*-iso8859-1
389 XScreenSaver*doc.fontList: *-helvetica-medium-r-*-*-*-100-*-*-*-iso8859-1
390 ! above must be fully qualified to get around *sgiMode.
394 *XmTextField.foreground: #000000
395 *XmTextField.background: #FFFFFF
396 *list.foreground: #000000
397 *list.background: #FFFFFF
399 *ApplicationShell.title: XScreenSaver
400 *warning.title: XScreenSaver
401 *warning_popup.title: XScreenSaver
402 *allowShellResize: True
405 *menubar*file.labelString: File
406 *menubar*file.mnemonic: F
407 *file.blank.labelString: Blank Screen Now
408 *file.blank.mnemonic: B
409 *file.lock.labelString: Lock Screen Now
410 *file.lock.mnemonic: L
411 *file.kill.labelString: Kill Daemon
412 *file.kill.mnemonic: K
413 *file.restart.labelString: Restart Daemon
414 *file.restart.mnemonic: R
415 *file.exit.labelString: Exit
416 *file.exit.mnemonic: E
418 *menubar*edit.labelString: Edit
419 *menubar*edit.mnemonic: E
420 *edit.cut.labelString: Cut
421 *edit.cut.mnemonic: u
422 *edit.copy.labelString: Copy
423 *edit.copy.mnemonic: C
424 *edit.paste.labelString: Paste
425 *edit.paste.mnemonic: P
427 *menubar*help.labelString: Help
428 *menubar*help.mnemonic: H
429 *help.about.labelString: About...
430 *help.about.mnemonic: A
431 *help.docMenu.labelString: Documentation...
432 *help.docMenu.mnemonic: D
434 *demoTab.marginWidth: 10
435 *optionsTab.marginWidth: 10
437 *XmScrolledWindow.topOffset: 10
438 *XmScrolledWindow.leftOffset: 10
439 *demoTab.topOffset: 4
440 *form1.bottomOffset: 10
441 *form3.leftOffset: 10
442 *form3.rightOffset: 10
444 *frame.bottomOffset: 10
445 *enabled.topOffset: 10
446 *visLabel.topOffset: 10
448 *form4.bottomOffset: 4
450 *XmComboBox.marginWidth: 0
451 *XmComboBox.marginHeight: 0
453 *demo.marginWidth: 30
454 *demo.marginHeight: 4
459 *down.marginHeight: 4
462 *frame.traversalOn: False
464 *list.automaticSelection: True
465 *list.visibleItemCount: 20
469 *demoTab.labelString: Graphics Demos
470 *optionsTab.labelString: Screensaver Options
471 *down.labelString: \\/
473 *frameLabel.labelString:
474 *cmdLabel.labelString: Command Line:
475 *cmdLabel.alignment: ALIGNMENT_BEGINNING
476 *enabled.labelString: Enabled
477 *visLabel.labelString: Visual:
478 *visLabel.alignment: ALIGNMENT_END
479 *visLabel.leftOffset: 20
480 *demo.labelString: Demo
481 *man.labelString: Documentation...
482 *done.labelString: Quit
484 *preferencesLabel.labelString: XScreenSaver Parameters
486 *timeoutLabel.labelString: Saver Timeout
487 *cycleLabel.labelString: Cycle Timeout
488 *fadeSecondsLabel.labelString: Fade Duration
489 *fadeTicksLabel.labelString: Fade Ticks
490 *lockLabel.labelString: Lock Timeout
491 *passwdLabel.labelString: Password Timeout
492 *preferencesForm*XmTextField.columns: 8
494 *verboseToggle.labelString: Verbose
495 *cmapToggle.labelString: Install Colormap
496 *fadeToggle.labelString: Fade Colormap
497 *unfadeToggle.labelString: Unfade Colormap
498 *lockToggle.labelString: Require Password
505 *Cancel.marginWidth: 30
506 *Cancel.marginHeight: 4
507 *Cancel.rightOffset: 10
508 *Cancel.bottomOffset: 10
513 !=============================================================================
515 ! Online documentation for xscreensaver-demo.
517 !=============================================================================
519 ! sanity check -- hands off.
520 *hacks.documentation.isInstalled: True
522 *hacks.grav.documentation: \
523 This program draws a simple orbital simulation. If you turn on \
524 trails, it looks kind of like a cloud-chamber photograph. Written by \
527 *hacks.qix.documentation: \
528 This is the swiss army chainsaw of qix programs. It bounces a series \
529 of line segments around the screen, and uses variations on this basic \
530 motion pattern to produce all sorts of different presentations: line \
531 segments, filled polygons, overlapping translucent areas... Written \
534 *hacks.attraction.documentation: \
535 Like qix, this uses a simple simple motion model to generate many \
536 different display modes. The control points attract each other up to \
537 a certain distance, and then begin to repel each other. The \
538 attraction/repulsion is proportional to the distance between any two \
539 particles, similar to the strong and weak nuclear forces. \
541 One of the most interesting ways to watch this hack is simply as \
542 bouncing balls, because their motions and interactions with each \
543 other are so odd. Sometimes two balls will get into a tight orbit \
544 around each other, to be interrupted later by a third, or by the edge \
545 of the screen. It looks quite chaotic. \
547 Written by Jamie Zawinski, based on Lisp code by John Pezaris.
549 *hacks.pyro.documentation: \
550 Pyro draws exploding fireworks. Blah blah blah. Written by Jamie \
553 *hacks.helix.documentation: \
554 This repeatedly generates spirally string-art-ish patterns. Written \
557 *hacks.pedal.documentation: \
558 This is sort of a combination spirograph/string-art. It generates a \
559 large, complex polygon, and lets the X server do the bulk of the work \
560 by giving it an even/odd winding rule. Written by Dale Moore, based \
561 on some ancient PDP-11 code.
563 *hacks.rorschach.documentation: \
564 This generates random inkblot patterns. The algorithm is deceptively \
565 simple for how well it works; it merely walks a dot around the screen \
566 randomly, and then reflects the image horizontally, vertically, or \
567 both. Any deep-seated neurotic tendencies which this program reveals \
568 are your own problem. Written by Jamie Zawinski.
570 *hacks.hopalong.documentation: \
571 This draws lacy fractal patterns, based on iteration in the imaginary \
572 plane, from a 1986 Scientific American article. Mostly written by \
575 *hacks.greynetic.documentation: \
576 This draws random colored and stippled rectangles. Written by Jamie \
579 *hacks.xroger.documentation: \
580 The XScreenSaver logo. Don't you hate it? So do I. Would you like \
581 to design a new logo for XScreenSaver? If so, send jwz your \
584 *hacks.imsmap.name: IMSmap
585 *hacks.imsmap.documentation: \
586 This generates random cloud-like patterns. It looks quite different \
587 in monochrome and color. The basic idea is to take four points on \
588 the edge of the image, and assign each a random ``elevation''. Then \
589 find the point between them, and give it a value which is the average \
590 of the other four, plus some small random offset. Then coloration is \
591 done based on elevation. \
593 The color selection is done by binding the elevation to either hue, \
594 saturation, or brightness, and assigning random values to the others. \
595 The ``brightness'' mode tends to yield cloudlike patterns, and the \
596 others tend to generate images that look like heat-maps or CAT-scans. \
597 Written by Juergen Nickelsen and Jamie Zawinski.
599 *hacks.slidescreen.name: SlideScreen
600 *hacks.slidescreen.documentation: \
601 This grabs an image of whatever is on your screen, divides it into a \
602 grid, and then randomly shuffles the squares around as if it was one \
603 of those annoying ``16-puzzle'' games, where there is a grid of \
604 squares, one of which is missing. I hate trying to solve those \
605 puzzles, but watching one permute itself is more amusing. Written by \
608 *hacks.decayscreen.name: DecayScreen
609 *hacks.decayscreen.documentation: \
610 This grabs an image of whatever is on your screen, and makes it melt. \
611 You've no doubt seen this effect before, but no screensaver would \
612 really be complete without it. It works best if there's something \
613 colorful visible. Warning, if the effect continues after the screen \
614 saver is off, seek medical attention. Written by David Wald and \
617 A number of these screenhacks have the ability to take an image of \
618 your desktop and manipulate it in some way. On SGI systems, these \
619 programs are able to (at random) pull their source image from the \
620 system's video input instead! This works nicely if you leave some \
621 some random television station plugged in.
623 *hacks.jigsaw.documentation: \
624 This grabs a screen image, carves it up into a jigsaw puzzle, \
625 shuffles it, and then solves the puzzle. This works especially well \
626 when you feed it an external video signal instead of letting it grab \
627 the screen image (actually, I guess this is generally true...) When \
628 it is grabbing a video image, it is sometimes pretty hard to guess \
629 what the image is going to look like once the puzzle is solved. \
630 Written by Jamie Zawinski.
632 *hacks.blitspin.name: BlitSpin
633 *hacks.blitspin.documentation: \
634 The ``blitspin'' hack repeatedly rotates a bitmap by 90 degrees by \
635 using logical operations: the bitmap is divided into quadrants, and \
636 the quadrants are shifted clockwise. Then the same thing is done \
637 again with progressively smaller quadrants, except that all \
638 sub-quadrants of a given size are rotated in parallel. Written by \
639 Jamie Zawinski based on some cool SmallTalk code seen in in Byte \
642 As you watch it, the image appears to dissolve into static and then \
643 reconstitute itself, but rotated. You can provide the image to use, \
644 as an XBM or XPM file, or tell it to grab a screen image and rotate \
647 *hacks.slip.documentation: \
648 This program throws some random bits on the screen, then sucks them \
649 through a jet engine and spews them out the other side. To avoid \
650 turning the image completely to mush, every now and then it will and \
651 then it interjects some splashes of color into the scene, or go into \
652 a spin cycle, or stretch the image like taffy, or (this is my \
653 addition) grab an image of your current desktop to chew on. \
654 Originally written by Scott Draves; whacked on by Jamie Zawinski.
656 *hacks.distort.documentation: \
657 This hack grabs an image of the screen, and then lets a transparent \
658 lens wander around the screen, magnifying whatever is underneath. \
659 Written by Jonas Munsin.
661 *hacks.spotlight.documentation: \
662 Draws a spotlight scanning across a black screen, illumnating the \
663 underlying desktop when it passes. Written by Rick Schultz.
665 *hacks.hypercube.documentation: \
666 This displays 2D projections of the sequence of 3D objects which are \
667 the projections of the 4D analog to the cube: as a square is composed \
668 of four lines, each touching two others; and a cube is composed of \
669 six squares, each touching four others; a hypercube is composed of \
670 eight cubes, each touching six others. To make it easier to \
671 visualize the rotation, it uses a different color for the edges of \
672 each face. Don't think about it too long, or your brain will melt. \
673 Written by Joe Keane, Fritz Mueller, and Jamie Zawinski.
675 *hacks.halo.documentation: \
676 This draws trippy psychedelic circular patterns that hurt to look at. \
677 It can also animate the control-points, but that takes a lot of CPU \
678 and bandwidth. Written by Jamie Zawinski.
680 *hacks.maze.documentation: \
681 This is the ancient X maze demo, modified to work with xscreensaver. \
682 It generates a random maze, then solves it with visual feedback. \
683 Originally by Jim Randell; modified by a cast of thousands.
685 *hacks.noseguy.documentation: \
686 A little man with a big nose wanders around your screen saying \
687 things. The things which he says can come from a file, or from an \
688 external program like `zippy' or `fortune'. This was extracted from \
689 `xnlock' by Dan Heller. Colorized by Jamie Zawinski.
691 *hacks.flame.documentation: \
692 Another iterative fractal generator. Written by Scott Draves.
694 *hacks.lmorph.name: LMorph
695 *hacks.lmorph.documentation: \
696 This generates random spline-ish line drawings and morphs between \
697 them. Written by Sverre H. Huseby and Glenn T. Lines.
699 *hacks.deco.documentation: \
700 This one subdivides and colors rectangles randomly. It looks kind of \
701 like Brady-Bunch-era rec-room wall paneling. (Raven says: ``this \
702 screensaver is ugly enough to peel paint.'') Written by Jamie \
703 Zawinski, inspired by Java code by Michael Bayne.
705 *hacks.moire.documentation: \
706 This one draws cool circular interference patterns. Most of the \
707 circles you see aren't explicitly rendered, but show up as a result \
708 of interactions between the other pixels that were drawn. Written by \
709 Jamie Zawinski, inspired by Java code by Michael Bayne. As he \
710 pointed out, the beauty of this one is that the heart of the display \
711 algorithm can be expressed with just a pair of loops and a handful of \
712 arithmetic, giving it a high ``display hack metric''.
714 *hacks.moire2.documentation: \
715 Another example of the fun you can have with moire \
716 interference patterns; this hack generates fields of concentric \
717 circles or ovals, and combines the planes with various operations. \
718 The planes are moving independently of one another, causing the \
719 interference lines to ``spray.'' Written by Jamie Zawinski.
721 *hacks.lightning.documentation: \
722 This one draws crackling fractal lightning bolts. It's simple, \
723 direct, and to the point. If only it had sound... Written by Keith \
726 *hacks.strange.documentation: \
727 This draws strange attractors: it's a colorful, \
728 unpredictably-animating field of dots that swoops and twists around. \
729 The motion is very nice. Written by Massimino Pascal.
731 *hacks.spiral.documentation: \
732 Moving circular patterns, by Peter Schmitzberger. Moving circular \
733 patterns means moire; interference patterns, of course.
735 *hacks.laser.documentation: \
736 Moving radiating lines, that look vaguely like scanning laser beams. \
737 Written by Pascal Pensa. (Frankie say: relax.)
739 *hacks.grav.documentation: \
740 This program draws a simple orbital simulation. If you turn on \
741 trails, it looks kind of like a cloud-chamber photograph. Written \
744 *hacks.drift.documentation: \
745 How could one possibly describe this except as ``drifting recursive \
746 fractal cosmic flames?'' Another fine hack from the Scott Draves \
747 collection of fine hacks.
750 *hacks.ifs.documentation: \
751 This one draws spinning, colliding iterated-function-system images. \
752 Written by Massimino Pascal.
754 *hacks.julia.documentation: \
755 This one draws spinning, animating (are you detecting a pattern here \
756 yet?) explorations of the Julia set. You've probably seen static \
757 images of this fractal form before, but it's a lot of fun to watch in \
758 motion as well. One interesting thing is that there is a small \
759 swinging dot passing in front of the image, which indicates the \
760 control point from which the rest of the image was generated. \
761 Written by Sean McCullough.
763 *hacks.penrose.documentation: \
764 Draws quasiperiodic tilings; think of the implications on modern \
765 formica technology. Written by Timo Korvola. \
767 In April 1997, Sir Roger Penrose, a British math professor who has \
768 worked with Stephen Hawking on such topics as relativity, black \
769 holes, and whether time has a beginning, filed a \
770 copyright-infringement lawsuit against the Kimberly-Clark \
771 Corporation, which Penrose said copied a pattern he created (a \
772 pattern demonstrating that ``a nonrepeating pattern could exist in \
773 nature'') for its Kleenex quilted toilet paper. Penrose said he \
774 doesn't like litigation but, ``When it comes to the population of \
775 Great Britain being invited by a multinational to wipe their bottoms \
776 on what appears to be the work of a Knight of the Realm, then a last \
777 stand must be taken.'' \
779 As reported by News of the Weird #491, 4-jul-1997.
781 *hacks.sierpinski.documentation: \
782 This draws the two-dimensional variant of the recursive Sierpinski \
783 triangle fractal. Written by Desmond Daignault.
785 *hacks.braid.documentation: \
786 Draws random color-cycling inter-braided concentric circles. Written \
789 *hacks.galaxy.documentation: \
790 This draws spinning galaxies, which then collide and scatter their \
791 stars to the, uh, four winds or something. Originally an Amiga \
792 program by Uli Siegmund.
794 *hacks.bouboule.documentation: \
795 This draws what looks like a spinning, deforming baloon with \
796 varying-sized spots painted on its invisible surface. Written by \
799 *hacks.swirl.documentation: \
800 More flowing, swirly patterns. This version is by M. Dobie and R. \
801 Taylor, but you might have seen a Mac program similar to this called \
802 FlowFazer. There is also a cool Java applet of a similar concept
804 *hacks.flag.documentation: \
805 This draws a waving colored flag, that undulates its way around the \
806 screen. The trick is the flag can contain arbitrary text and images. \
807 By default, it displays either the current system name and OS \
808 type, or a picture of ``Bob,'' but you can replace the text or the \
809 image with a command-line option. Written by Charles Vidal and Jamie \
812 *hacks.sphere.documentation: \
813 Another of the classic screenhacks of the distant past, this one \
814 draws shaded spheres in multiple colors. This hack traces its \
815 lineage back to Tom Duff in 1982.
817 *hacks.forest.documentation: \
818 This draws fractal trees. Written by Peter Baumung. Everybody loves \
821 *hacks.lisa.documentation: \
822 This draws Lisajous loops, by Caleb Cullen. Remember that device \
823 they had the Phantom Zone prisoners in during their trial in \
824 Superman? I think that was one of these.
826 *hacks.lissie.documentation: \
827 Another Lissajous figure. This one draws the progress of circular \
828 shapes along a path. Written by Alexander Jolk.
830 *hacks.goop.documentation: \
831 This draws set of animating, transparent, amoeba-like blobs. The \
832 blobs change shape as they wander around the screen, and they are \
833 translucent, so you can see the lower blobs through the higher ones, \
834 and when one passes over another, their colors merge. Written by \
835 Jamie Zawinski. I got the idea for this from a cool mouse pad I \
836 have, which achieves the same kind of effect in real life by having \
837 several layers plastic with colored oil between them. Written by \
840 *hacks.starfish.documentation: \
841 This generates a sequence of undulating, throbbing, star-like \
842 patterns which pulsate, rotate, and turn inside out. Another display \
843 mode uses these shapes to lay down a field of colors, which are then \
844 cycled. The motion is very organic. Written by Jamie Zawinski.
846 *hacks.munch.documentation: \n\
853 As reported by HAKMEM, in 1962, Jackson Wright wrote the above PDP-1 \
854 code. That code still lives on in this screenhack, some 35 years \
855 later. The number of lines of enclosing code has increased \
856 substantially, however. This version is by Tim Showalter.
858 *hacks.fadeplot.name: FadePlot
859 *hacks.fadeplot.documentation: \
860 Draws what looks like a waving ribbon following a sinusoidal path. \
861 Written by Bas van Gaalen and Charles Vidal.
863 *hacks.coral.documentation: \
864 Simulates coral growth, albeit somewhat slowly. This image doesn't \
865 really do it justice. Written by Frederick Roeber.
867 *hacks.mountain.documentation: \
868 Generates random 3d plots that look vaguely mountainous. Written by \
871 *hacks.triangle.documentation: \
872 Generates random mountain ranges using iterative subdivision of \
873 triangles. Written by Tobias Gloth.
875 *hacks.worm.documentation: \
876 An ancient xlock hack that draws multicolored worms that crawl around \
877 the screen. Written by Brad Taylor, Dave Lemke, Boris Putanec, and \
880 *hacks.rotor.documentation: \
881 Another ancient xlock demo, this one by Tom Lawrence. It draws a \
882 line segment moving along a complex spiraling curve. I tweaked this \
883 to generate curvier lines, but still frames of it don't look like \
886 *hacks.ant.documentation: \
887 A cellular automaton that is really a two-dimensional Turing machine: \
888 as the heads (``ants'') walk along the screen, they change pixel \
889 values in their path. Then, as they pass over changed pixels, their \
890 behavior is influenced. Written by David Bagley.
892 *hacks.demon.documentation: \
893 A cellular automaton that starts with a random field, and organizes \
894 it into stripes and spirals. Written by David Bagley.
896 *hacks.loop.documentation: \
897 This one produces loop-shaped colonies that spawn, age, and \
898 eventually die. Written by David Bagley.
900 *hacks.vines.documentation: \
901 This one generates a continuous sequence of small, curvy geometric \
902 patterns. It scatters them around your screen until it fills up, \
903 then it clears the screen and starts over. Written by Tracy Camp and \
906 *hacks.kaleidescope.documentation: \
907 Another clone of an ancient meme, consisting largely of frenetic \
908 rotational motion of colored lines. This one is by Ron Tapia. The \
909 motion is nice, but I think it needs more solids, or perhaps just \
910 brighter colors. More variations in the rotational speed might help, \
913 *hacks.xjack.documentation: \
914 This program behaves schizophrenically and makes a lot of typos. \
915 Written by Jamie Zawinski. If you haven't seen Stanley Kubrick's \
916 masterpiece, ``The Shining,'' you won't get it. Those who have \
917 describe this hack as ``inspired.''
919 *hacks.xlyap.documentation: \
920 This generates pretty fractal pictures by doing funky math involving \
921 the ``Lyapunov exponent.'' It has a cool interactive mode, too. \
922 Written by Ron Record.
924 *hacks.cynosure.documentation: \
925 A hack similar to `greynetic', but less frenetic. The first \
926 implementation was by Stephen Linhart; then Ozymandias G. Desiderata \
927 wrote a Java applet clone. That clone was discovered by Jamie \
928 Zawinski, and ported to C for inclusion here.
930 *hacks.flow.documentation: \
931 Another series of strange attractors: a flowing series of points, \
932 making strange rotational shapes. Written by Jeff Butterworth.
934 *hacks.epicycle.documentation: \
935 This program draws the path traced out by a point on the edge of a \
936 circle. That circle rotates around a point on the rim of another \
937 circle, and so on, several times. These were the basis for the \
938 pre-heliocentric model of planetary motion. Written by James \
941 *hacks.interference.documentation: \
942 Another color-field hack, this one works by computing decaying \
943 sinusoidal waves, and allowing them to interfere with each other as \
944 their origins move. Written by Hannu Mallat.
946 *hacks.truchet.documentation: \
947 This draws line- and arc-based Truchet patterns that tile the screen. \
948 Written by Adrian Likins.
950 *hacks.bsod.name: BSOD
951 *hacks.bsod.documentation: \
952 BSOD stands for ``Blue Screen of Death.'' The finest in personal \
953 computer emulation, this hack simulates popular screen savers from a \
954 number of less robust operating systems. Written by Jamie Zawinski.
956 *hacks.crystal.documentation: \
957 Moving polygons, similar to a kaleidescope (more like a kaleidescope \
958 than the hack called `kaleid,' actually.) This one by Jouk Jansen.
960 *hacks.discrete.documentation: \
961 More ``discrete map'' systems, including new variants of Hopalong and \
962 Julia, and a few others. Written by Tim Auckland.
964 *hacks.kumppa.documentation: \
965 Spiraling, spinning, and very, very fast splashes of color rush \
966 toward the screen. Written by Teemu Suutari.
968 *hacks.rd-bomb.name: RD-Bomb
969 *hacks.rd-bomb.documentation: \
970 Another variation of the `Bomb' program by Scott Draves. This draws \
971 a grid of growing square-like shapes that, once they overtake each \
972 other, react in unpredictable ways. ``RD'' stands for \
975 *hacks.sonar.documentation: \
976 This program draws a simulation of a sonar screen. Written by \
977 default, it displays a random assortment of ``bogies'' on the screen, \
978 but if compiled properly, it can ping (pun intended) your local \
979 network, and actually plot the proximity of the other hosts on your \
980 network to you. It would be easy to make it monitor other sources of \
981 data, too. (Processes? Active network connections? CPU usage per \
982 user?) Written by Stephen Martin.
985 *hacks.t3d.documentation: \
986 This draws a working analog clock composed of floating, throbbing \
987 bubbles. Written by Bernd Paysan.
989 *hacks.penetrate.documentation: \
990 This hack simulates the classic arcade game Missile Command. Written \
993 *hacks.deluxe.documentation: \
994 This draws a pulsing sequence of stars, circles, and lines. It would \
995 look better if it was faster, but as far as I can tell, there is no \
996 way to make this be both: fast, and flicker-free. Yet another reason \
997 X sucks. Written by Jamie Zawinski.
999 *hacks.compass.documentation: \
1000 This draws a compass, with all elements spinning about randomly, for \
1001 that ``lost and nauseous'' feeling. Written by Jamie Zawinski.
1003 *hacks.squiral.documentation: \
1004 Draws a set of interacting, square-spiral-producing automata. The \
1005 spirals grow outward until they hit something, then they go around \
1006 it. Written by Jeff Epler.
1008 *hacks.xflame.documentation: \
1009 Draws a simulation of pulsing fire. It can also take an arbitrary \
1010 image and set it on fire too. Written by Carsten Haitzler, hacked on \
1013 *hacks.wander.documentation: \
1014 Draws a colorful random-walk, in various forms. Written by Rick \
1017 *hacks.critical.documentation: \
1018 Draws a system of self-organizing lines. It starts out as random \
1019 squiggles, but after a few iterations, order begins to appear. \
1020 Written by Martin Pool.
1022 *hacks.phosphor.documentation: \
1023 Draws a simulation of an old terminal, with large pixels and \
1024 long-sustain phosphor. It can run any program as a source of the text \
1025 it displays. Written by Jamie Zawinski.
1027 *hacks.xmatrix.documentation: \
1028 A rendition of the text scrolls seen in the movie ``The Matrix.'' \
1029 Written by Jamie Zawinski.
1031 *hacks.petri.documentation: \
1032 This simulates colonies of mold growing in a petri dish. Growing \
1033 colored circles overlap and leave spiral interference in their wake. \
1034 Written by Dan Bornstein.
1036 *hacks.shadebobs.name: ShadeBobs
1037 *hacks.shadebobs.documentation: \
1038 This draws smoothly-shaded oscilating oval patterns, that look \
1039 something like vapor trails or neon tubes. Written by Shane Smit.
1041 *hacks.ccurve.name: C Curve
1042 *hacks.ccurve.documentation: \
1043 Generates self-similar linear fractals, including the classic ``C \
1044 Curve.'' Written by Rick Campbell.
1046 *hacks.blaster.documentation: \
1047 Draws a simulation of flying space-combat robots (cleverly disguised \
1048 as colored circles) doing battle in front of a moving star field. \
1049 Written by Jonathan Lin.
1051 *hacks.bumps.documentation: \
1052 A bit like `Spotlight', except that instead of merely exposing part \
1053 of your desktop, it creates a bump map from it. Basically, it \
1054 3D-izes a roaming section of your desktop, based on color intensity. \
1055 Written by Shane Smit.
1057 *hacks.xteevee.name: XTeeVee
1058 *hacks.xteevee.documentation: \
1059 XTeeVee simulates various television problems, including static, \
1060 loss of vertical hold, and a test pattern. By Greg Knauss.
1062 *hacks.xspirograph.name: XSpiroGraph
1063 *hacks.xspirograph.documentation: \
1064 Simulates that pen-in-nested-plastic-gears toy from your childhood. \
1067 *hacks.webcollage.name: WebCollage
1068 *hacks.webcollage.documentation: \
1069 This program makes collages out of random images pulled off of the \
1070 World Wide Web. It finds these images by doing random web searches, \
1071 and then extracting images from the returned pages. It can also be \
1072 set up to filter the images through the `VidWhacker' program, above, \
1073 which looks really great. \
1075 (Note that most of the images it finds are text, and not pictures. \
1076 This is because most of the web is pictures of text. Which is pretty \
1077 sad.) Written by Jamie Zawinski.
1079 *hacks.vidwhacker.name: VidWhacker
1080 *hacks.vidwhacker.documentation: \
1081 This is actually just a shell script that grabs a frame of video from \
1082 the system's video input, and then uses some PBM filters (chosen at \
1083 random) to manipulate and recombine the video frame in various ways \
1084 (edge detection, subtracting the image from a rotated version of \
1085 itself, etc.) Then it displays that image for a few seconds, and \
1086 does it again. This works really well if you just feed broadcast \
1087 television into it. \
1089 Currently, the three lines of the script that actually grab the \
1090 source picture are SGI specific, but it should be trivial to adapt it \
1091 to work on other systems that can grab video (please send me the \
1092 changes if you do this...)
1094 *hacks.rocks.documentation: \
1095 This draws an animation of flight through an asteroid field, with \
1096 changes in rotation and direction. It can also display 3D \
1097 separations for red/blue glasses! Mostly written by Jamie Zawinski.
1099 *hacks.bubbles.documentation: \
1100 This simulates the kind of bubble formation that happens when water \
1101 boils:small bubbles appear, and as they get closer to each other, \
1102 they combine to form larger bubbles, which eventually pop. Written \
1105 *hacks.gears.documentation: \
1106 This draws a set of turning, interlocking gears, rotating in three \
1107 dimensions. Another GL hack, by Danny Sung, Brian Paul, and Ed \
1110 *hacks.superquadrics.documentation: \
1111 Ed Mackey reports that he wrote the first version of this program in \
1112 BASIC on a Commodore 64 in 1987, as a 320x200 black and white \
1113 wireframe. Now it is GL and has specular reflections.
1115 *hacks.morph3d.name: Morph3D
1116 *hacks.morph3d.documentation: \
1117 Another 3d shape-changing GL hack, by Marcelo Vianna. It has the \
1118 same shiny-plastic feel as Superquadrics, as many computer-generated \
1121 *hacks.cage.documentation: \
1122 This draws Escher's ``Impossible Cage,'' a 3d analog of a moebius \
1123 strip, and rotates it in three dimensions. Written by Marcelo \
1126 *hacks.moebius.documentation: \
1127 Another M. C. Escher hack by Marcelo Vianna, this one draws \
1128 ``Moebius Strip II,'' a GL image of ants walking along the surface of \
1131 *hacks.stairs.documentation: \
1132 by Marcelo Vianna's third Escher GL hack, this one draws an \
1133 ``infinite'' staircase.
1135 *hacks.pipes.documentation: \
1136 If you've ever been in the same room with a Windows NT machine, \
1137 you've probably seen this GL hack. This version is by Marcelo \
1140 *hacks.sproingies.documentation: \
1141 Q-Bert meets Marble Madness! Written by Ed Mackey.
1143 *hacks.rubik.documentation: \
1144 Draws a Rubik's Cube that rotates in three dimensions and repeatedly \
1145 shuffles and solves itself. Another fine GL hack by Marcelo Vianna.
1147 *hacks.atlantis.documentation: \
1148 This is xfishtank writ large: a GL animation of a number of sharks, \
1149 dolphins, and whales. The swimming motions are great. Originally \
1150 written by Mark Kilgard.
1152 *hacks.lament.documentation: \
1153 Animates a simulation of Lemarchand's Box, repeatedly solving itself. \
1154 Requires OpenGL, and a machine with fast hardware support for texture \
1155 maps. Warning: occasionally opens doors. Written by Jamie Zawinski.
1157 *hacks.bubble3d.name: Bubble3D
1158 *hacks.bubble3d.documentation: \
1159 Draws a stream of rising, undulating 3D bubbles, rising toward the \
1160 top of the screen, with nice specular reflections. Written by Richard \
1163 *hacks.glplanet.name: GLPlanet
1164 *hacks.glplanet.documentation: \
1165 Draws a planet bouncing around in space. Written by David Konerding. \
1166 The built-in image is a map of the earth (extracted from `xearth'), \
1167 but you can wrap any texture around the sphere, e.g., the planetary \
1168 textures that come with `ssystem'.
1170 *hacks.pulsar.documentation: \
1171 Draws some intersecting planes, making use of alpha blending, fog, \
1172 textures, and mipmaps, plus a ``frames per second'' meter so that you \
1173 can tell how fast your graphics card is... Requires OpenGL. Written \
1176 *hacks.extrusion.documentation: \
1177 Draws various rotating extruded shapes that twist around, lengthen, \
1178 and turn inside out. Created by David Konerding from the samples \
1179 that come with the GL Extrusion library by Linas Vepstas.
1181 *hacks.sierpinski3d.name: Sierpinski3D
1182 *hacks.sierpinski3d.documentation: \
1183 This draws the three-dimensional variant of the recursive Sierpinski \
1184 triangle fractal, using GL. Written by Tim Robinson and Jamie Zawinski.
1186 *hacks.ripples.documentation: \
1187 This draws rippling interference patterns like splashing water. \
1188 With the -water option, it manipulates your desktop image to look \
1189 like something is dripping into it. Written by Tom Hammersley.
1192 !=============================================================================
1194 ! Documentation for some programs that are not bundled with XScreenSaver
1196 !=============================================================================
1198 *hacks.xdaliclock.name: XDaliClock
1199 *hacks.xdaliclock.documentation: \
1200 XDaliClock draws a large digital clock, the numbers of which change by \
1201 ``melting'' into their new shapes. Written by Jamie Zawinski. This \
1202 is not included with the XScreenSaver package, but if you don't have \
1203 it already, you can find it at <http://www.jwz.org/xdaliclock/>.
1205 *hacks.xearth.documentation: \
1206 XEarth draws an image of the Earth, as seen from your favorite vantage \
1207 point in space, correctly shaded for the current position of the Sun. \
1208 Written by Kirk Johnson. This is not included with the XScreenSaver \
1209 package, but if you don't have it already, you can find it at \
1210 <http://www.cs.colorado.edu/~tuna/xearth/>.
1212 *hacks.ssystem.name: SSystem
1213 *hacks.ssystem.documentation: \
1214 SSystem is a GL Solar System simulator. It simulates flybys of Sun, \
1215 the nine planets and a few major satellites, with four camera modes. \
1216 Written by Raul Alonso. This is not included with the XScreenSaver \
1217 package, but if you don't have it already, you can find it at \
1218 <http://www1.las.es/~amil/ssystem/>.
1220 *hacks.xmountains.documentation: \
1221 XMountains generates realistic-looking fractal terrains of snow-capped \
1222 mountains near water, with either a top view or a side view. \
1223 Written by Stephen Booth. This is not included with the XScreenSaver \
1224 package, but if you don't have it already, you can find it at \
1225 <http://www.epcc.ed.ac.uk/~spb/xmountains/>. \
1227 Be sure to compile it with -DVROOT or it won't work right when launched \
1228 by the xscreensaver daemon.
1230 *hacks.xaos.name: XaoS
1231 *hacks.xaos.documentation: \
1232 XaoS generates fast fly-through animations of the Mandelbrot and other \
1233 fractal sets. Written by Thomas Marsh and Jan Hubicka. This is not \
1234 included with the XScreenSaver package, but if you don't have it \
1235 already, you can find it at <http://limax.paru.cas.cz/~hubicka/XaoS/>.
1237 *hacks.xfishtank.name: XFishTank
1238 *hacks.xfishtank.documentation: \
1239 Fish! This is not included with the XScreenSaver package, but if you \
1240 don't have it already, you can find it at \
1241 <http://metalab.unc.edu/pub/Linux/X11/demos/>.
1243 *hacks.xsnow.documentation: \
1244 Draws falling snow and the occasional tiny Santa. By Rick Jansen. \
1245 You can find it at <http://zoutmijn.bpa.nl/rick/Xsnow/>.
1247 *hacks.goban.documentation: \
1248 Replays historical games of go (aka wei-chi and baduk) on the screen. \
1249 By Scott Draves. You can find it at <http://www.draves.org/goban/>.
1251 *hacks.electricsheep.name: ElectricSheep
1252 *hacks.electricsheep.documentation: \
1253 ElectricSheep is an xscreensaver module that displays mpeg video of \
1254 an animated fractal flame. In the background, it contributes render \
1255 cycles to the next animation. Periodically it uploades completed \
1256 frames to the server, where they are compressed for distribution to \
1259 This program is recommended only if you have a high bandwidth \
1260 connection to the Internet. \
1262 By Scott Draves. You can find it at <http://www.electricsheep.org/>. \
1263 See that web site for configuration information.