Play text art animations in your terminal! This package includes several pre-made animations like fireworks and a cozy fireplace that are embedded in the binary.
If the folder name is found on disk, firework(r)s will prefer it over the embedded animation. See below how to create your own animation :)
fireworkrs is available as a package in the AUR.
It can be installed with an AUR helper (e.g. paru
):
paru -S fireworkrs
cargo install fireworkrs
fireworkrs [folder] [loops]
Parameters (all optional):
[folder]
: Folder containing text art frames (numbered 0.txt, 1.txt, etc.). Defaults to 'fireworks'[loops]
: Number of times to loop the animation (-1 for infinite). Defaults to 20
Run with defaults (fireworks animation, 20 loops):
fireworkrs
Play the fireworks animation with custom loops:
fireworkrs fireworks 3
Enjoy a cozy fireplace forever:
fireworkrs fireplace -1
- Create a new folder for your animation
- Add text art frames as numbered .txt files (0.txt, 1.txt, 2.txt, etc.)
- Run fireworkrs with your folder name
This project is a Rust port of firew0rks by addyosmani. Thank you for the inspiration and the amazing ASCII art animations!
MIT