🎨 Art Gallery

Interactive terminal art gallery with 12 generative art animations — pure Python, zero dependencies

Features · Screenshots · Getting Started · Tech Stack

---

📸 Screenshots

Matrix Rain	Starfield	Fireworks

Game of Life	Plasma Waves	Maze Generator

Spirograph	Raindrop Ripples	Lissajous Weaver

Voronoi Landscape	Fluid Particles	Terrain Map

✨ Features

• Matrix Rain — Cascading green characters inspired by The Matrix
• Starfield — 3D space simulation flying through stars
• Fireworks — Colorful particle bursts with realistic gravity physics
• Game of Life — Conway's cellular automaton with color-coded cell age
• Plasma Waves — Smooth undulating rainbow gradient effects
• Maze Generator — Real-time recursive backtracking maze carving
• Spirograph — Hypotrochoid curves tracing intricate geometric patterns
• Raindrop Ripples — Concentric expanding rings with interference patterns
• Lissajous Weaver — Oscilloscope-style phosphor trails from parametric curves
• Voronoi Landscape — Dynamic stained-glass mosaic with drifting seed points
• Fluid Particles — Boids flocking simulation with rainbow trails
• Terrain Map — Animated topographic heightmap with terrain coloring
• Keyboard Navigation — Switch between exhibits with arrow keys or number keys, pause/resume, and reset

🚀 Getting Started

Prerequisites

• Python 3.6+
• A terminal with color support (256-color recommended)

Installation

git clone https://github.com/markksantos/art_gallery.git
cd art_gallery
python3 art_gallery.py

Controls

Key	Action
Left / Right	Switch between animations
1–9, 0	Jump to a specific animation (0 = 10th)
Space	Pause / Resume
r	Reset current animation
q	Quit

🛠️ Tech Stack

Category	Technology
Language	Python 3.6+
Rendering	curses (stdlib)
Dependencies	None — stdlib only

📁 Project Structure

art_gallery/
├── art_gallery.py          # All 12 animations + gallery navigation
├── screenshots/            # Generated animation screenshots
└── README.md

📄 License

MIT License © 2025 Mark Santos