# Install asciiquarium with Homebrew, apk, dnf, Nix, pacman

Aquarium animation in ASCII art. Version 1.1 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:asciiquarium
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install asciiquarium
```

  Evidence: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add asciiquarium
```

  Evidence: Alpine Linux edge package indexes: asciiquarium from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- dnf (92%):

```sh
sudo dnf install asciiquarium
```

  Evidence: Fedora Rawhide package metadata: asciiquarium from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#asciiquarium
```

  Evidence: nixpkgs package indexes: pkgs/by-name/as/asciiquarium/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S asciiquarium
```

  Evidence: Arch Linux sync databases: asciiquarium from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

## Package facts

- **Package key:** brew:asciiquarium
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/asciiquarium>
- **Version:** 1.1
- **Source summary:** Aquarium animation in ASCII art
- **Homepage:** <https://robobunny.com/projects/asciiquarium/html/>
- **Repository:** <https://github.com/cmatsuoka/asciiquarium>
- **Upstream docs:** <https://github.com/cmatsuoka/asciiquarium#readme>
- **License:** GPL-2.0-or-later
- **Source archive:** <https://robobunny.com/projects/asciiquarium/asciiquarium_1.1.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- asciiquarium (cli)
- asciiquarium (alias)

## Dependencies

- ncurses

## Uses from macOS

- perl

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.1
- Local data: ok
- Upstream repository: https://robobunny.com/projects/asciiquarium/html/
- info: No package-manager update timestamp was available.
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

ASCIIQuarium is a Perl terminal toy that animates an aquarium scene in ASCII art using Curses and Term::Animation. It is the sort of small, durable package that persists in Unix package collections because it is whimsical, dependency-light, and instantly demonstrable.

### Project history

The official README identifies the program as Asciiquarium v1.1 by Kirk Baucom and describes it as an aquarium/sea animation in ASCII art. The script header gives a 2003 copyright date for Kirk Baucom and points users to the robobunny.com project page as the current version location.

The GitHub mirror/import used by current package managers was created in 2011 by Claudio Matsuoka. Its first commit message says it imported Kirk Baucom's ASCIIQuarium 1.0, and the README credits Matsuoka with new fish species and minor improvements backported from an Android live wallpaper.

### Adoption history

ASCIIQuarium's adoption is mostly package-culture adoption rather than application-platform adoption: it is useful as a terminal demo, a Curses/Perl curiosity, and a bit of ASCII-art nostalgia. The input facts list Alpine, Homebrew, Fedora, Nix, and Arch packages, which is broad for a terminal toy.

Its README includes Ubuntu setup notes for Perl Curses and Term::Animation, reflecting the older CPAN-plus-distro packaging style. Package-manager formulas are valuable because they hide those Perl module requirements behind a single install.

### How it is used

The program is a single Perl script. Users put it somewhere on PATH and run `asciiquarium`; while it is running, `q` quits, `r` redraws the aquarium, `p` toggles pause, and `-c` selects classic mode with only species from Asciiquarium 1.0.

### Why package nerds care

For package nerds, ASCIIQuarium is a tiny example of why toy packages matter: it exercises terminal capabilities, Perl module dependencies, curses support, and package naming conventions while also being fun enough to keep around.

### Timeline

- 2003: Script header copyright date for Kirk Baucom.
- 2011: GitHub repository created and initial import commit records ASCIIQuarium 1.0.
- 2011: Version 1.1 documented with new fish species.
- 2023: GitHub repository still received updates/pushes.

### Related projects

- Term::Animation and Curses are required Perl modules.
- Joan Stark's ASCII art is credited for much of the artwork.
- An Android live wallpaper is mentioned as the source for some backported species.

### Sources

- <https://github.com/cmatsuoka/asciiquarium>
- <https://raw.githubusercontent.com/cmatsuoka/asciiquarium/master/CHANGES>
- <https://raw.githubusercontent.com/cmatsuoka/asciiquarium/master/README>
- <https://raw.githubusercontent.com/cmatsuoka/asciiquarium/master/asciiquarium>
- source_facts.package-manager


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** asciiquarium
- **Version Scheme:** 0
- **Revision:** 6
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- Nix - asciiquarium: normalized package name match | nixpkgs package indexes: pkgs/by-name/as/asciiquarium/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - asciiquarium - 1.1-r2: normalized package name match | Alpine Linux edge package indexes: asciiquarium from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | An aquarium/sea animation in ASCII art | https://robobunny.com/projects/asciiquarium/html/
- dnf - asciiquarium - 1.1-28.fc44: normalized package name match | Fedora Rawhide package metadata: asciiquarium from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | ASCII art aquarium/sea animation | http://www.robobunny.com/projects/asciiquarium/html/
- pacman - asciiquarium - 1.1-7: normalized package name match | Arch Linux sync databases: asciiquarium from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | An aquarium/sea animation in ASCII art | https://robobunny.com/projects/asciiquarium/html


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Game and emulation packages](https://www.automicvault.com/pkg/game-emulation-tools/) - Matched game or emulation metadata.
- [Web development packages](https://www.automicvault.com/pkg/web-dev-tools/) - Matched web development metadata.
- [ncurses](https://www.automicvault.com/pkg/brew/ncurses/) - Runtime dependency declared by Homebrew.
- [tractorgen](https://www.automicvault.com/pkg/brew/tractorgen/) - Shares av.db curated category or tags: ascii-art, cli, games, terminal.
- [cowsay](https://www.automicvault.com/pkg/brew/cowsay/) - Shares av.db curated category or tags: ascii-art, cli, games, perl, terminal.
- [fortune](https://www.automicvault.com/pkg/brew/fortune/) - Shares av.db curated category or tags: cli, games, terminal.
- [trader](https://www.automicvault.com/pkg/brew/trader/) - Shares av.db curated category or tags: cli, games, terminal.
- [tty-solitaire](https://www.automicvault.com/pkg/brew/tty-solitaire/) - Shares av.db curated category or tags: cli, games, terminal.
- [c2048](https://www.automicvault.com/pkg/brew/c2048/) - Shares av.db curated category or tags: cli, games, terminal.
- [moon-buggy](https://www.automicvault.com/pkg/brew/moon-buggy/) - Shares av.db curated category or tags: cli, games, terminal.
- [nsnake](https://www.automicvault.com/pkg/brew/nsnake/) - Shares av.db curated category or tags: cli, games, terminal.

## Combined YAML source

View the package source record on GitHub. [combined/asciiquarium.yml](https://github.com/automic-vault/db/blob/main/combined/asciiquarium.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
