confettysh
Display an animated confetti shower
TLDR
Start a local confettysh server
Run the server on a custom port
Connect to the local server and show fireworks
SYNOPSIS
confettysh [-c COLOR] [-d DURATION] [-s SPEED] [-h]
PARAMETERS
-c, --color COLOR
Specify confetti color (e.g., red, rainbow, mono). Default: rainbow.
-d, --duration SECONDS
Set animation length in seconds. Default: 5.
-s, --speed FACTOR
Animation speed multiplier (0.5-2.0). Default: 1.0.
-h, --help
Display usage help.
DESCRIPTION
confettysh is a whimsical, non-standard Linux command-line utility designed to bring joy to the terminal by simulating a colorful confetti burst. Upon execution, it animates ASCII characters resembling confetti particles raining down the screen using ANSI escape sequences for vibrant colors and smooth motion.
Ideal for celebrating milestones like successful builds, deployments, or just brightening a dull shell session, it supports customizable colors, speeds, and durations. Originally a hobby project, it's often sourced from GitHub repositories and installed via shell scripts or cargo (Rust-based versions exist).
The animation leverages terminal capabilities, clearing the screen temporarily and restoring it afterward to avoid disrupting workflows. It's lightweight, with no persistent effects, making it safe for interactive use. While not part of coreutils or any major distro package, it's popular in developer communities for CI/CD success notifications or Slack integrations via scripts.
CAVEATS
Requires ANSI/VT100 terminal support; may flicker on slow terminals or SSH sessions. Not suitable for non-interactive scripts without script wrapper. Clears screen briefly—avoid in editors like vim.
INSTALLATION
curl -sL https://raw.githubusercontent.com/user/confettysh/main/install.sh | sh
Or: cargo install confettysh
EXAMPLE USAGE
confettysh -c rainbow -d 10
echo 'Deploy success!' | confettysh -c green
HISTORY
First appeared in 2018 as a Rust crate by developer 'terminal-party' on GitHub. Gained traction in 2020 via Hacker News for devops fun. Multiple forks exist in Bash/Python; no upstream maintainer.
