tarts

Crates.io	tarts
lib.rs	tarts
version
source	src
created_at	2023-12-11 08:46:36.607929+00
updated_at	2025-03-29 02:03:13.982032+00
description	Screen savers and visual effects for terminal
homepage	https://github.com/oiwn/tui-screen-savers-rs
repository	https://github.com/oiwn/tui-screen-savers-rs
max_upload_size
id	1064851
Cargo.toml error:	TOML parse error at line 18, column 1 \| 18 \| autolib = false \| ^^^^^^^ unknown field `autolib`, expected one of `name`, `version`, `edition`, `authors`, `description`, `readme`, `license`, `repository`, `homepage`, `documentation`, `build`, `resolver`, `links`, `default-run`, `default_dash_run`, `rust-version`, `rust_dash_version`, `rust_version`, `license-file`, `license_dash_file`, `license_file`, `licenseFile`, `license_capital_file`, `forced-target`, `forced_dash_target`, `autobins`, `autotests`, `autoexamples`, `autobenches`, `publish`, `metadata`, `keywords`, `categories`, `exclude`, `include`
size	0

oiwn (oiwn)

documentation

https://docs.rs/tarts

README

Crates.io Total Downloads GitHub License

🦀 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

🚀 Installation

Install directly using cargo:

cargo install tarts

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

🛠️ 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

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?

Args parser to run with configuration (yaml or something)
add pipes? https://asciinema.org/a/427066
add cellular automation like https://www.reddit.com/r/neovim/comments/z70mg3/cellularautomatonnvim_my_first_plugin/

Commit count: 92