X-Git-Url: http://git.hungrycats.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=README;h=1e98c0a8e11c08fd56726f7a7862c069ae1d4c03;hb=4ade52359b6eba3621566dac79793a33aa4c915f;hp=0df5d6857e5a7e14e7d16cc272f802f72cfc24be;hpb=0d6b320def9180cf907ceaed56b23a972a11b757;p=xscreensaver diff --git a/README b/README index 0df5d685..1e98c0a8 100644 --- a/README +++ b/README @@ -1,81 +1,276 @@ 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 - -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. + 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 4 and MacOS X 10.5 + 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 200 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.21: * New hacks, `kaleidocycle', `quasicrystal', + `unknownpleasures' and `hexadrop'. + * Performance improvements for `interference'. + * Fixed possible crashes in `apple2', `maze', `pacman', + `polyominoes', `fireworkx', `engine'. + * Fix for `bumps' in 64 bit. + * Fixed preferences crash on old iOS 5 devices. + * Fixed "Shake to Randomize"; display name of saver. + * Fixed weirdness with "Frame Rate" sliders on iOS. + * Fixed rotation problems with `pacman', `decayscreen'. + * Better dragging in `fluidballs'. + * Ignore rotation in hacks that don't benefit from it. + * Ignore DEACTIVATE messages when locked, instead of + popping up the password dialog box. +Changes since 5.20: * Changed default text source from Twitter to Wikipedia, + since Twitter now requires a login to get any feeds. + * New version of `fireworkx'. + * Minor fixes to `distort', `fontglide', `xmatrix'. + * New MacOS crash in `bsod'. + * New mode in `lcdscrub'. +Changes since 5.19: * Support for iPhone 5 screen size. + * Fixed modifier key handing in Apple2.app and + Phosphor.app on MacOS. + * Various minor bug fixes. +Changes since 5.18: * MacOS 10.8.0 compatibility. + * iOS performance improvements. +Changes since 5.17: * iOS responds to shake gestures to randomize. + * iOS can load images from your Photo Library. + * iOS has clickable Wikipedia links in Settings panels. + * Made `pipes' be ridiculously less efficient, but spin. + * Added better mouse control to `rubik', `cube21', + `crackberg', and `julia'. + * Cosmetic improvements to `queens' and `endgame'. + * `sonar' can now ping local subnet on DHCP. + * Most savers now resize/rotate properly. + * Various fixes. +Changes since 5.16: * More iOS tweaks. + * Fixed some compilation problems. + * Enlarged the texture image for `lament'. +Changes since 5.15: * Ported to iPhone and iPad. + * XInput devices now also ignore small mouse motions. + * Loading images via RSS feeds is much improved. + * Various minor fixes. +Changes since 5.14: * New hacks, `hilbert', `companioncube' and `tronbit'. + * Image-manipulating hacks can now load from RSS or Atom + feeds: `imageDirectory' may contain a URL. + * Updated `webcollage' for recent search engine changes. + * `phosphor' and `apple2' can now be run as standalone + terminal emulator applications on MacOS. + * `photopile' sped up. + * New molecule in `molecule'. + * "Upgraded" to XCode 4.0, which means that MacOS 10.4 + PPC builds are impossible, and Intel is now required. + * Turned on LC_CTYPE on Linux; maybe Japanese password + entry works now? +Changes since 5.13: * Fixed crash in Blank Only Mode when DPMS disabled. + * Added "Quick Power-off in Blank Only Mode" option. + * BSOD GLaDOS. +Changes since 5.12: * Optionally enabled full-scene OpenGL antialiasing. + Set the resource `*multiSample' to true if doing so + doesn't kill performance with your video hardware. + * New version of `glhanoi'. + * Image-loading hacks that display the file name now also + display the sub-directory (xscreensaver-getimage now + returns relative paths under imageDirectory). + * Passwords that contain UTF-8 non-Latin1 chars are now + typeable. + * Numerous minor stability fixes. +Changes since 5.11: * Big speed improvement on OSX for heavy XCopyArea + users (`xmatrix', `moire2', `phosphor', etc.) + * Plugged a bad OSX-only Pixmap leak. + * Kludged around the OSX pty bug that caused text to + be truncated in phosphor, starwars, apple2, etc. + * New molecule in `molecule'. + * `glhanoi' now supports an arbitrary number of poles. + * Turned on "New Login" button by default. + * Added support for XInput-style alternate input devices. +Changes since 5.10: * New versions of `photopile', `strange'. + * Worked around MacOS 10.6 garbage collector bug that + caused the screen saver process to become enormous. + * Fixed flicker in `pipes', `cubestorm', and `noof'. + * Fixed EXIF rotation on MacOS 10.6. + * Fixed desktop-grabbing when screen locked on MacOS. + * Minor fixes to `circuit', `polyhedra', `tangram', + `gears', `pinion', `substrate', `xanalogtv'. + * Fixed some leaks in `xanalogtv' and `apple2'. + * Better seeding of the RNG. +Changes since 5.09: * Fixed some crashes and color problems on MacOS 10.6. + * Retired `hypercube' and `hyperball', which are + redundant with `polytopes'. +Changes since 5.08: * Ported to MacOS 10.6, including various 64-bit fixes. + * New hack, `rubikblocks'. + * Fixed another potential RANDR crash. + * Use correct proxy server on MacOS. + * `molecule' now correctly displays PDB 3.2 files. + * Updates to `mirrorblob', `glhanoi', and `sonar'. + * Rewritten version of `klein' hack. + * New hack, `surfaces', incorporating objects from old + `klein' hack, plus new ones. + * Merged `juggle' and `juggler3d' hacks. + * Fixed compilation under gcc 4.4.0 (strict aliasing). + * Fixed intermittent failure in `xscreensaver-command'. +Changes since 5.07: * New hack, `photopile'. + * Rewrote `sonar' and `jigsaw' as OpenGL programs. + * Minor tweaks to `maze', `m6502', `hypnowheel', and + `timetunnel'. + * Savers that load images now obey EXIF rotation tags. + * Arrgh, more RANDR noise! Fixes this time for rotated + screens, and for systems where RANDR lies and says the + screen size is 0x0. + * When the password dialog has timed out or been + cancelled, don't pop it right back up a second time. + * Password timeouts/cancels don't count as + "failed logins". + * Retired some of the older, less interesting savers: + say goodbye to `bubbles', `critical', `flag', `forest', + `glforestfire', `lmorph', `laser', `lightning', `lisa', + `lissie', `rotor', `sphere', `spiral', `t3d', `vines', + `whirlygig', and `worm'. + * Merged `munch' and `mismunch'. + * Updated `webcollage' to use twitpic.com as well. +Changes since 5.06: * Xinerama/RANDR tweaks for old-style multi-screen. + * Added bumpy skin and cel shading to `skytentacles'. + * `flipflop' can load images onto the tiles. + * Fixed the bouncing ball in `stairs'. + * Added the missing Utah Teapotahedron to `polyhedra'. + * `blitspin' works with color images on MacOS now. + * Added transparency to `stonerview'. + * Improved layout of the preferences dialogs: they + should all now be usable even on ridiculously tiny + laptop screens. + * MacOS preferences text fields now prevent you from + entering numbers that are out of range. + * Added "Reset to Defaults" button on X11. + * Added relevant Wikipedia links to many of the screen + saver descriptions. + * All hacks support the `-fps' option, not just GL ones. + * The `-fps' option now shows CPU load. +Changes since 5.05: * Xinerama/RANDR fixes: this time for sure. It should + now work to add/remove monitors or resize screens at + any time. + * New hack, `skytentacles'. + * New version of `gleidescope'. + * Added the `-log' option to the xscreensaver daemon, + since a truly shocking number of Linux users seem to + have no idea how to redirect output to a file. + * Added `-duration' arg to most image-loading hacks, + so that they pick a new image every few minutes. + * Added an ATM crash to `bsod'. +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 MacOS. + * Added MacOS 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 MacOS. +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 MacOS (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', @@ -238,7 +433,7 @@ Changes since 4.10: * New hacks, `hypertorus', `cubestorm', `glknots', 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 Apple ][+, HPUX, and OS/390 sessions to `bsod'. * Added some Matrix Reloaded text to `xmatrix'. * Updates to `webcollage', `eruption', `jigglypuff', `metaballs', and `endgame'.