cave(1)

NAME
cave - Play ascii character animations.

SYNOPSIS
cave [ -hvSsqd ] [ -f fps ] [ -c cue ] [ -r regex ] [ -t seconds ] file ...

DESCRIPTION
cave is an acronym for Character Animation Viewer for Everyone. It plays ascii character animations with an curses(3) interface. cave tries to determine the location of the frame deliminator automatically (top or bottom of the frame). Files compressed with gzip(1) are supported.

OPTIONS

-f fps
    Initial frames-per-second. The default is 15.

-c cue
    Skip this many frames when using the cue keys. The default is 8.

-r regex
    An alternate extended regular expression used to specify a frame deliminator. See REGEX EXAMPLES below.

-d  Make a specified frame deliminator a value for a frame delay. This is the default if no alternate frame delay is specified.

-s  Go directly into screensaver mode on startup cycling through multiple files.

-S  Go directly into screensaver mode shuffling the order of files if more than one file is specified.

-q  When in screensaver mode, quit after a keypress.

-t seconds
    When in screensaver mode, if an animations length is less than this amount of seconds then it will loop until it is reached. The default is 30. Note that this only works when more than one file is specified.

-h  Program help text.

-v  Version and copyright information.

INTERACTIVE COMMANDS
Press 'h' after loading a file to see a list of available interactive commands.

REGEX EXAMPLES

^[0-9]+[[:space:]]*$
    Match a line beginning (^) with at least one (+) digit ([0-9]) with zero or more (*) trailing whitespace characters until end-of-line ($). This is the default and is used for frame delays.

^,$ Match a line beginning with a comma immediately followed by end-of-line.

SEE ALSO
re_format(7), gzip(1)

AUTHOR
Copyright (C) 2002 bjk <cyclic@users.sourceforge.net>. Distributed under the terms of the GNU General Public License version 2.