X-Git-Url: http://git.hungrycats.org/cgi-bin/gitweb.cgi?p=xscreensaver;a=blobdiff_plain;f=README;h=fe349aa757f71b8ab1d61c5fa2b16d2aca77ab85;hp=1a27506e84a3eb14a8f24c925fc83bdb7bfc154b;hb=6b1c86cf395f59389e4ece4ea8f4bea2c332745b;hpb=bbd0773f2adde4927a6196361d4061e70bf48cd9 diff --git a/README b/README index 1a27506e..fe349aa7 100644 --- a/README +++ b/README @@ -1,81 +1,266 @@ 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.) - -If you have libraries in non-standard places, you can specify their -locations with options like this: - - ./configure --with-motif=/opt/Motif --with-xpm=/usr/local + By Jamie Zawinski + and many others -On MacOS X, it is strongly recommended that you install Fink first -(http://fink.sourceforge.net/). With Fink installed, you probably want -to pass --prefix=/sw to configure. - -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.4 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 160 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.04: * New hacks, `cubicgrid', `hypnowheel', and + `lcdscrub' (which isn't really a screen saver). + * Updates to `m6502' and `gears'. + * Fixed double-buffering problems in `cubestorm' and + `noof'. + * Better handling of horizontal scroll wheels. + * Attempt to work around latest Xinerama braindamage: + if the server reports overlapping screens, use the + largest non-overlapping rectangles available. + * Don't warning about receipt of bogus ClientMessages, + since Gnome's just never going to stop sending those. + * Worked around MacOS 10.5 perl bug that caused the + text-displaying hacks to fail on some systems. + * Hopefully fixed font-related System Preferences crashes + in MacOS savers. + * The recent PAM changes broke the "Caps Lock" warning + in the password dialog, the failed login warnings, and + syslogging. Fixed all that. +Changes since 5.03: * Fixed a possible crash in the unlock dialog (more + fallout from the recent PAM changes...) + * New hacks, `moebiusgears', `abstractile', and + `lockward'. + * Rewrote `gears' to use better (involute) gear models, + and to be more random. + * Minor updates to `cwaves', `voronoi', `deco', + `glcells', `rd-bomb', `fireworkx' and `webcollage'. + * `pong' can now display the current time as the score. + * `xmatrix -mode pipe' works better. + * Minor tweaks for compilation on MacOS 10.5.0. +Changes since 5.02: * New hacks, `cwaves', `glcells', `m6502', and `voronoi'. + * Minor fixes to `bsod'. + * Fixed possible crash with PAM USB-dongle auth. + * Updated `webcollage' to track recent Google Images + and Flickr changes. +Changes since 5.01: * Reworked PAM code to support fingerprint readers, etc. + * Ported 'webcollage' to OSX. + * Added OSX 10.2 and 10.3 kernel panics to `bsod'. + * Fixed a Xinerama crash when changing the screen count. + * New blobbier `mirrorblob'. + * Minor updates to `lisa', `bsod', `ifs', `hypertorus', + `polytopes', `circuit', `endgame', `crackberg', + `flipflop', `flipscreen3d', `fliptext', and `carousel'. + * Enabled multi-threaded OpenGL on OSX. +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