xcowsay

package: xcowsay

title: xcowsay(6)

summary: Display a cute cow and speech bubble.

text:
# xcowsay(6)

## NAME
xcowsay - Display a cute cow and speech bubble.

## SYNOPSIS
xcowsay [-h] [-t time] [-r speed] [-d] [-f font] [text]...

## DESCRIPTION
Display a cow with a speech bubble containing some text. If text is specified it will be displayed in the bubble. Otherwise the text will be read from the standard input and displayed when end of file is encountered.

The cow is displayed for either a fixed amount of time, or an amount of time calculated from the size of the text. Click on the cow to dismiss it immediately.

If xcowsay is started with --daemon it will fork away from the terminal and run in daemon mode. The daemon provides a DBus service uk.me.doof.Cowsay that responds to ShowCow requests. The daemon can queue up any number of requests and displays them in order.

When xcowsay starts it checks to see if a daemon is running, and if it is, sends a ShowCow request and returns immediately. Otherwise xcowsay will block until the cow has disappeared.

## CONFIGURATION FILE
xcowsay reads a configuration file on startup. The configuration file can be stored in the XDG compliant location $XDG_CONFIG_HOME/xcowsayrc (which will default to $HOME/.config/xcowsayrc) or in your home directory at $HOME/.xcowsayrc. If the --config=FILE command line option is passed FILE will be processed after your personal configuration file.

The configuration file consists of 'option = value' pairs, one per line. The valid keys are given in the next section. For example, the following line sets display time to 10 seconds:

display_time = 10000

The character '#' begins a comment which lasts until the end of the line.

Values containing spaces should be enclosed in quotes. For example:

font = "mono 28"

## OPTIONS
Note that these options override any settings in the config file.

-h, --help

Display usage information.

-t time, --time=time

Display the cow for time seconds. This overrides any value set for reading_speed. Setting time to zero displays the cow until it is clicked. The corresponding config file option is display_time. This can also be set to a fractional value like 0.5.

-r speed, --reading-speed=speed

Number of milliseconds to display the cow for each word in the input text. This is clamped to a minimum of min_display_time and a maximum of max_display_time. The defaults are 1 second and 30 seconds respectively. The corresponding config file option is reading_speed.

-f font, --font=font

Font for the speech bubble text. Accepts Pango font strings. The corresponding config file option is font.

-d file, --dream=file

Display an image instead of text in the cow's bubble. The dream_time config file option sets the numer of milliseconds to display the image for. The default is 10 seconds.

--think

Display a thought bubble instead of a speech bubble.

--daemon

Run xcowsay in daemon mode if DBus support has been enabled. See the DESCRIPTION section above for more information.

--cow-size=size

Size of the cow image. Current choices are small, med, or large. The corresponding config file option is cow_size.

--image=file

Use a different image instead of the cow. The corresponding config file option is alt_image.

--monitor=N

Make the cow appear on monitor N.

--at=X,Y

Force that cow to appear at screen location (X,Y). The config file options are at_x and at_y.

--bubble-at=X,Y

Change position of bubble relative to where it would normally appear. This is most useful when combined with the alt_image option to create your own characters. The config file options are bubble_x and bubble_y.

--no-wrap

Disable word wrapping when the bubble is too wide to fit on the screen. The config file option wrap can be set to true or false to set this explicitly.

-l, --left

Make the bubble appear on the left hand side of the cow. This is useful if you are using your own image.

--debug

Print messages about what xcowsay is doing. Useful for finding out why the daemon fails.

--release

Close window on release event instead of press. The corresponding config file option is close_event=button-release-event.

-v, --version

Print version information.

## AUTHOR
Written by Nick Gasson.

## REPORTING BUGS
Report all bugs to nick@nickg.me.uk The xcowsay home page is <http://www.doof.me.uk/xcowsay>

## SEE ALSO
cowsay(6)

branch: sisyphus


xfreecell

package: xfreecell

title: xfreecell(6)

text:
# xfreecell(6)

## NAME
xfreecell - Another implementation of the famous solitaire game

## SYNOPSIS
xfreecell [options]

## DESCRIPTION
xfreecell is an another implementation of the famous solitaire game.

### OPTIONS
-a | --no-animation

Less animation. Toggling 'Anim' in pref has the same effect.

-m | --ms-seed

MS-seed-number mode. You can play the same game as MS freecell. The default is false. Toggling 'MS Seed' in pref has the same effect.

-q | --query-window

Query window mode. In this mode, query window pops up when both single and multiple cards movement is possible. The default is false. Toggling 'Query' in pref has the same effect.

-r | --no-round-card

No round cards. Shape extension is heavy, so this option will speed up the game.

-s | --speedup speed

Specifiy the speed of card movement. The bigger the faster. Default value is 100.

-v | --version

Display the version.

## CONTROL
Double Click

Moves the card to freecell. Same as windows.

Button 2

Same as Double click. Recommended for 3-button mouse owners. Eases the load of your finger.

Button 3(card)

Moves the card to foundation.

Button 3(empty pile)

Moves multiple cards to the empty pile. There are two modes to move multiple cards to an empty pile. One is to use Button3 stated above. The other is to use query window which asks 'Single or Multiple'. The default is Button3 mode. To use query window mode, press pref->toggle query->press Ok. Or start xfreecell with option '-q'.

## BUTTONS
New

Begins a new game randomly. Previously played games excluded.

Replay

Replays last game.

Seed

Begins a new game which corresponds to the number you typed.

Lost

Replays a lost game selected randomly.

Undo

Does undo.

Score

Pops up score window.

Pref

Pops up preference window.

About

Pops up about window.

Exit

Exits from game.

## SCORE
Winning increases 10 points. Defeat decreases 10 points. Each continuous winning increases 1 point. Each continuous defeat decreases 1 point. Undo decreases 1 point.

## ABOUT SEED
From version 1.0.4, you can seed a game. But there is no guarantee about the uniqueness. If you hit upon an algorithm which guarantees the uniqueness, please send me. I'm currently using the algorithm of Microsoft Freecell (see mshuffle.txt).

Instead of using srand() and rand() in libc, I use NSsrand() and NSrand() I implemented to make the seed numbers compatible over many Unices. If you want to use srand() and rand(), remove -DBOGUSRANDOM from makefile.

The check whether you played or not is not done in different seed-num modes. That is, if you played a game in MS-seed-num mode, you may play the same game in original-seed-num mode. But the possibility is very low because there are too many games and there are only 32000 games in MS-seed-num mode.

To play MS-seed-num mode, start xfreecell with option '-m' or toggle 'MS Seed' in pref.

## FILES
~/.xfreecell/score

Score file.

~/.xfreecell/prefs

Saves your preferences.

~/.xfreecell/won

Won game numbers.

~/.xfreecell/lost

Lost game numbers.

~/.xfreecell/msWon

Won game numbers. (MS freecell seed number)

~/.xfreecell/msLost

Lost game numbers. (MS freecell seed number)

~/.xfreecell/msNumPath

Path to data file called MSNumbers.

## AUTHOR
Nakayama Shintaro <nakayama@giganet.net>


xmahjongg

package: xmahjongg

title: xmahjongg(6)

summary: colorful solitaire Mah Jongg game

text:
# xmahjongg(6)

## NAME
xmahjongg - colorful solitaire Mah Jongg game

## SYNOPSIS
xmahjongg [--display display] [options]

## DESCRIPTION
Real Mah Jongg is a social game that originated in China thousands of years ago. Four players, named after the four winds, take tiles from a wall in turn. The best tiles are made of ivory and wood; they click pleasantly when you knock them together. Computer Solitaire Mah Jongg (xmahjongg being one of the sillier examples) is nothing like that but it's fun, or it must be, since there are like 300 shareware versions available for Windows. This is for X11 and it's free.

## HOW TO PLAY
The object is to remove all Mah Jongg tiles from the playing field by taking one matching pair at a time. Generally, two tiles match if they have identical pictures on top. There are some exceptions: any season tile (spring, summer, autumn, or winter) matches any other season, and any flower tile (bamboo, orchid, plum, or chrysathemum) matches any other flower. There are 144 tiles in all -- one of each season and flower, and four copies of each of the following: 1 to 9 dots; 1 to 9 bamboo sticks; characters for 1 to 9; the four winds (north, south, east, and west); and three dragons (red, green, and white).

Only free tiles can be removed. A tile is free if its entire top face is unobstructed and either its left or its right edge is open. (When looking at the left and right edges, only tiles on the same level count.)

The rules are simple, but winning, it turns out, can be pretty hard. It's easy to make a move that causes a stalemate thirty or more moves later. What's worse, the --any-boards option lets xmahjongg create boards that cannot be solved at all!

## CONTROLS AND APPEARANCE
To select a free tile, simply click it with the left mouse button and it will light up. Click it again to deselect it. If you try to select a non-free tile, xmahjongg will beep at you. To remove a matched pair, just select one of the pair and click on the other one. The number in the upper left corner tells you how many tiles you have left. This is all you really need to know to play the game.

Xmahjongg comes with several features that may dismay purists, but make the game more pleasant to play. First is the match count, an array of small gold coins in the upper middle. Each coin represents one potential match on the board. (If three mutually matching tiles are free, it counts as three matches, and if four are free, that's six matches.) This will let you know when the game is over (no gold coins means no matches -- a dead end) and when you're getting close.

The five buttons along the top right have the following functions:

New (keystroke: n)

Start a new game.

Quit (keystroke: q)

Quit xmahjongg.

Undo (keystroke: u)

Undoes your last move. You can undo multiple moves by clicking multiple times. If you change your mind about undoing a move, hold down Shift while you click the Undo button (or press r) to redo it.

Hint (keystroke: h)

Gives you a hint by flashing a set of free matching tiles. You can cycle through all existing matches by clicking multiple times. If you select a tile and then click Hint, xmahjongg will flash any free tiles that match that tile, or beep if there aren't any.

Clean (keystroke: c)

Cleans the board by automatically removing obvious matches. A match is obvious if it involves all the remaining tiles of a given type. (For example, if there are 2 green dragons left and they are both free, they form an obvious match; but if there are 4 left and only 3 are free, they don't.) Cleaning the board is guaranteed not to cause a stalemate later.

Solve (no button; keystroke: s)

If you get stuck, press the s key. After the board is restored to its original state, xmahjongg will show you one way to solve it by removing tiles two at a time. Press s again to speed up the solution, or press Esc to stop. This won't work if you gave the --any-boards option (see below).

Additionally, the Escape key deselects any selected tile.

## KEYBOARD TRAVERSAL
You can use the arrow keys and the spacebar to play xmahjongg without using the mouse. These keys control the cursor, which is shown as a flashing tile. The arrow keys move the cursor around on the board in the obvious directions. The spacebar is like clicking the mouse button on the cursor tile: it either selects the tile or removes a matching pair.

The hint key, `h', is also useful for playing without the mouse. Experiment with `h', the spacebar, and the Return key to see how this works. When a hint is active, the spacebar is like clicking on one of the flashing hint tiles, while the Return key is like clicking on two of them (so it removes the tiles in one stroke). This method gives the fastest playing speed.

## OPTIONS
If you get bored with xmahjongg's original layout and appearance, never fear: it comes with several tilesets (tile images) and layouts (tile arrangements). In addition to these, xmahjongg can read layout files from the original xmahjongg, KDE Mahjongg, and Kyodai Mahjongg, and tilesets in KDE Mahjongg, Gnome Mahjongg, and Kyodai Mahjongg format. (However, tilesets must be converted to GIF format before xmahjongg can read them.) See the [-l] and [-t] options.

Long option names can be abbreviated to their unique prefixes.

--number N

-n N

Start with board number N.

-l layout

--layout layout

Use the specified game layout. xmahjongg comes with several layouts. The normal layout is called default; to see the other ones' names, run `xmahjongg --list'. You can also use an arbitrary layout by giving its filename. Xmahjongg can read layouts in its own simple format, in KDE kmahjongg format, or in Kyodai Mahjongg format. (Kyodai Mahjongg is one of the more popular Windows Mah Jongg solitaire games. It's got 3D tiles and all sorts of stuff. See http://www.kyodai.com for more information. You can download a zip archive with more than 100 different layouts, mostly usable with xmahjongg, from http://www.kyodai.com/.)

--tileset tileset

Use the specified tileset to draw the Mah Jongg tiles. Xmahjongg comes with several extra tilesets, particularly small (perfect for smaller screens). There are others too; run `xmahjongg --list' for a complete listing.

--background image

--bg image

The background image is set to image. Run `xmahjongg --list' to see the backgrounds that come with xmahjongg, or use an arbitrary GIF as a background image by giving its filename.

[--list]

Lists all the layouts, tilesets, and backgrounds that came with xmahjongg, then exits.

--solvable-boards

Always create solvable boards. This is the default.

--any-boards

Allow any legal board, some of which will be solvable and some of which won't.

--display display

Sets the X display to display.

--name name

Specifies the application name under which resources are found, rather than the default ``xmahjongg''. Since xmahjongg itself does not use the resource database, this is mostly useful for communication with your window manager.

--geometry geometry

This standard X option specifies the preferred size and position for the xmahjongg window.

[--help]

Prints usage information and exits.

[--version]

Prints the version number and some quickie warranty information and exits.

## BUGS
Please email suggestions, additions, patches and bugs to eddietwo@lcs.mit.edu. The following features have not made it into 3.0 as of yet:

- Tournament mode.

- Board setup mode.

## HISTORY
xmahjongg version 3 is a complete rewrite by Eddie Kohler <eddietwo@lcs.mit.edu> of xmahjongg versions 1 and 2 by Jeff S. Young <jsy@cray.com>.

The default tileset was originally created in color by Dorothy Robinson <mokuren@teleport.com> with Mark A. Holm <markh@aracnet.com>. The publically available version was in black-and-white. Holm copyrighted the tiles in 1988, giving permission to copy and distribute for non-profit purposes. The significantly altered color version that comes with xmahjongg was created by Eddie Kohler in 1993. The `small' tileset was found at http://www.mahjongg.com/, and is presumably by Berrie Bloem. The `gnome' and `gnome2' tilesets were created by Jonathan Buzzard and Max Watson. The `dorothys' and `dorwhite' tilesets were made by Dorothy Robinson <mokuren@teleport.com>. The `real' tileset was scanned by Mark Sanctuary <sanctuary@jps.net>.

Many of the layouts are based on layouts designed for Kyodai Mahjongg, a fun Windows Mah Jongg game. In particular, `arena', `ceremonial', `deepwell', `farandole', and `theater' are by Naoki Haga, and `hourglass' and `papillon' are by Vincent Krebs. Kyodai Mahjongg's Web homepage is http://www.kyodai.com/.

## AUTHOR
Eddie Kohler, eddietwo@lcs.mit.edu

http://www.pdos.lcs.mit.edu/~eddietwo/

http://www.lcdf.org/~eddietwo/xmahjongg/

The xmahjongg home page.


xmoto

package: xmoto

title: xmoto(6)

text:
# xmoto(6)

## NAME
X-Moto—2D motocross platform game

## SYNOPSIS
xmoto [options]

xmoto [options] replay.rpl

xmoto [options] level.lvl

## DESCRIPTION
X-Moto is a challenging 2D motocross platform game, where physics plays an important role in the gameplay. You need to control your bike to its limit, if you want to have a chance finishing the more difficult of the challenges.

## GAMEPLAY
A number of strawberries are typically spread around each level, which generally consists of a complicated landscape seen from the side—i.e. much like islands in the sky. You need to collect all those berries to finish the level—when you've got the last one, you need find the sunflower which will complete the level when you touch it. Variations to this basic gameplay may be found around some of the levels.

Your motocross bike is likewise seen from the side, and you control its throttle, braking, and simple changes to the attitude by jerking the bike back and forth. Additionally you can change the direction of your driving, by rotating on the spot.

You control your bike using the keyboard. The following keys are the default values, but may be changed from inside the game:

Up arrow

Accelerate.

Down arrow

Brake.

Left arrow

Rotate counter-clockwise.

Right arrow

Rotate clockwise.

Space

Turn around and drive in the other direction.

Additionally, some other keys can be pressed while playing:

Escape

Pause the game, and open the in-game menu.

TAB

Autozoom animation. Zooms out so that you can see the whole level.

F2

Switch the camera to the ghost, so you can follow it and see how the level can be mastered.

F3

Add the current level to favorites while playing. Press again to remove from favorites.

F5

Restart the level while playing. Rebuild the database if pressed while in the main menu.

F7

Show/hide frames-per-second counter.

F8

Activate/Deactivate Internet connection.

F9

Switch to the "Ugly mode". Saves a lot of CPU time and shows some secret passages.

F10

Theme Mode. It can be used to test custom graphics. Also helps to avoid wreckers.

F11

Line Mode. This mode is mostly for testing. Draws lines around blocks and shows zones.

F12

Take a Screenshot. The file is saved into the xmoto directory.

Ctrl+i

Toggle replay interpolation. Makes replays look smoother when turned on.

Ctrl+m

Toggle mirror mode. Wanna have twice as many levels?

Ctrl+b

Blacklist/unblacklist a level while playing.

Ctrl+s

enable/disable sound.

Ctrl+o

display the option window

PgUp

Jump to the previous level while playing.

PgDown

Jump to the next level while playing.

Alt+Enter

Toggle fullscreen. Aslo changes your "run windowed/fullscreen" setting.

## OPTIONS
Most of these options also change your config settings, so be careful!

-h, -?, -help, --help

Show summary of options.

-res, --resolution <widthxheight>

Forces a specific display resolution.

-fs, --fullscreen

Forces the game to run in fullscreen mode.

-win, --windowed

Forces the game to run in windowed mode.

--nosound

Turns off sound effects, even if they are enabled in the config.

-r, --replay <replay>

Play the replay and quit afterwards.

-ri, --replayInfos <replay>

Display information about the replay and quit.

-v, --verbose

Be verbose and output debug messages on the standard output.

-l, --level id

Start playing the specified level right away. If id is a number the corresponding built-in level is selected, otherwise it should be the identifier of an external level (not the file name).

--levelFile <FILE>

Start playing the given level right away.

-d, --debug

Enables debug mode.

-p, --profile name

Use the player profile specified by name.

--children

Force children compliant mode. It removes levels not suitable for children.

--configpath path

Use path as the xmoto configuration path.

-ll, --listlevels

Output the list of available levels and quit.

-lr, --listreplays

Output the list of available replays and quit.

--fps

Enables framerate display.

-td, --timedemo

Tries to render the game as fast as possible. No delaying, maximum framerate.

--benchmark

Only meaningful when combined with --replay and --timedemo. Useful to determine graphics performance.

--nowww

Do not allow xmoto to connect to the web.

--testTheme

Enables testThemeMode. This will display the collision forms over the sprites of the theme to check if the theme is nicely designed.

--drawlib drawlib

Choose which rendering engine to use (default one is OPENGL if available). You do not need this unless you *really* know what you are doing.

--noexts

Do not use any OpenGL extensions.

--novobs

Don't use VOB OpenGL extension (GL_ARB_vertex_buffer_object).

--ugly

Enables "the ugly" mode. This will increase the game's framerate significantly, but it will also make the graphics look very ugly—most things inside the game will be drawn with lines, the rider for instance being a simple stick figure. This option is very useful if your system doesn't have a proper OpenGL-capable video card (like for instance if you have a laptop with on-board video card). If you have the right amount of CPU power, it should even be possible to run X-Moto in OpenGL software emulation mode (MesaGL on linux, Windows' OpenGL fallback driver, etc).

--defaultTheme theme

Set theme as default theme for new profiles created. This is mostly useful for packagers wanting to set the theme of their distribution by default.

--noDBDirsCheck

Don't check that system and user dirs changed at startup. It is mainly useful if you use X-Moto on a USB key.

--server

Run X-Moto as a server only (no gui).

--serverPort <port>

Specify the server port (with --server only).

--serverAdminPassword <password>

Specify a server admin password which is always valid (with --server only).

--connectAtStartup

Connect the client to the server at startup.

--updateLevelsOnly

Only update levels (no gui).

--noLog

Disable logging into xmoto.log

--pack bin dir

Build a bin package from the directory dir.

--unpack bin dir no_list

Unpack the bin package into the dir dir. Add no_list if you do not need a list of all extracted files.

--cleancache

Deletes the content of the level cache.

--cleanNoWWWLevels

Check web levels list and remove levels which are not available on the web (removed files are put into ~/.xmoto/Trash/Levels)

--sqlTrace

Enable sql trace mode.

--videoRecording

Enable video recording while plaing/replaying (should be used with --replay and --benchmark).

--videoRecordingSizeDivision DIVISION

Change video size (1=full, 2=50%, 4=25%).

--videoRecordingFramerate FRAMERATE

Change video framerate.

--videoRecordingStartTime NBCENTSOFSECONDS

Start recording video after NBCENTSOFSECONDS time elapsed.

--videoRecordingEndTime NBCENTSOFSECONDS

Stop recording video after NBCENTSOFSECONDS time elapsed.

--hidePlayingInformation

Don't show some information while playing/replaying ; useful to make nicer video.

## EXAMPLES
view a replay in windowed mode:

xmoto --windowed ~/.xmoto/Replays/replay.rpl

disable sounds, Internet connection and play mylevel.lvl directly:

xmoto --nosound --nowww mylevel.lvl

## AUTHORS
xmoto was written by Rasmus Neckelmann <neckelmann@gmail.com>, Nicolas Adenis-Lamarre <nadenislamarre@free.fr> and Emmanuel Gorse <e.gorse@free.fr>.

## REPORTING BUGS
Please open an issue on GitHub: <https://github.com/xmoto/xmoto>, or write to support@xmoto.org.

This manual page was written by Samuel Mimram <smimram@debian.org>, for the Debian project. Updated by Amand Tihon <amand.tihon@alrj.org> and AvovA.


xqf

package: xqf

title: xqf(6)

text:
# xqf(6)

## NAME
xqf - 3D action game launcher and server browser

## SYNOPSIS
xqf [options]

## DESCRIPTION
XQF is a 3D action game (such as Quake, sequels and derivatives) server browser. It uses X and is written using GTK+ 2 and uses QStat in the backend to retrieve server info.

With XQF you can search for Quake, Quake 2/3/4, Quake World, Doom 3, Return to Castle Wolfenstein, Hexen 2, Hexen World, Heretic 2, Sin, Half-Life, Kingpin, Soldier of Fortun 1/2, Tribes 2, Unreal, Unreal Tournament, Unreal Tournament 2003/2004, Rune, Descent 3, Call of Duty, NetPanzer, Unvanquished, Xonotic, Smokin'Guns, Warsow, Alien Arena, Urban Terror, Open Arena, World of Padman, ZEQ2 Lite, Enemy Territory:Legacy, Jedi Outcast, Jedi Academy and many others. You can look at lots of information about the servers. XQF can spawn your client into a selected server with customized options. You can also apply filters while searching for servers, trimming full or empty servers, for example.

## OPTIONS

XQF accepts several command line parameters:

--launch [SERVERTYPE] IP

adds the server specified with IP (e.g. 10.10.0.1:27666) to the favorites, queries it and launches the game. XQF tries to automatically determine the correct game based on the port. If the autodetections fails XQF will ask you for the game. Alternatively you may directly specify the game type on the command line (e.g. Q3S).

--add [SERVERTYPE] IP

adds the specified server to the favories and queries it. Basically the same as --launch except that the game is not launched ;-)

--debug level

set the specified debug level. Use this if you experience problems with XQF. Level 3 is usually sufficient for debugging most problems. Higher levels product lots of output.

--version

prints the version of XQF.

## SEE ALSO
qstat(1).

/usr/share/doc/xqf

## HOMEPAGE
http://linuxgames.com/xqf/ https://github.com/XQF/xqf

## COPYRIGHT
XQF is Copyright (C) 1998-2000 Roman Pozlevich.

## HISTORY
This manual page was written by Jordi Mallach and Thomas Debesse for the Debian GNU/Linux system (but may be used by others).

XQF was written by Roman Pozlevich <roma@botik.ru>, and maintained by Jordi Mallach <jordi@debian.org>, Thomas Debesse <xqf@illwieckz.net>, Bill Adams <bill@evilbill.org>, Alex Burger <alex_b@users.sourceforge.net> and Ludwig Nussel <ludwig.nussel@suse.de>.


xscreensaver-auth

package: xscreensaver

title: xscreensaver-auth(6)

text:
# xscreensaver-auth(6)

## NAME
xscreensaver - extensible screen saver and screen locking framework

## SYNOPSIS
xscreensaver-auth [--display host:display.screen] [--version]

## DESCRIPTION
The xscreensaver(1) daemon launches this program to prompt the user for their password. Do not run this program directly.

## SEE ALSO
xscreensaver(1), xscreensaver-settings(1), xscreensaver-gfx(6), xscreensaver-systemd(6).

## COPYRIGHT
Copyright © 2021-2026 by Jamie Zawinski. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

## AUTHOR
Jamie Zawinski <jwz@jwz.org>


xscreensaver-getimage

title: xscreensaver-getimage(6)

text:
# xscreensaver-getimage(6)

## NAME
xscreensaver-getimage - loads a randomly-selected image onto an X11 Drawable for use by screen savers

## SYNOPSIS
xscreensaver-getimage [--display host:display.screen] [--verbose] window-id [pixmap-id]

## DESCRIPTION
The xscreensaver-getimage program is a helper program for the xscreensaver hacks that manipulate images.

This program selects a random image, and puts it on the specified window or pixmap. This image might be a snapshot of the desktop; or a frame captured from the system's video input; or a randomly-selected image from disk.

If only a window ID is specified, the image will be painted there. If both a window ID and a pixmap ID are specified, then the image will be painted on the pixmap; and the window may be modified as a side-effect.

## OPTIONS
xscreensaver-getimage reads the ~/.xscreensaver file for configuration information. It uses these settings:

grabDesktopImages

Whether it is acceptable to grab snapshots of the desktop. The security paranoid might want to turn this off, to avoid letting people see (but not touch!) your desktop while the screen is locked.

grabVideoFrames

Whether it is acceptable to grab frames of video from the system's video input. Grabbing of video is done by invoking the xscreensaver-getimage-video(6) program.

chooseRandomImages

Whether it is acceptable to display random images found on disk. Selection and loading of images is done by invoking the xscreensaver-getimage-file(6) program.

imageDirectory

When loading images from disk, this is the directory to find them in. The directory will be searched recursively for images. It may also be the URL of an RSS or Atom feed, in which case a random image from that feed will be selected instead. The contents of the feed will be cached locally and refreshed periodically as needed.

If none of the three options are set to True, then video colorbars will be displayed instead.

## BUGS
When grabbing desktop images, the window argument will be unmapped and have its contents modified, causing flicker. (This does not happen when loading image files or video frames.)

## SEE ALSO
X(1), xscreensaver(1) xscreensaver-settings(1) xscreensaver-getimage-file(6) xscreensaver-getimage-video(6)

## COPYRIGHT
Copyright © 2001-2021 by Jamie Zawinski. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

## AUTHOR
Jamie Zawinski <jwz@jwz.org>, 14-Apr-2001


xscreensaver-getimage-file

title: xscreensaver-getimage-file(6)

text:
# xscreensaver-getimage-file(6)

## NAME
xscreensaver-getimage-file - select a random image file for use by screen savers

## SYNOPSIS
xscreensaver-getimage-file [--verbose] [--no-cache] [--flush-caches] directory-or-URL

## DESCRIPTION
The xscreensaver-getimage-file program is a helper program for the xscreensaver hacks that manipulate images. It is invoked by xscreensaver-getimage(6) as needed.

It prints the name of a randomly-selected image file. The directory is searched recursively. Non-image files and images smaller than 500x500 are excluded.

The directory may also be the URL of an RSS/Atom feed. Enclosed images will be downloaded and cached locally.

The contents of the directory are cached, for performance. The cache is re-generated if 3 hours have passed.

## OPTIONS
xscreensaver-getimage-file accepts the following options:

--verbose

Print diagnostics.

--no-cache

Ignore the cache when searching for images. This may be slow.

--flush-cache

Discard all caches immediately. They will be re-generated as needed.

directory-or-URL

If it is a pathname, it will be searched recursively for images. If it is a URL, it should be an RSS or Atom feed, or an HTML page whose metadata links to its feed. All of the feed's images will be downloaded to a local cache. The URL will be re-polled periodically, downloading any new images and removing expired ones.

## FILES
Depending on your operating system, the filename cache will be one of:

```
        $HOME/.cache/xscreensaver/xscreensaver-getimage.cache

        $HOME/tmp/.xscreensaver-getimage.cache

        $HOME/.xscreensaver-getimage.cache

        $HOME/Library/Caches/org.jwz.xscreensaver.getimage.cache
```

Images from feeds will be downloaded and cached at one of:

```
        $HOME/.cache/xscreensaver/SUBDIR/

        $HOME/tmp/.xscreensaver-feeds/SUBDIR/

        $HOME/.xscreensaver-feeds/SUBDIR/

        $HOME/Library/Caches/org.jwz.xscreensaver.feeds/SUBDIR/
```

## SEE ALSO
X(1), xscreensaver(1), xscreensaver-settings(1), xscreensaver-getimage(6)

## COPYRIGHT
Copyright © 2001-2022 by Jamie Zawinski. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

## AUTHOR
Jamie Zawinski <jwz@jwz.org>, 14-Apr-2001.


xscreensaver-getimage-video

title: xscreensaver-getimage-video(6)

text:
# xscreensaver-getimage-video(6)

## NAME
xscreensaver-getimage-video - grab a video still frame for use by screen savers

## SYNOPSIS
xscreensaver-getimage-video [--verbose]

## DESCRIPTION
The xscreensaver-getimage-video program is a helper program for the xscreensaver hacks that manipulate images. Specifically, it is invoked by xscreensaver-getimage(6) as needed.

It grabs a single frame of video from the system's video input to a file, and prints the name of that file on stdout. It does this by figuring out which frame-grabbing programs are installed on the system, and invoking the first one it finds.

## OPTIONS
xscreensaver-getimage-video accepts the following options:

--verbose

Print diagnostics.

## SEE ALSO
X(1), xscreensaver(1), xscreensaver-settings(1), xscreensaver-getimage(6), xscreensaver-getimage-file(6), atitv(1), bttvgrab(1), ffmpeg(1), gqcam(1), grab(1), motioneye(1), mplayer(1), qcam(1), streamer(1), v4lctl(1), vidcat(1), vidtomem(1).

## COPYRIGHT
Copyright © 2001-2021 by Jamie Zawinski. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

## AUTHOR
Jamie Zawinski <jwz@jwz.org>, 14-Apr-2001.


xscreensaver-gfx

title: xscreensaver-gfx(6)

text:
# xscreensaver-gfx(6)

## NAME
xscreensaver - extensible screen saver and screen locking framework

## SYNOPSIS
xscreensaver-gfx [--display host:display.screen] [--version]

## DESCRIPTION
The xscreensaver(1) daemon launches this program to blank the screen and render graphics. It is responsible for launching graphics demos as sub-processes. Do not run this program directly.

## SEE ALSO
xscreensaver(1), xscreensaver-settings(1), xscreensaver-auth(6), xscreensaver-systemd(6).

## COPYRIGHT
Copyright © 2021-2026 by Jamie Zawinski. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

## AUTHOR
Jamie Zawinski <jwz@jwz.org>


xscreensaver-systemd

title: xscreensaver-systemd(6)

text:
# xscreensaver-systemd(6)

## NAME
xscreensaver-systemd - lock the screen upon suspend, and inhibit screen-blanking during video playback.

## SYNOPSIS
xscreensaver-systemd [--verbose] [--version]

## DESCRIPTION
The xscreensaver-systemd program is a helper daemon launched by xscreensaver(1) for systemd(1) or elogind(8) integration. It does two things:

*

When the system is about to go to sleep (e.g., the laptop lid has just been closed) it locks the screen just before the system sleeps, by running xscreensaver-command --suspend. When the system wakes up again, it runs xscreensaver-command --deactivate to make the unlock dialog appear immediately. It does this through the org.freedesktop.login1(5) D-Bus interface.

*

When another process asks for the screen saver to be inhibited (e.g. because a video is playing) this program periodically runs xscreensaver-command --deactivate to keep the display un-blanked. It does this until that other program asks for it to stop, or exits. It does this through the org.freedesktop.ScreenSaver(5), org.gnome.SessionManager(5) and org.kde.Solid.PowerManagement.PolicyAgent(5) D-Bus interfaces.

## BUGS
Blanking-related problems take two forms: failing to connect to D-Bus; and other programs requesting stupid things.

### D-BUS
Only one program at a time can register with systemd(1) or elogind(8) for screen-saver-related events, so if another screen saver is running as a part of the desktop environment, xscreensaver-systemd will be unable to launch. This program has workarounds for Gnome and KDE, but if you are using something else, that might be a problem.

### CHROME & CHROMIUM (101.0)
*

Playing only audio in Chrome will prevent your screen from blanking. Chrome sends the exact same "inhibit" reason for audio as for video, so we can't tell them apart.

*

Chrome prevents your screen from blanking when playing short, looping videos. This means that your screen won't blank when Chrome is showing a Twitter page (because those animated GIFs aren't really GIFs, they are MP4s). This affects Tweetdeck as well. The proper way to fix this would be for Chrome to stop inhibiting once a video loops. That way your multi-hour movie inhibits properly, but your looping GIF only inhibits for the first few seconds.

Firefox does not have either of these problems.

### MPLAYER (2:1.4)
Makes no attempt to inhibit the screen saver. Use VLC instead.

### MPV (0.33)
Makes no attempt to inhibit the screen saver. Use VLC instead.

### VARIOUS
Most programs fail to re-enable screen blanking if they crash or are killed while playing. We try to detect when this has happened, but that might not work with all versions of systemd, resulting in screen blanking remaining permanently disabled. If that happens, killing and restarting xscreensaver-systemd is a workaround.

## SEE ALSO
X(1), xscreensaver(1), xscreensaver-settings(1), xscreensaver-command(1), systemd(1), sd-bus(3), elogind(8)

## COPYRIGHT
Copyright © 2019-2026 by Martin Lucina and Jamie Zawinski. Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.

The software is provided "as is" and the author disclaims all warranties with regard to this software including all implied warranties of merchantability and fitness. in no event shall the author be liable for any special, direct, indirect, or consequential damages or any damages whatsoever resulting from loss of use, data or profits, whether in an action of contract, negligence or other tortious action, arising out of or in connection with the use or performance of this software.

## AUTHOR
Martin Lucina <martin@lucina.net>, 4-Jun-2019


xscreensaver-text

title: xscreensaver-text(6)

text:
# xscreensaver-text(6)

## NAME
xscreensaver-text - prints some text to stdout, for use by screen savers.

## SYNOPSIS
xscreensaver-text [--verbose] [--columns N] [--lines N] [--latin1] [--date] [--text STRING] [--file PATH] [--program CMD] [--url URL]

## DESCRIPTION
The xscreensaver-text script prints out some text for use by various screensavers, according to the options set in the ~/.xscreensaver file. This may dump the contents of a file, run a program, or load a URL. The text is reformatted and wrapped as appropriate.

## OPTIONS
xscreensaver-text accepts the following options:

--verbose or --v

Print diagnostics to stderr. Multiple -v switches increase the amount of output.

--columns N or --cols N

Where to wrap lines; default 72 columns.

--lines N

Truncate output to at most this many lines. Default: unlimited.

--latin1

Convert any UTF-8 characters in the input to their closest Latin1 equivalent for output.

Command line options may be used to override the settings in the ~/.xscreensaver file:

--date

Print the host name and current time.

--text STRING

Print out the given text. It may contain % escape sequences as per strftime(2).

--file PATH

Print the contents of the given file, re-formatting it as per the other options.

--program CMD

Run the given program and print its output, re-formatting it as per the other options.

--url URL

Download and print the contents of the web page. If it contains HTML, RSS, or Atom, it will be converted to plain-text. This re-downloads the document every time it is run.

## ENVIRONMENT
HTTP_PROXY, HTTPS_PROXY, http_proxy, or https_proxy

to get the default proxy host and port.

## BUGS
URLs should be cached, use "If-Modified-Since", and obey "Expires".

## SEE ALSO
xscreensaver-settings(1), xscreensaver(1), fortune(1), phosphor(6), apple2(6), starwars(6), fontglide(6), dadadodo(1), webcollage(6),

## COPYRIGHT
Copyright © 2005-2021 by Jamie Zawinski. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

## AUTHOR
Jamie Zawinski <jwz@jwz.org>, 20-Mar-2005.


abstractile

package: xscreensaver-modules

title: abstractile(6)

text:
# abstractile(6)

## NAME
abstractile - draw abstract mosaic patterns of interlocking tiles

## SYNOPSIS
abstractile [--sleep seconds] [--speed int] [--tile tile_mode] [--visual visual] [--window] [--root] [--window-id number] [--fps]

## DESCRIPTION
The abstractile program draws chaotic grids of randomly colored and shaped interlocking tiles.

## OPTIONS
abstractile accepts the following options:

--sleep seconds

Specify the number of seconds to sleep between screens (0-60).

--speed int

A value between 0 and 5 used to specify the speed at which each screen is drawn.

--tile tile_mode

The type of tile that is drawn on each screen. Legal values are random, flat, thin, outline, block, neon, and tiled

--fps

Display the current frame rate and CPU load.

--visual visual

Specify which visual to use. Legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual.

--window

Draw on a newly-created window. This is the default.

--root

Draw on the root window.

--window-id number

Draw on the specified window.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 2004 by Steve Sundstrom. Based on examples from the hacks directory of xscreensaver, Copyright (c) 1997, 1998, 2002 Jamie Zawinski <jwz@jwz.org>

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation.

## AUTHOR
Steve Sundstrom


anemone

title: anemone(6)

summary: wiggling tentacles.

text:
# anemone(6)

## NAME
anemone - wiggling tentacles.

## SYNOPSIS
anemone [--display host:display.screen] [--visual visual] [--window] [--root] [--window-id number] [--delay number] [--arms number] [--finpoints number] [--width number] [--fps]

## DESCRIPTION
Wiggling tentacles.

## OPTIONS
--visual visual

Specify which visual to use. Legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual.

--window

Draw on a newly-created window. This is the default.

--root

Draw on the root window.

--window-id number

Draw on the specified window.

--delay number

Per-frame delay, in microseconds. Default: 40000 (0.04 seconds.).

--arms number

Arms. 2 - 500. Default: 128.

--finpoints number

Tentacles. 3 - 200. Default: 64.

--withdraw number

Frequency that the arms withdraw. Arms withdraw on randomly generated values between 1 and 11; this value determines the maximum value of that range. So 100 spends a lot of time withdrawn, while 1000,000 tends not to withdraw at all. Default: 1200.

--turnspeed number

How fast it turns. At zero, not at all, all they way up to thousands which are very fast indeed. Default: 50.

--width number

Thickness. 1 - 10. Default: 2.

--fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 2002 by Gabriel Finch. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

## AUTHOR
Gabriel Finch.


anemotaxis

title: anemotaxis(6)

summary: directional search on a plane.

text:
# anemotaxis(6)

## NAME
anemotaxis - directional search on a plane.

## SYNOPSIS
anemotaxis [--display host:display.screen] [--visual visual] [--window] [--root] [--window-id number] [--delay number] [--distance number] [--sources number] [--searchers number] [--fps]

## DESCRIPTION
The program demonstrates a search algorithm designed for locating a source of odor in turbulent atmosphere. The odor is convected by wind which has a constant mean direction and fluctuations around it. The searcher is able to sense the odor and determine local instantaneous wind direction. The goal is to find the source in the shortest mean time. Some animals face this task to find mates, food, home etc. They exhibit very particular, zigzagging search trajectories.

This is modeled as a search on a discrete two-dimensional lattice. The source releases particles that drift with constant velocity in one direction and walk randomly in the other direction. The searcher knows if it hit a particle, and if so, particle's position one time step earlier (local wind direction). The program paints sources and particles released by them as well as trajectories of searchers who are trying to capture the sources.

## OPTIONS
--visual visual

Specify which visual to use. Legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual.

--window

Draw on a newly-created window. This is the default.

--root

Draw on the root window.

--window-id number

Draw on the specified window.

--delay number

Per-frame delay, in microseconds. Default: 20000 (0.02 seconds.).

--distance number

Max initial distance to the source . 10 - 250. Default: 40.

--sources number

Max number of sources. Default: 25.

--searchers number

Max number of searchers. Default: 25.

--fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 2004 by Eugene Balkovsky. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

## AUTHOR
Eugene Balkovsky


apollonian

title: apollonian(6)

summary: Descartes Circle Theorem.

text:
# apollonian(6)

## NAME
apollonian - Descartes Circle Theorem.

## SYNOPSIS
apollonian [--display host:display.screen] [--visual visual] [--window] [--root] [--window-id number] [--no-label] [--no-altgeom] [--cycles number] [--ncolors number] [--delay number] [--fps]

## DESCRIPTION
Packs a large circle with smaller circles, demonstrating the Descartes Circle Theorem.

## OPTIONS
--visual visual

Specify which visual to use. Legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual.

--window

Draw on a newly-created window. This is the default.

--root

Draw on the root window.

--window-id number

Draw on the specified window.

--label | --no-label

Draw Labels. Boolean.

--altgeom | --no-altgeom

Include Alternate Geometries. Boolean.

--cycles number

Depth. 1 - 20. Default: 20.

--ncolors number

Number of Colors. Default: 64.

--delay number

Per-frame delay, in microseconds. Default: 1000000 (1.00 seconds.).

--fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 2002 by Allan R. Wilks and David Bagley. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

## AUTHOR
Allan R. Wilks and David Bagley.


title: apple2(6)

summary: Apple ][ display emulator

text:
# apple2(6)

## NAME
apple2 - Apple ][ display emulator

## SYNOPSIS
apple2 [--display host:display.screen] [--foreground color] [--background color] [--window] [--root] [--window-id number][--mono] [--install] [--visual visual] [--program command to run] [--basic] [--slideshow] [--text] [--meta] [--esc] [--bs] [--del] [--fast] [--fps]

## DESCRIPTION
The apple2 program simulates an original Apple ][ Plus computer in all its 1979 glory. It also reproduces the appearance of display on a color television set of the period.

There are 3 modes: basic, slideshow, and text. Normally it chooses a mode randomly, but you can override with the --basic, --slideshow, or --text options.

In basic mode a simulated user types in a Basic program and runs it.

In slideshow mode it chooses a number of images from the image source you configured into XScreenSaver and displays them within the limitations of the Apple ][ display hardware. With only 6 available colors, you can only make out the general shape of the pictures.

In text mode it displays the output of a command or the contents of a file or URL (via the default xscreensaver-text(6) program, which can be overridden with --program).

In text mode, it is also a fully functional (if anachronistic) vt100 terminal emulator.

## OPTIONS
apple2 accepts the following options:

--window

Draw on a newly-created window. This is the default.

--root

Draw on the root window.

--window-id number

Draw on the specified window.

--mono

If on a color display, pretend we're on a monochrome display.

--install

Install a private colormap for the window.

--visual visual

Specify which visual to use. Legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual.

--basic

Choose basic mode

--slideshow

Choose slideshow mode

--text

Choose text mode

--program sh-command

In text mode, the command to run to generate the text to display. This option may be any string acceptable to /bin/sh. The program will be run at the end of a pipe, and any characters that it prints to stdout will be printed on the Apple ][ display. If the program exits, it will be launched again after 3 seconds. Default: xscreensaver-text(6). In text mode, apple2 emulates a vt100 terminal running on a 40x24 uppercase-only screen.

For example:

```
  apple2 --text --program 'ping apple.com'

  apple2 --text --program 'ps -e'

  apple2 --text --program 'od -txCz -w7 /dev/urandom'

  apple2 --text --program 'cat /dev/random'

  apple2 --text --fast --program 'emacs -nw -q -f life'

  apple2 --text --fast \

         --program 'emacs -nw -q --eval "(hanoi 5)"'

```

You can also use apple2 as an extremely lo-fi replacement for the xterm(1) and gnome-terminal(1) terminal emulators:

```
  apple2 -text -fast -program tcsh

```

--pty

In --text mode, launch the sub-program under a pty so that it can address the screen directly. This is the default.

--pipe

In --text mode, launch the sub-program at the end of a pipe: do not let it address the screen directly.

--esc

When the user types a key with the Alt or Meta keys held down, send an ESC character first. This is the default.

--meta

When Meta or Alt are held down, set the high bit on the character instead.

--del

Swap Backspace and Delete. This is the default.

--bs

Do not swap Backspace and Delete.

--fast

Normally, characters are printed at the speed of an original Apple][ computer; however, when using this program as a terminal emulator, the novelty of those 300 baud characters might wear off. You can use the --fast option to speed things up a bit.

--fps

Display the current frame rate and CPU load.

## TERMINAL EMULATION
By default, apple2 allocates a pseudo-tty for the --text-mode sub-process to run under. This has the desirable side effect that the program will be able to use ioctl(2) to fetch information about terminal parameters and window size, which many programs (such as top(1)) need to run properly. apple2 will also set the environment variable TERM to vt100 in the child process.

Any characters typed on the apple2 window will be passed along to the sub-process. (Note that this only works when running in "window" mode, not when running in --root mode under xscreensaver.)

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

XSCREENSAVER_WINDOW

The window ID to use with --root.

TERM

to inform the sub-process of the type of terminal emulation.

## X RESOURCES
Notable X resources supported include the following which correspond to standard TV controls: analogTVTint, analogTVColor, analogTVBrightness, and analogTVContrast which correspond to standard TV controls. They range from 0 to 100,except for tint which is an angle between -180 and +180.

## TRADEMARKS
Apple ][ and Applesoft are trademarks of Apple Computer.

## SEE ALSO
xscreensaver(1), bsod(6), xscreensaver-text(6), fortune(1), phosphor(6), starwars(6), ljlatest(6), dadadodo(1), webcollage(6), driftnet(1) EtherPEG, EtherPeek, console_codes(4).

## COPYRIGHT
Copyright © 2002-2003 by Trevor Blackwell. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

## AUTHOR
Television and Apple ][ emulation by Trevor Blackwell <tlb@tlb.org>. Slideshow and text mode by Jamie Zawinski <jwz@jwz.org>. Pty and vt100 emulation by Fredrik Tolf <fredrik@dolda2000.com>.


attraction

title: attraction(6)

summary: interactions of opposing forces

text:
# attraction(6)

## NAME
attraction - interactions of opposing forces

## SYNOPSIS
attraction [--display host:display.screen] [--foreground color] [--background color] [--window] [--root] [--window-id number][--mono] [--install] [--visual visual] [--points int] [--threshold int] [--mode balls | lines | polygons | splines | filled-splines | tails ] [--size int] [--segments int] [--delay usecs] [--color-shift int] [--radius int] [--vx int] [--vy int] [--glow] [--noglow] [--orbit] [--viscosity float] [--walls] [--nowalls] [--maxspeed] [--nomaxspeed] [--correct-bounce] [--fast-bounce] [--fps]

## DESCRIPTION
The attraction program has several visually different modes of operation, all of which are based on the interactions of a set of control points which attract each other up to a certain distance, and then begin to repel each other. The attraction/repulsion is proportional to the distance between any two particles.

## OPTIONS
attraction accepts the following options:

--window

Draw on a newly-created window. This is the default.

--root

Draw on the root window.

--window-id number

Draw on the specified window.

--mono

If on a color display, pretend we're on a monochrome display.

--install

Install a private colormap for the window.

--visual visual

Specify which visual to use. Legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual.

--points integer

How many control points should be used, or 0 to select the number randomly. Default 0. Between 3 and 15 works best.

--threshold integer

The distance (in pixels) from each particle at which the attractive force becomes repulsive. Default 100.

--mode balls | lines | polygons | tails | splines | filled-splines

In balls mode (the default) the control points are drawn as filled circles. The larger the circle, the more massive the particle. In lines mode, the control points are connected by straight lines; the effect is something like qix.

In polygons mode, the control points are connected by straight lines, and filled in. This is most interesting in color.

In splines mode, a closed spline is interpolated from the control points.

In filled-splines mode, the splines are filled in instead of being outlines. This is most interesting in color.

In tails mode, the path which each particle follows is indicated by a worm-like trail, whose length is controlled by the segments parameter.

--size integer

The size of the balls in pixels, or 0, meaning to select the sizes randomly (the default.) If this is specified, then all balls will be the same size. This option has an effect in all modes, since the ``size'' of the balls controls their mass.

--segments integer

If in lines or polygons mode, how many sets of line segments or polygons should be drawn. Default 500. This has no effect in balls mode. If segments is 0, then no segments will ever be erased (this is only useful in color.)

--delay microseconds

How much of a delay should be introduced between steps of the animation. Default 10000, or about 0.01 seconds.

--color-shift int

If on a color display, the color of the line segments or polygons will cycle through the color map. This specifies how many lines will be drawn before a new color is chosen. (When a small number of colors are available, increasing this value will yield smoother transitions.) Default 3. This has no effect in balls mode.

--radius

The size in pixels of the circle on which the points are initially positioned. The default is slightly smaller than the size of the window.

--glow

This is consulted only in balls mode. If this is specified, then the saturation of the colors of the points will vary according to their current acceleration. This has the effect that the balls flare brighter when they are reacting to each other most strongly. In glow mode, all of the balls will be drawn the same (random) color, modulo the saturation shifts. In non-glow mode, the balls will each be drawn in a random color that doesn't change.

--noglow

Don't do ``glowing.'' This is the default.

--vx pixels

--vy pixels

Initial velocity of the balls. This has no effect in --orbit mode.

--orbit

Make the initial force on each ball be tangential to the circle on which they are initially placed, with the right velocity to hold them in orbit about each other. After a while, roundoff errors will cause the orbit to decay.

--vmult float

In orbit mode, the initial velocity of the balls is multiplied by this; a number less than 1 will make the balls pull closer together, and a larger number will make them move apart. The default is 0.9, meaning a slight inward pull.

--viscosity float

This sets the viscosity of the hypothetical fluid through which the control points move; the default is 1, meaning no resistance. Values higher than 1 aren't interesting; lower values cause less motion. One interesting thing to try is

```
	attraction -viscosity 0.8 -points 300 \
	-size 10 -geometry =500x500

```

Give it a few seconds to settle down into a stable clump, and then move the drag the mouse through it to make "waves".

--nowalls

This will cause the balls to continue on past the edge of the screen or window. They will still be kept track of and can come back.

--walls

This will cause the balls to bounce when they get to the edge of the screen or window. This is the default behavior.

--maxspeed

Imposes a maximum speed (default). If a ball ends up going faster than this, it will be treated as though there were .9 viscosity until it is under the limit. This stops the balls from continually accelerating (which they have a tendency to do), but also causes balls moving very fast to tend to clump in the lower right corner.

--nomaxspeed

If this is specified, no maximum speed is set for the balls.

--fast-bounce

Uses the old, simple bouncing algorithm (default). This simply moves any ball that is out of bounds back to a wall and reverses its velocity. This works fine for most cases, but under some circumstances, the simplification can lead to annoying effects.

--correct-bounce

Uses a more intelligent bouncing algorithm. This method actually reflects the balls off the walls until they are within bounds. This can be slow if balls are bouncing a whole lot, perhaps because of -nomaxspeed.

--graphmode none | x | y | both | speed

For "x", "y", and "both", displays the given velocities of each ball as a bar graph in the same window as the balls. For "speed", displays the total speed of each ball. Default is "none".

--fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 1992, 1993, 1997 by Jamie Zawinski. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

## AUTHOR
Jamie Zawinski <jwz@jwz.org>, 13-aug-92.

Viscosity support by Philip Edward Cutone, III.

Walls, speed limit options, new bouncing, graphs, and tail mode fix by Matthew Strait. 31 March 2001


binaryhorizon

title: binaryhorizon(6)

text:
# binaryhorizon(6)

## NAME
binaryhorizon - A system of path tracing particles evolves continuously.

## SYNOPSIS
binaryhorizon [--fps] [--install] [--noinstall] [--mono] [--root] [--window-id number] [--visual visual] [--window] [--window-id window-id] [--color] [--no-color] [--growth-delay delayms] [--particle-number particles] [--duration secs] [--bicolor] [--monocolor]

## DESCRIPTION
A system of path tracing particles evolves continuously from an initial horizon, alternating between colors.

## OPTIONS
binaryhorizon accepts the following options:

--fps

Display the current frame rate and CPU load.

--install

Install a private colormap for the window.

--mono

If on a color display, pretend we're on a monochrome display.

--noinstall

Don't install a private colormap for the window.

--root

Draw on the root window.

--window-id number

Draw on the specified window.

--visual visual

Specify which visual to use. Legal values are the name of a visual class or the id number (decimal or hex) of a specific visual.

--window

Draw on a newly-created window. This is the default.

--window-id window-id

Specify which window id to use.

--color (Default)

Particles have random generated colors that gradually change over time.

--no-color

Use the original black and white visualization.

--bicolor (Default)

Particles have 2 random colors, starting as white and black.

--monocolor

Particles have 2 colors, one starting as white and gradually changing, and one staying black.

--fade (Default)

Particles gradually fade between colors over time.

--no-fade

Every particle is a random color.

--growth-delay delayms (Default: 10000)

Delay in ms between growth cycles. More delay, slower (but less CPU intensive).

--particles-number particles (Default: 5000)

The number of particles in the system. With more particles the fps can also be affected.

--duration secs (Default: 30)

How long between full resets.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## SEE ALSO
X(1), xscreensaver(1),

http://complexification.net/

## COPYRIGHT
Copyright 2020 by Patrick Leiser <patrick27leiser@yahoo.com>.

Based on code © 2003 by J. Tarbell <complex@complexification.net>.

XScreenSaver port: Emilio Del Tessandoro <emilio.deltessa@gmail.com>

## AUTHOR
Patrick Leiser <patrick27leiser@yahoo.org>, Mar 2020.

J. Tarbell <complex@complexification.net>, Jun 2003.

Emilio Del Tessandoro <emilio.deltessa@gmail.com>, Aug 2014.


binaryring

title: binaryring(6)

text:
# binaryring(6)

## NAME
binaryring - A system of path tracing particles evolves continuously from an initial creation.

## SYNOPSIS
binaryring [--fps] [--install] [--noinstall] [--mono] [--root] [--window-id number] [--visual visual] [--window] [--window-id window-id] [--color] [--no-color] [--growth-delay delayms] [--particle-number particles] [--ring-radius radius]

## DESCRIPTION
A system of path tracing particles evolves continuously from an initial circular creation. Ages of darkness play arbitrarily with ages of light.

## OPTIONS
binaryring accepts the following options:

--fps

Display the current frame rate and CPU load.

--install

Install a private colormap for the window.

--mono

If on a color display, pretend we're on a monochrome display.

--noinstall

Don't install a private colormap for the window.

--root

Draw on the root window.

--window-id number

Draw on the specified window.

--visual visual

Specify which visual to use. Legal values are the name of a visual class or the id number (decimal or hex) of a specific visual.

--window

Draw on a newly-created window. This is the default.

--window-id window-id

Specify which window id to use.

--color (Default)

Particles have random generated colors that gradually change over time.

--no-color

Use the original black and white visualization.

--growth-delay delayms (Default: 10000)

Delay in ms between growth cycles. More delay, slower (but less CPU intensive).

--particles-number particles (Default: 5000)

The number of particles in the system. With more particles the fps can also be affected.

--ring-radius radius (Default: 40)

The radius of the ring where the particles are born, in pixels.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## SEE ALSO
X(1), xscreensaver(1),

http://complexification.net/

## COPYRIGHT
Based on code © 2003 by J. Tarbell <complex@complexification.net>.

XScreenSaver port: Emilio Del Tessandoro <emilio.deltessa@gmail.com>

## AUTHOR
Patrick Leiser <patrick27leiser@yahoo.org>, Mar 2020.

Emilio Del Tessandoro <emilio.deltessa@gmail.com>, Aug 2014.


blaster

title: blaster(6)

summary: simulation of space combat

text:
# blaster(6)

## NAME
blaster - simulation of space combat

## SYNOPSIS
blaster [--display host:display.screen] [--visual visual] [--window] [--root] [--window-id number] [--num_robots number] [--num_lasers number] [--num_stars number] [--delay number] [--fps]

## DESCRIPTION
Draws a simulation of flying space-combat robots (cleverly disguised as colored circles) doing battle in front of a moving star field.

## OPTIONS
--visual visual

Specify which visual to use. Legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual.

--window

Draw on a newly-created window. This is the default.

--root

Draw on the root window.

--window-id number

Draw on the specified window.

--num_robots number

Robots. 2 - 50. Default: 5.

--num_lasers number

Lasers. 1 - 100. Default: 3.

--num_stars number

Stars. 5 - 200. Default: 50.

--delay number

Per-frame delay, in microseconds. Default: 10000 (0.01 seconds.).

--fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 2002 by Jonathan Lin. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

## AUTHOR
Jonathan Lin.


blitspin

title: blitspin(6)

summary: rotate a bitmap in an interesting way

text:
# blitspin(6)

## NAME
blitspin - rotate a bitmap in an interesting way

## SYNOPSIS
blitspin [--display host:display.screen] [--foreground color] [--background color] [--window] [--root] [--window-id number] [--mono] [--install] [--visual visual] [--bitmap filename] [--delay usecs] [--delay2 usecs] [--duration secs]

## DESCRIPTION
The blitspin program repeatedly rotates a bitmap by 90 degrees by using logical operations: the bitmap is divided into quadrants, and the quadrants are shifted clockwise. Then the same thing is done again with progressively smaller quadrants, except that all sub-quadrants of a given size are rotated in parallel. So this takes O(16*log2(N)) blits of size NxN, with the limitation that the image must be square, and the size must be a power of 2.

## OPTIONS
blitspin accepts the following options:

--window

Draw on a newly-created window. This is the default.

--root

Draw on the root window.

--window-id number

Draw on the specified window.

--mono

If on a color display, pretend we're on a monochrome display.

--install

Install a private colormap for the window.

--visual visual

Specify which visual to use. Legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual.

--bitmap filename

The file name of a bitmap to rotate. It need not be square: it will be padded with the background color. If unspecified or the string (default), a builtin bitmap is used. If support for the XPM library was enabled at compile-time, the specified file may be in XPM format as well as XBM, and thus may be a color image.

The *bitmapFilePath resource will be searched if the bitmap name is not a fully-qualified pathname.

--grab-screen

If this option is specified, then the image which is spun will be grabbed from the portion of the screen underlying the blitspin window, or from the system's video input, or from a random file on disk, as indicated by the grabDesktopImages, grabVideoFrames, and chooseRandomImages options in the ~/.xscreensaver file; see xscreensaver-settings(1) for more details.

--delay microseconds

How long to delay between steps of the rotation process, in microseconds. Default is 500000, one-half second.

--duration seconds

How long to run before loading a new image. Default 120 seconds.

--delay2 microseconds

How long to delay between each 90-degree rotation, in microseconds. Default is 500000, one-half second. DISPLAY to get the default host and display number.

--fps

Display the current frame rate and CPU load.

## ENVIRONMENT
XENVIRONMENT to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## SEE ALSO
X(1), xscreensaver(1), xscreensaver-settings(1), xscreensaver-getimage(6)

## COPYRIGHT
Copyright © 1992, 1993, 1997, 2001 by Jamie Zawinski. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

## AUTHOR
Jamie Zawinski <jwz@jwz.org>, 17-aug-92.

Based on SmallTalk code which appeared in the August 1981 issue of Byte magazine.


bouboule

title: bouboule(6)

summary: draws spinning 3D blobs

text:
# bouboule(6)

## NAME
bouboule - draws spinning 3D blobs

## SYNOPSIS
bouboule [--display host:display.screen] [--foreground color] [--background color] [--window] [--root] [--window-id number][--mono] [--install] [--visual visual] [--ncolors integer] [--delay microseconds] [--cycles integer] [--count integer] [-3d]

[--fps]

## DESCRIPTION
The bouboule program draws spinning 3D blobs.

## OPTIONS
bouboule accepts the following options:

--window

Draw on a newly-created window. This is the default.

--root

Draw on the root window.

--window-id number

Draw on the specified window.

--mono

If on a color display, pretend we're on a monochrome display.

--install

Install a private colormap for the window.

--visual visual

Specify which visual to use. Legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual.

--ncolors integer

How many colors should be used (if possible). Default 64. The colors used cycle through the hue, making N stops around the color wheel.

--cycles integer

--count integer

-3d

Do red/blue 3d separations (for 3d glasses.)

--fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## SEE ALSO
X(1), xscreensaver(1), xlock(1)

## COPYRIGHT
Copyright © 1996 by Jeremie Petit.

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation.

## AUTHOR
Jeremie Petit <jpetit@essi.fr>, 1996.

3D support by Henrik Theiling <theiling@coli-uni-sb.de>, 04-Sep-96.

VMS support by Jouk Jansen <joukj@alpha.chem.uva.nl>, 01-Feb-96.

TrueColor support by David Bagley <bagleyd@bigfoot.com>, 01-Feb-96.

Ability to run standalone or with xscreensaver added by Jamie Zawinski <jwz@jwz.org>, 15-May-97.


boxfit

title: boxfit(6)

text:
# boxfit(6)

## NAME
boxfit - fills space with a gradient of growing boxes or circles.

## SYNOPSIS
boxfit [--display host:display.screen] [--visual visual] [--window] [--root] [--window-id number] [--delay usecs] [--count int] [--growby int] [--spacing int] [--border int] [--circles | --squares | --random] [--grab] [--peek] [--fps]

## DESCRIPTION
Packs the screen with growing boxes or circles, colored according to a horizontal or vertical gradient. The objects grow until they touch, then stop. When the screen is full, they shrink away and the process restarts.

## OPTIONS
--visual visual

Specify which visual to use. Legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual.

--window

Draw on a newly-created window. This is the default.

--root

Draw on the root window.

--window-id number

Draw on the specified window.

--delay microseconds

How much of a delay should be introduced between steps of the animation. Default 20000, or about 0.02 seconds.

--count int

How many boxes or circles to animate simultaneously; default 50. Smaller numbers yield larger boxes/circles.

--growby int

How many pixels the objects should grow by, each frame. Default 1.

--spacing int

How many pixels of space should be left between the objects. Default 1.

--border int

Thickness of the colored border around each object. Default 1.

--circles | --squares | --random

Draw circles, squares, or choose randomly (the default).

--grab

Normally it colors the boxes with a horizontal or vertical gradient. If --grab is specified, it will instead load a random image, and color the boxes according to the colors in that image. As the picture fills in, some features of the underlying image may become recognisable. When grabbing images, the image will be grabbed from the portion of the screen underlying the window, or from the system's video input, or from a random file on disk, as indicated by the grabDesktopImages, grabVideoFrames, and chooseRandomImages options in the ~/.xscreensaver file; see xscreensaver-settings(1) for more details.

--peek

This option says to briefly show you the underlying image before beginning. The default is not to show the unadulterated image at all. (This only has an effect when --grab is used.)

--fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## SEE ALSO
X(1), xscreensaver(1) xscreensaver-settings(1), xscreensaver-getimage(6)

## COPYRIGHT
Copyright © 2005 by Jamie Zawinski. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

## AUTHOR
Jamie Zawinski <jwz@jwz.org>


braid

title: braid(6)

text:
# braid(6)

## NAME
braid - draws random color-cycling braids around a circle

## SYNOPSIS
braid [--display host:display.screen] [--foreground color] [--background color] [--window] [--root] [--window-id number][--mono] [--install] [--visual visual] [--ncolors integer] [--delay microseconds] [--cycles integer] [--count integer]

[--fps]

## DESCRIPTION
The braid program draws random color-cycling braids around a circle.

## OPTIONS
braid accepts the following options:

--window

Draw on a newly-created window. This is the default.

--root

Draw on the root window.

--window-id number

Draw on the specified window.

--mono

If on a color display, pretend we're on a monochrome display.

--install

Install a private colormap for the window.

--visual visual

Specify which visual to use. Legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual.

--ncolors integer

How many colors should be used (if possible). Default 64. The colors used cycle through the hue, making N stops around the color wheel.

--cycles integer

--count integer

--fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## SEE ALSO
X(1), xscreensaver(1), xlock(1)

## COPYRIGHT
Copyright © 1995 by John Neil.

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation.

## AUTHOR
John Neil <neil@math.idbsu.edu>, 29-Aug-95.

Ability to run standalone or with xscreensaver added by Jamie Zawinski <jwz@jwz.org>, 10-May-97.


bsod

title: bsod(6)

summary: Blue Screen of Death emulator

text:
# bsod(6)

## NAME
bsod - Blue Screen of Death emulator

## SYNOPSIS
bsod [--display host:display.screen] [--foreground color] [--background color] [--window] [--root] [--window-id number][--mono] [--install] [--visual visual] [--delay seconds] [--fps]

## DESCRIPTION
The bsod program is the finest in personal computer emulation.

bsod steps through a set of screens, each one a recreation of a different failure mode of an operating system. Systems depicted include Windows 3.1, Windows 95, Windows NT, MS-DOS, AmigaDOS 1.3, Linux, SCO UNIX, BSD UNIX, HPUX, Solaris, Tru64, VMS, HVX/GCOS6, IBM OS/390, OS/2, MacOS (MacsBug, Bomb, Sad Mac, and OSX), Atari ST, Apple ][+, VMware and NCD X Terminals.

## OPTIONS
bsod accepts the following options:

--window

Draw on a newly-created window. This is the default.

--root

Draw on the root window.

--window-id number

Draw on the specified window.

--mono

If on a color display, pretend we're on a monochrome display.

--install

Install a private colormap for the window.

--visual visual

Specify which visual to use. Legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual.

--delay delay

The duration each crash-mode is displayed before selecting another.

--only which

Tell it to run only one mode, e.g., --only HPUX.

--fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## X RESOURCES
Notable X resources supported include the following, which control which hacks are displayed and which aren't. doWindows, doNT, doWin2K, doWin10, doRansomware, doAmiga, doMac, doMac1, doMacsBug, doMacX, doSCO, doAtari, doBSD, doLinux, doSparcLinux, doHPPALinux, doBlitDamage, doSolaris, doHPUX, doApple2, doOS390, doTru64, doVMS, doMSDOS, doOS2, doHVX, doVMware, and doATM. Each of these is a Boolean resource, they all default to true, except for doAtari, doBSD, doSparcLinux, and doHPPALinux, which are turned off by default, because they're really not all that interesting looking unless you're a fan of those systems.

There are command-line options for all of these: e.g., --bsd, --no-bsd. (Also note the --only option.)

## BUGS
Unlike the systems being simulated, bsod does not require a reboot after running.

## SEE ALSO
X(1), xscreensaver(1)

## TRADEMARKS
Microsoft Windows, Microsoft Windows 95, and Microsoft Windows NT are all registered trademarks of Microsoft Corporation. Apple Macintosh is a registered trademark of Apple Computer. Amiga is a registered trademark of Amiga International, Inc. Solaris is a trademark of Sun Microsystems. HP-UX is a trademark of HP Hewlett Packard Group LLC. Nvidia is a tradmark of Nvidia Corporation. VMS is probably a trademark of Digital Equipment Corporation. Atari ST is probably a trademark, too, but it's hard to tell who owns it. SCO is probably still a trademark of somebody these days, I guess. Linux is a registered trademark of Linus Torvalds, but it isn't his fault. OS/2 is a registered trademark of International Business Machines Corporation. VMware is a registered trademark of VMware, Inc. Android is a trademark of Google LLC. GladOS is a trademark of Aperture Science Incorporated.

## COPYRIGHT
Copyright © 1998-2022 by Jamie Zawinski. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty. No animals were harmed during the testing of these simulations. Always mount a scratch monkey.

## AUTHOR
Concept cribbed from Stephen Martin <smartin@mks.com>. This version is by Jamie Zawinski <jwz@jwz.org>, with contributions from many others.


bumps

title: bumps(6)

text:
# bumps(6)

## NAME
bumps - move distorting spotlight around desktop

## SYNOPSIS
bumps [--display host:display.screen] [--foreground color] [--background color] [--window] [--root] [--window-id number] [--mono] [--install] [--visual visual] [--delay usecs] [--duration secs] [--fps]

## DESCRIPTION
The bumps program takes an image and exposes small, distorted sections of it as if through an odd wandering spotlight beam.

The image that it manipulates will be grabbed from the portion of the screen underlying the window, or from the system's video input, or from a random file on disk, as indicated by the grabDesktopImages, grabVideoFrames, and chooseRandomImages options in the ~/.xscreensaver file; see xscreensaver-settings(1) for more details.

## OPTIONS
bumps accepts the following options:

--window

Draw on a newly-created window. This is the default.

--root

Draw on the root window.

--window-id number

Draw on the specified window.

--mono

If on a color display, pretend we're on a monochrome display.

--install

Install a private colormap for the window.

--visual visual

Specify which visual to use. Legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual.

--delay microseconds

Slow it down.

--duration seconds

How long to run before loading a new image. Default 120 seconds.

--fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## SEE ALSO
X(1), xscreensaver(1), xscreensaver-settings(1), xscreensaver-getimage(6)

## COPYRIGHT
Copyright © 1999 by Shane Smit. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

## CREDITS
Shane Smit <blackend@inconnect.com>, 8-Oct-1999.


ccurve

title: ccurve(6)

summary: self-similar linear fractals.

text:
# ccurve(6)

## NAME
ccurve - self-similar linear fractals.

## SYNOPSIS
ccurve [--display host:display.screen] [--visual visual] [--window] [--root] [--window-id number] [--delay number] [--pause number] [--limit number] [--fps]

## DESCRIPTION
Generates self-similar linear fractals, including the classic ``C Curve.''

## OPTIONS
--visual visual

Specify which visual to use. Legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual.

--window

Draw on a newly-created window. This is the default.

--root

Draw on the root window.

--window-id number

Draw on the specified window.

--delay number

Delay. 0 - 60. Default: 1.

--pause number

Duration. 1 - 60. Default: 3.

--limit number

Density. 3 - 300000. Default: 200000.

--fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 2002 by Rick Campbell. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

## AUTHOR
Rick Campbell.


celtic

title: celtic(6)

summary: draws celtic cross-stich patterns

text:
# celtic(6)

## NAME
celtic - draws celtic cross-stich patterns

## SYNOPSIS
celtic [--display host:display.screen] [--visual visual] [--window] [--root] [--window-id number] [--delay number] [--delay2 number] [--ncolors number] [--graph mode] [--fps]

## DESCRIPTION
The celtic program repeatedly draws random cross-stitch patterns.

## OPTIONS
--visual visual

Specify which visual to use. Legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual.

--window

Draw on a newly-created window. This is the default.

--root

Draw on the root window.

--window-id number

Draw on the specified window.

--delay number

Per-frame delay, in microseconds. Default: 10000.

--delay2 number

Delay between patterns, in seconds. Default: 5.

--ncolors number

Number of colours to use. Default: 20.

--graph

Whether to render the underlying graph. Default: no.

--fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 2005 by Max Froumentin. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

## AUTHOR
Max Froumentin <max@lapin-bleu.net>


cloudlife

title: cloudlife(6)

text:
# cloudlife(6)

## NAME
cloudlife - a cellular automaton based on Conway's Life

## SYNOPSIS
cloudlife [--display host:display.screen] [--foreground color] [--background color] [--window] [--root] [--window-id number][--mono] [--install] [--visual visual] [--ncolors integer] [--cycle-delay microseconds] [--cycle-colors integer][--cell-size integer] [--initial-density integer] [--max-age integer]

[--fps]

## DESCRIPTION
The cloudlife program draws a cellular automaton based on Conway's Life, except that cells have a maximum age, and only one pixel per cell is drawn every tick.

## OPTIONS
cloudlife accepts the following options:

--window

Draw on a newly-created window. This is the default.

--root

Draw on the root window.

--window-id number

Draw on the specified window.

--mono

If on a color display, pretend we're on a monochrome display.

--install

Install a private colormap for the window.

--visual visual

Specify which visual to use. Legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual.

--cycle-delay integer

Time in microseconds to sleep between ticks. Default 25000.

--cycle-colors integer

How many ticks should elapse between cycling colors. 0 to disable color cycling. Default 2.

--ncolors integer

How many colors should be used (if possible). Default 64. The colors are chosen randomly.

--cell-size integer

Size of each cell, in powers of 2. Default 3 (8-pixel cells).

--initial-density integer

Percentage of cells that are alive at start and when the field is repopulated. Default 30.

--max-age integer

Maximum age for a cell. Default 64.

--fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## SEE ALSO
X(1), xscreensaver(1), xlock(1)

## COPYRIGHT
Copyright © 2003 by Don Marti. Based on examples from the hacks directory of xscreensaver, Copyright (c) 1997, 1998, 2002 Jamie Zawinski <jwz@jwz.org>

This man page based on the man page of sierpinski, Copyright © 1996 by Desmond Daignault.

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation.

## AUTHOR
Don Marti <dmarti@zgp.org> 20 May 2003.


compass

title: compass(6)

summary: draws a spinning compass.

text:
# compass(6)

## NAME
compass - draws a spinning compass.

## SYNOPSIS
compass [--display host:display.screen] [--visual visual] [--window] [--root] [--window-id number] [--delay number] [--no-db] [--fps]

## DESCRIPTION
This draws a compass, with all elements spinning about randomly, for that ``lost and nauseous'' feeling.

## OPTIONS
--visual visual

Specify which visual to use. Legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual.

--window

Draw on a newly-created window. This is the default.

--root

Draw on the root window.

--window-id number

Draw on the specified window.

--delay number

Per-frame delay, in microseconds. Default: 20000 (0.02 seconds.).

--db | --no-db

Double Buffer. Boolean.

--fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 2002 by Jamie Zawinski. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

## AUTHOR
Jamie Zawinski.


coral

title: coral(6)

text:
# coral(6)

## NAME
coral - simulates coral growth, albeit somewhat slowly.

## SYNOPSIS
coral [--display host:display.screen] [--visual visual] [--window] [--root] [--window-id number] [--delay2 number] [--delay number] [--density number] [--seeds number] [--fps]

## DESCRIPTION
Simulates coral growth.

## OPTIONS
--visual visual

Specify which visual to use. Legal values are the name of a visual class, or the id number (decimal or hex) of a specific visual.

--window

Draw on a newly-created window. This is the default.

--root

Draw on the root window.

--window-id number

Draw on the specified window.

--delay2 number

Per-frame delay, in microseconds. Default: 1000 (0.001 seconds.).

--delay number

Duration. 1 - 60. Default: 5.

--density number

Density. 1 - 90. Default: 25.

--seeds number

Seeds. 1 - 100. Default: 20.

--fps

Display the current frame rate and CPU load.

## ENVIRONMENT
DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

XSCREENSAVER_WINDOW

The window ID to use with --root.

## SEE ALSO
X(1), xscreensaver(1)

## COPYRIGHT
Copyright © 2002 by Frederick Roeber. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

## AUTHOR
Frederick Roeber.