---
title: "Asciiquarium - Python Edition"
author: "Mohammad Abu Mattar"
canonical: https://mkabumattar.com/projects/asciiquarium---python-edition
---

[cd ../projects](/projects)

# Asciiquarium - Python Edition

An aquarium/sea animation in ASCII art for your terminal! This is a Python reimplementation of the classic Perl asciiquarium, featuring multiple fish species, sharks, whales, ships, and sea monsters with smooth 30 FPS animation.

5 tech·8 features· live

## // key features

-   7 different fish species with unique animations
-   Sharks that hunt small fish with collision detection
-   Whales with animated water spout effects
-   Ships, sea monsters, and environmental decorations
-   Smooth 30 FPS animation with Z-depth layering
-   Full color support with detailed ASCII art
-   Interactive controls (pause, redraw, info overlay)
-   Cross-platform support (Windows, Linux, macOS)

## // stack

PythonTUIASCII ArtPyPIAnimation

## // links

[Install Asciiquarium](https://pypi.org/project/asciiquarium/)[View Source](https://github.com/MKAbuMattar/asciiquarium-python)[

PyPI Package](https://pypi.org/project/asciiquarium/)

## // discussion

[next projectNotebook - Browser-Based Markdown Editor](/projects/notebook---browser-based-markdown-editor)