Terminal Utility · Shell Script · MIT Licensed

Elements in your shell.
Calm in your terminal.

Elemental is a dependency-free set of shell functions designed for macOS terminals. Source it directly into your shell profile to render looping ANSI-escape animations that spark a little joy.

Install with curl (zsh / bash)
%curl -fsSL https://slumberingthread.com/elemental.sh -o ~/.elemental.sh && echo 'source ~/.elemental.sh' >> ~/.zshrc && source ~/.zshrc

Flickering hearth in code.

Run the fire command to ignite a flickering loop of ascending flame particles inside your current terminal session.

Constructed utilizing ANSI-tailored gradient escapes. It renders warm ember drifts that sway dynamically. Exit anytime using standard keyboard break.

( . ) ( ) . . ( ) ( ) ) ( ) ) ( ) ( ) ###########
$ fire press [Ctrl+C] to stop

Gentle horizontal flow.

Run the water command to generate a calming, flowing wave ripple pattern that flows horizontally across the terminal window width.

Designed to serve as a calming backdrop during deep thinking or compilation breaks, moving with soft cyclic calculations.

~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~~~~~~~~~~~~~~~~~~~~
$ water press [Ctrl+C] to stop
🔥

fire

Warm orange and yellow vertical flicker animation. Emulates rising coals and fireplace embers.

🌊

water

Blue-cyan horizontal wave ripples. Flows with gentle sine-wave offsets based on line width.

🌬️

air

Light silver wind trails. Moves spacious air markers across columns in sweeping bursts.

🪨

earth

Coming Soon. Under development. Exploring cracking stone animations and slow root expansions.

🐚

Pure Shell

No npm packages, no Python binaries. Runs directly inside zsh or bash with standard commands.

ANSI Escape

Optimized terminal redraw loops prevent screen flashing and keep frame rates smooth.

MIT License. Open to Remix.

Elemental is completely open-source. Fork it, improve the escape sequences, compile new elements, or integrate it with your personal dotfiles scripts. If it made you smile, it did its job.

Fork on GitHub