Skip to content

oiwn/tarts

Repository files navigation

Crates.io Total Downloads Crates.io Downloads (recent) GitHub License codecov

🦀 TARTS: Terminal Arts 🎨

BLAZINGLY FAST terminal screensavers written in Rust!

tarts (shortcut from Terminal Arts) is a collection of MEMORY SAFE terminal-based screen savers that bring visual delight to your command line. Built with ZERO-COST ABSTRACTIONS, these screen savers run efficiently while providing stunning visual effects.

matrix demo

✨ Features

  • 🌧️ Matrix Rain: Experience the famous "Matrix" digital rain effect right in your terminal
  • 🧫 Conway's Game of Life: Watch the classic cellular automaton evolve before your eyes
  • 🧩 Maze Generation: Get lost in procedurally generated mazes
  • 🐦 Boids: Witness the emergent flocking behavior of these simulated birds
  • 🧊 3D Cube: Renders a rotating 3D cube using terminal graphics with braille patterns for higher resolution
  • 🦀 Crab: Animated crabs walking across your screen, interacting with each other and the environment
  • 🍩 Rotating Donut: A mesmerizing rotating donut rendered in the terminal
  • 🚰 Pipes: Watch pipes flow with a smooth animation
  • 🔥 Fire: A cozy fireplace effect to warm up your terminal
  • Plasma: Electric plasma effect with vibrant colors and smooth animations
  • 🎯 Blank: Simple blank screen with minimal resource usage

🚀 Installation

Homebrew (macOS & Linux)

brew tap oiwn/tap && brew install tarts

Cargo (Cross-platform)

cargo install tarts

Nix

Direct from GitHub (always latest version):

nix run github:oiwn/tarts -- matrix

Or from the nixpkgs (may be older version):

nix-shell -p tarts --run "tarts matrix"

Manual Download

Download the latest binary from GitHub Releases

🛠️ Usage

Run any effect by name:

tarts matrix   # The classic digital rain effect
tarts life     # Conway's Game of Life
tarts maze     # Watch a maze generate itself
tarts boids    # Bird-like flocking simulation
tarts cube     # 3D rotating cube using braille patterns
tarts crab     # Animated crabs with collisions
tarts donut    # Rotating donut
tarts pipes    # Pipes effect
tarts fire     # Fire effect
tarts plasma   # Electric plasma effect
tarts blank    # Simple blank screen

Controls: Press q, Esc, or Ctrl+C to exit

Quick Test: Try the most popular effect first!

tarts matrix

🎨 Effects Gallery

Effect Description Perfect for
matrix Classic digital rain falling down your screen Retro computing vibes
life Conway's cellular automaton evolution Watching patterns emerge
maze Procedurally generated maze in real-time Maze enthusiasts
boids Flocking simulation with emergent behavior Nature lovers
cube 3D rotating cube with braille patterns Geometry fans
crab Animated crabs walking and interacting Cute animations
donut Mathematical 3D donut rotation Math enthusiasts
pipes Smooth flowing pipe animations Mesmerizing effects
fire Cozy fireplace simulation Ambience and relaxation
plasma Electric plasma with vibrant colors Psychedelic effects
blank Minimal blank screen Resource conservation

🧪 Development

This project uses standard Rust tooling:

# Build the project
cargo build --release

# Run tests
cargo test

# Benchmark performance
cargo bench

🤝 Contributing

Contributions are welcome! Please feel free to submit pull requests, report bugs, and suggest features.

📜 License

This project is licensed under the MIT License.


Built with ❤️ and FEARLESS CONCURRENCY

About

Screen savers and visual effects for your terminal!

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages