X-Git-Url: http://git.hungrycats.org/cgi-bin/gitweb.cgi?p=xscreensaver;a=blobdiff_plain;f=README;h=1d6d93cba76d97f9d7a359f9d6584d9dcc1b1af4;hp=1d05026f576b48b10b92acb8c4d9418d525f4b85;hb=07faf451b99879183ed7e909e43a0e065be1ee7f;hpb=3f9592851ce4ed76a9979bfdd6ec7dc5c457e183 diff --git a/README b/README index 1d05026f..1d6d93cb 100644 --- a/README +++ b/README @@ -1,75 +1,332 @@ XScreenSaver - a screen saver and locker for the X window system - by Jamie Zawinski + a collection of + free screen savers + for X11 and MacOS - http://www.jwz.org/xscreensaver/ - -To build on Unix: - - - ./configure - - make - - make install - -The `configure' shell script will attempt to figure out which options are -appropriate for your system, and will create config.h and the various -Makefiles for you. Run `configure --help' to see how to override these -choices, or to specify things like the default installation directory. -The file `INSTALL' gives a general overview of use of these sorts of -configure scripts (those generated by the GNU autoconf system.) -The most important hint is probably this: - - ./configure --with-motif=/opt/Motif --with-xpm=/usr/local + By Jamie Zawinski + and many others -To build on VMS, see README.VMS. - -If you think you've found a bug, please let me know! No bug report is too -small. But first, please read the enclosed `README.debugging' file to find -out what kind of information would be most helpful to include in your bug -report. - -Getting Started: - -You can try out xscreensaver like so: + http://www.jwz.org/xscreensaver/ - xscreensaver & - xscreensaver-demo +=============================================================================== -The XScreenSaver suite of applications uses a client-server model: -The `xscreensaver' program is a daemon that runs in the background; -it is controlled by the foreground `xscreensaver-demo' program. +This is the XScreenSaver source code distribution. It is strongly recommended +that you install a binary release rather than trying to compile it yourself. +Binaries are available for almost all platforms, including MacOS X. See the +XScreenSaver web site for details. -xscreensaver has an extensive manual -- please read it! +To compile on a Unix system with X11: - ============ + ./configure + make + make install -The xscreensaver daemon waits until the keyboard and mouse have been idle -for a period, and then runs a graphics demo chosen at random. The demo is -terminated as soon as there is any mouse or keyboard activity (or, in -locking mode, when the proper password is typed.) +To compile on MacOS X: -It is trivially easy to add new display modes to xscreensaver: any program -which can be invoked in such a way that it draws on the root window of the -screen can be used as a screensaver. You just change a config file -- -there's no need to recompile or reinstall anything. + Use the included XCode project. Requires XCode 2.2 and MacOS X 10.4.0 + or newer. - ============ +Interested in writing a new screen saver? -Along with the xscreensaver daemon itself, this package also includes -numerous graphics hacks for use as screensavers. There is nothing -magic about these: they are just programs that draw on the root window. -More than 140 such programs are included. For details, see the -xscreensaver web page, or the enclosed manual pages. + See the README.hacking file. -The latest version of xscreensaver is always available on the web at -http://www.jwz.org/xscreensaver/. +=============================================================================== -Looking for tips on writing your own screensavers? There is an entry in -the XScreenSaver FAQ about that: http://www.jwz.org/xscreensaver/faq.html +XScreenSaver has an extensive manual -- please read it! - ============ +=============================================================================== +Changes since 5.00: * Backed out recent locale-related changes, since they + broke far more things than they fixed. + * Fail gracefully with ridiculously small window sizes. + * `xflame' and `flag' ignore bitmap option on MacOS. + * `speedmine' prefs work on MacOS. + * Better explosions in `boxed'. + * More dynamic motion in `sproingies'. + * More options in `flipflop'. + * Minor updates to `topblock'. + * Various other minor fixes. +Changes since 4.24: * Ported to MacOS X! (10.4.0 or newer) + * API change: instead of providing a single screenhack() + function that does not return, screen savers using the + screenhack.h framework must now provide "init" and + "draw one frame" functions instead. All bundled savers + have been updated; third-party patches will need work. + * All image-loading happens asynchronously. + * xscreensaver-getimage-file caches the contents of the + image directory for a few hours, so consecutive runs + won't have to re-list the whole directory tree. + * New hacks, `topblock' and `glschool'. + * Removed `xteevee' (superceded by `xanalogtv'). + * Added variable-sized puzzle pieces to `jigsaw'. + * Changes to the defaults and command-line options of + many hacks to make the .xml files more consistent. + * Reap zombies in `glslideshow' and `carousel'. + * `sonar' works without setuid on OSX (dgram icmp). + * `xmatrix -mode pipe' displays the text of a subprocess. + * `endgame' has higher resolution chess-piece models. + * `webcollage' takes a -directory option to get images + from a local directory. + * The RPM spec file no longer auto-restarts xscreensaver + when a new version is installed. Restart it manually. +Changes since 4.23: * New versions of `cube21', `glsnake', `celtic'. + * Backed out a DPMS-related patch that cause desktop + flickering with some X servers. + * Fixed startup crash in getgroups() when running setuid. + * Default to not displaying stderr on the saver window. + * Fixed bad free() in "Documentation" button. + * Don't try to run hacks that aren't installed. + * Minor fixes to various XML config files and man pages. +Changes since 4.22: * New hacks, `glhanoi', `cube21', `timetunnel', + `juggler3d', and `celtic'. + * New versions of `tangram', `webcollage', `hypertorus', + `polytopes', and `ripples'. + * `sonar' is now quiet about unresolvable hosts. + * Minor corrections to BASIC code in `apple2'. + * xscreensaver-demo now provides an RPM clue when none + of the hacks seem to be installed. + * Don't install `ant' by default, since there is some + Java tool of that name, which was causing confusion. + And also it's boring. + * Made screen grabbing work again on MacOS 10.4.2. + * No longer prints bogus warnings about ClientMessages + intended for the window manager. + * Ignore unprintable characters in passwd entry field. + * Fixed yet another cross-host-display image-loading + endian problem. + * `xscreensaver-command -watch' and `-time' now work + on 64-bit machines. +Changes since 4.21: * Fixed a bug in the new mouse-motion code that caused + the screen to never blank on multi-head non-Xinerama + systems. Oops. + * New hacks, `interaggregate', `antmaze', `tangram', + and `crackberg'. + * Minor tweaks to `fiberlamp', `ifs', `slidescreen', + `zoom', `sonar', `fireworkx', `whirlwindwarp', + `bubble3d', and `rd-bomb'. + * Added motion blur to `blinkbox'. + * `bsod' now includes Longhorn's "RSOD", and OS/2. + * Fixed `-wireframe' usage in most hacks and man pages. +Changes since 4.20: * New hack: `fliptext'. + * Changed default configure installation directories: + /usr/bin/ for xscreensaver, etc.; + /usr/libexec/xscreensaver/ for hacks; + /usr/share/xscreensaver/config/ for xml files. + * All the text-manipulating screen savers can have their + text source configured via `xscreensaver-demo' now. + * xscreensaver.spec now builds three RPMs: + base (no hacks); extras (2d hacks); and gl-extras. + * Added `-program' and `-front' option to `gltext'. + * Added `-shells' to `molecule'. + * Fixed text-alpha glitch in `carousel'. + * New `pacman': the ghosts can be killed now. + * Fixed a bug in screen-grabbing GL hacks where images + would be tiled instead of scaled on machines that + can't do large textures. + * `webcollage' can hit Flickr now. + * New (rewritten) implementation of `ifs'. + * The unlock dialog can be made to have a "New Login" + button that will run `gdmflexiserver'. Experimental! + * Fixed non-ASCII display bug in `starwars'. + * Configure finds a default for imageDirectory. + * "xscreensaver-command -lock" now works even if + in "screensaver disabled" mode. + * If a bad password is typed while CapsLock is on, the + unlock dialog says "CapsLock?" instead of "Sorry". + * Mouse motion only counts as activity if the mouse moved + more than 10 pixels (so the screen won't unblank every + time you bump your desk.) + * New mode option "random-same": if you have multiple + monitors, this will run the *same* randomly chosen + hack on each screen, instead of different ones on each. +Changes since 4.19: * New hacks, `fiberlamp', `boing', `boxfit', and + `carousel'. + * Rewrote `glslideshow' again: should be faster now. + * Sped up loading of images in GL programs. + * `starwars' uses texture-mapped fonts now. + * New `bsod' modes: tru64, hppa, and nvidia. + * Updates to `webcollage', `juggle', `pinion', + `fireworkx', `sonar', `extrusion', `substrate', and + `pong'. +Changes since 4.18: * New hacks, `substrate', `intermomentary', `fireworkx', + and `pinion'. + * New version of `flow'. + * Made /proc/interrupts work again on Linux 2.6. + * Made `analogtv' not hog the CPU. + * Made analogtv-based hacks work properly on PPC/ARM. + * Fixed a bad memory leak in `piecewise'. + * Minor updates to `sonar', `molecule', `glmatrix', + `galaxy', and `webcollage'. + * Removed support for GTK 1.x (everyone uses 2.x now.) +Changes since 4.17: * Oops, pay no attention to the man behind the curtain. +Changes since 4.16: * New hacks, `anemotaxis' and `memscroller'. + * Fixed a bad bug that caused `vidwhacker' to never die. + * Fixed normals and lighting in `polyhedra'. + * Don't reuse the window when changing hacks (to work + around bugs in some GL implementations.) + * Made `xscreensaver-getimage-file' skip thumbnail-sized + images. + * Fixed endian problem in `barcode' on non-x86. + * Updates to `webcollage', `apple2', `fuzzyflakes', + `atunnel', and `pacman'. + * Timing tweaks to `bubble3d', `bouncingcow', `engine', + `gltext', `lavalite', `molecule', `spotlight', + `sballs', `boxed', `blinkbox', and `circuit'. + * Configure updates for Fedora core 2 / xorg 6.7.0. + * Compile without warnings under gcc 3.3.3. + * I give up: don't blank or lock the screen if we can't + get a keyboard grab. In that case, both choices are + bad. +Changes since 4.15: * New hacks, `polyhedra', `fuzzyflakes', `antinspect', + and `providence'. + * Minor updates to `webcollage', `bsod', `endgame', + `antspotlight', `xmatrix', and `glmatrix'. + * Added support for the RANDR (Resize and Rotate) + extension to detect when the size of the desktop has + been changed while xscreensaver is already running. + * Possibly-futile attempt to work around "rdesktop" + focus/grab idiocy. + * Made `xscreensaver-getimage -file' still work even if + imageDirectory is unset. + * Convert Latin1 to ASCII in `starwars' and `phosphor' + (since the GLUT font only has ASCII glyphs.) + * Fixed randomization in `noof'. + * Added "GetViewPortIsFullOfLies" preference to work + around longstanding XFree86 bug #421. + * Made `sonar' subnet pinging work properly on bigendian + machines (e.g., PPC.) +Changes since 4.14: * New hacks, `wormhole', `mismunch', `noof', and + `pacman'. + * `phosphor' and `apple2' include vt100 emulators now: + this means you can do "phosphor -program top", or + can use either program as an xterm replacement: + "apple2 -text -fast -program 'xemacs -nw'". + * `analogtv' (and related) fill the screen better. + * The '-gradient' option works in `atlantis' now. + * Minor updates to `blinkbox', `queens', `endgame', + `glmatrix', `mirrorblob', `blocktube', and `molecule'. + * Integrated SuSE's "external passwd helper" support. + * Marginally better /tmp handling in various programs. + * Updated config defaults for xplanet 1.0.3. + * Portability fixes. +Changes since 4.13: * New hacks, `fontglide', `apple2', `xanalogtv', `pong', + `gleidescope', `mirrorblob', and `blinkbox'. + * New version of `glsnake' (with many more models.) + * Another Windows crash in `bsod'; also HVX/GCOS6/TPS6. + * New version of `endgame'. + * Screen grabbing works on MacOS X. + * Various minor fixes. +Changes since 4.12: * On Xinerama systems, xscreensaver now runs one hack on + each monitor (just like in "real" multi-head mode) + instead of running one hack stretching across all the + screens. Note that for this to work with any 3rd party + screensavers, they must update their "vroot.h" file. + * `webcollage' and `vidwhacker' display images using + `xscreensaver-getimage' now. + * Added `ljlatest' script for use with `starwars' and + `phosphor'. +Changes since 4.11: * New GL hacks, `flipflop', `antspotlight', and + `polytopes'. + * Added VMS to `bsod'. + * Compile without warnings in "gcc -pedantic". + * Updates to `webcollage' and `queens'. + * Fixed a bug that could cause PAM to hang. +Changes since 4.10: * New hacks, `hypertorus', `cubestorm', `glknots', + `blocktube', and `glmatrix'. + * Updates to `cloudlife', `engine', `xmatrix', and + `sonar'. + * Rewrote `glslideshow': it should work on somewhat + wimpier video cards now. + * Various portability tweaks. +Changes since 4.09: * New hacks, `cloudlife' and `klein'. + * Added Apple ][+, HPUX, and OS/390 sessions to BSOD. + * Added some Matrix Reloaded text to `xmatrix'. + * Updates to `webcollage', `eruption', `jigglypuff', + `metaballs', and `endgame'. + * Completely ignore the `memoryLimit' setting now, + since it was still causing people GL grief. + * Various minor fixes. +Changes since 4.08: * New hacks, `flyingtoasters', `bouncingcow', + `jigglypuff', and `glslideshow'. + * More models in `engine'. + * Rewrote `xscreensaver-getimage' to remove reliance on + external image loaders (xv, chbg, xloadimage, etc.) + and to reduce flicker when loading files. + * Made `gflux' and `flipscreen3d' be mouse-spinnable. +Changes since 4.07: * New hacks, `atunnels' and `piecewise'. + * Physics improvement in `fluidballs'. + * Various fixes for XDarwin systems (X11 on MacOS X.) + * Added -clock option to `barcode'. + * Minor fixes to `endgame', `flurry', `flipscreen3d', + and `gflux'. +Changes since 4.06: * New hacks, `flurry', `metaballs', `eruption', + `popsquares', and `barcode'. + * Minor updates to `maze' for high density mazes. + * Added double buffering to `fluidballs' and `whirlygig'. + * Bug fixes for running xscreensaver to a remote XFree86 + display (which nobody would ever do...) + * Updated `webcollage' (faster Alta Vista searching.) + * Updated `glplanet' so the sun sets in the west. + * Updated `sproingies' with smooth, unsegmented surfaces. + * Fixed Perl version-sensitivity in + `xscreensaver-getimage-file'. + * Fixed GTK2 scrolling bug in `xscreensaver-demo'. +Changes since 4.05: * New hack, `glblur' (disabled by default, since it + requires fast OpenGL texture support.) + * New hack, `halftone'. + * Updates to `endgame', `queens', `bumps', `glplanet', + `engine', and `circuit'. + * New version of `menger' that uses far fewer polygons. + * Fixed minor bug in `critical' that could cause some + bogus X servers to crash. + * Better labels in `molecule': the labels now appear to + be attached to the atoms, instead of floating in front + of the whole scene. + * Fixed bug that could rarely cause GL hacks to fail to + double-buffer (causing intermittent flickering.) + * Fixed a relative-URL-parsing bug in `webcollage'. + * Fixed a bug that (sometimes) caused the window manager + close box to kill `xscreensaver-demo' with a crash + instead of a graceful exit. + * Updated xscreensaver.pam to the Red Hat 7.3 way. + * More Gnome2-related configure crap. + * Updated to latest `config.guess' and `config.sub'. + * Fixed occasional core dump in `distort'. + * Added a Linux fsck failure and kernel panic to `bsod'. + * Added MacOS X kernel panic to `bsod'. + * Fixed a bug in `bsod' (all bsod bugs are ironic.) + * Fixed a bug that caused `xscreensaver-gl-helper' to + print a nonsense visual ID with some versions of + `printf': this could cause GL programs to display + incorrectly (e.g., flickery.) +Changes since 4.04: * More `configure' tweaks to try and get things working + on systems that both Gtk 1.x and 2.x installed. + * New hack, `endgame'. + * Minor updates to `gltext'. +Changes since 4.03: * Support for GTK 2.x / GNOME 2.x. + * The `configure' script will now use `pkg-config' if + you have it, in preference to `gtk-config', etc. + * New hacks, `lavalite', `queens', and `anemone'. + * Minor updates to `spheremonics', `gltext', `xmatrix'. + * You can use the mouse to manually spin most of the GL + hacks now (when they are displaying in a window.) + * Fixed a bug in `webcollage' (due to recent Alta Vista + url changes) that was causing it to try and load + incorrect image URLs. + * Made `xscreensaver-getimage' use gdk_pixbuf if it is + available: this means that those hacks that load images + will no longer rely on "xv", "xloadimage", etc. This + will close a race condition that could sometimes cause + your desktop background to be changed; and also makes + it possible for those programs to operate on image + files when running in windowed mode. + * `webcollage' can now be used in conjunction with + `driftnet' to display images snooped from your local + ethernet instead of obtained from search engines. + * Added man pages for all the hacks that didn't have + them. Changes since 4.02: * New hack, `spheremonics'. * Minor updates to `webcollage', `cage', `moebius', `morph3d', `boxed', `circuit', and `helix'.