terminaltexteffects

Terminal Text Effects (TTE) provides a visual effects engine that renders animated text directly in a terminal. It can be used as a standalone command‑line application or imported as a Python library, allowing developers to add dynamic, colored animations to scripts, command‑line tools, or interactive sessions. The engine supports 256‑color and RGB hex palettes, complex character movement defined by paths, waypoints, and Bézier curves, and layered scenes with easing and synchronized progression.

The package includes a collection of built‑in effects that demonstrate features such as variable color gradients, event handling with custom callbacks, and a typed configuration dataclass that maps automatically to CLI arguments. All output is generated with standard ANSI escape sequences, preserving the terminal’s state and workflow without requiring external dependencies.

Installation is available via common Python package managers (pip, pipx, uv) and Nix, and the tool works in most modern terminals. Documentation covers both application usage and library integration, offering examples of random effect selection, seeding, and inclusion or exclusion of specific effects.