tarts

Crates.iotarts
lib.rstarts
version0.1.17
created_at2023-12-11 08:46:36.607929+00
updated_at2025-05-31 16:33:56.368375+00
descriptionScreen savers and visual effects for terminal
homepagehttps://github.com/oiwn/tui-screen-savers-rs
repositoryhttps://github.com/oiwn/tui-screen-savers-rs
max_upload_size
id1064851
size195,324
Alexander (oiwn)

documentation

https://docs.rs/tarts

README

Crates.io Total Downloads 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.

digital rain

โœจ 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

๐Ÿš€ Installation

Install directly using cargo:

cargo install tarts

or you can use it like a library for your own TUI app!

Nix

This repository also provides a nix flake:

nix run github:oiwn/tarts -- matrix

๐Ÿ› ๏ธ Usage

To use the screen savers, run the executable with the desired screen saver's name as an argument:

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    # Ferris the crab with collisions
tarts donut  # Rotating donut
tarts pipes  # Pipes effect

Press q or Esc to exit (or even Ctrl+C).

โš™๏ธ Configuration

Not implemented yet. I think it should be toml file where you can set options for effects.

๐Ÿงช 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

More?

Commit count: 196

cargo fmt