Enjoy the mysteries of the sea from the safety of your own terminal!
Clone or download
cmatsuoka Merge pull request #1 from jbaber/master
Add Ubuntu specific installation instructions to the README.
Latest commit 8bdb7d4 Aug 23, 2012
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
CHANGES Update changelog Dec 14, 2011
MANIFEST Import Kirk Baucom's ASCIIQuarium 1.0 Dec 14, 2011
README Add ubuntu specific installation instructions to README. Aug 23, 2012
asciiquarium Add command-line switch for classic mode Dec 16, 2011
gpl.txt Import Kirk Baucom's ASCIIQuarium 1.0 Dec 14, 2011

README

                              Asciiquarium v1.1
                    by Kirk Baucom <kbaucom@schizoid.com>
                          http://www.robobunny.com

Asciiquarium is an aquarium/sea animation in ASCII art.

Installation
------------

Asciiquarium is a single perl script, so all you have to do is make sure
it's executable and put it somewhere convenient, like /usr/local/bin or
/usr/local/games.

  Ubuntu
  ------

  Out-of-the-box ubuntu doesn't satisfy the Requirements below, so
  here's how to get them:
  1) Get perl's curses package which is available from apt:
       sudo apt-get install libcurses-perl
  2) Run
       cpan
     at the shell.  Agree to the defaults for everything.
     To leave cpan, type 
       quit
  3) Type
    sudo cpan Term::Animation

Requirements
------------

You must have the Term::Animation module, which you can get from
http://www.cpan.org. The Term::Animation module also requires the Curses
module, which you can also get from CPAN. This program will only run on
platforms that have a Curses library (so it won't work on Windows, but
you might get it to run under cygwin).

Usage
-----

Command line arguments:
	-c	"classic" mode, only show species from Asciiquarium 1.0

While running:
	q	quit
	r	redraw (will recreate all entities)
	p	toggle pause

Contributors
------------

New fish species backported from the Android live wallpaper and
other minor improvements by Claudio Matsuoka.

Pretty much all of the ASCII art was done by Joan Stark:
http://www.geocities.com/SoHo/7373/

Anything that she didn't do, I don't have a source for.