confettysh

Display confetti animation in the terminal

$ confettysh

$ confettysh --duration [5]

$ confettysh --colors "[red,green,blue,yellow]"

$ confettysh --count [100]

$ confettysh --speed [2.0]

$ [some_command] && confettysh

confettysh [options]

confettysh is a terminal tool that displays a colorful confetti animation. It's designed for celebrating successful command completions, build finishes, or just adding some fun to terminal workflows.
The animation uses Unicode characters or ASCII art to create falling confetti particles across the terminal window. Colors can be customized to match themes or preferences. The tool respects terminal dimensions and adapts to window size.
confettysh is often used in scripts to provide visual feedback when long-running tasks complete, such as deployment pipelines, test suites, or build processes. It adds a moment of celebration to otherwise text-heavy terminal work.

--duration SECONDS

How long the animation runs (default: 3).

Comma-separated list of colors to use.

Number of confetti particles.

Animation speed multiplier.

Use ASCII characters instead of emoji.

Display help information.

Display version information.

Requires a terminal with Unicode support for best results. Animation may appear differently depending on terminal emulator and font. The --no-emoji flag provides compatibility with terminals lacking Unicode support.

confettysh emerged from the trend of adding visual flair to terminal applications. Similar to other terminal celebration tools, it was inspired by web-based confetti animations and adapted for command-line use, providing developers a way to make terminal workflows more engaging.

sl(1), cowsay(1), lolcat(1), figlet(1)