matrix

A simple digital rain Matrix-inspired effect in pure Bash. Just run it. No dependencies, no setup—just vibes.

---

Preview Instantly

Run it straight from your terminal, no installation needed:

bash <(curl -s https://raw.githubusercontent.com/saitamasahil/matrix/main/matrix)

This runs the default theme with random colors.

To use a specific color theme, pass a flag like this:

bash <(curl -s https://raw.githubusercontent.com/saitamasahil/matrix/main/matrix) --red

Check more flags below in the Available Themes section.

Tip: Use a dark or black terminal background to get the best visual effect.

---

Download and Install

Clone the repository:

git clone https://github.com/saitamasahil/matrix
cd matrix

(Optional) Install it globally so you can run matrix from anywhere:

sudo cp matrix /usr/local/bin

---

How to Use

Once installed, just type:

matrix             # Default: random color rain
matrix --green     # Classic Matrix green
matrix --red       # Red theme
matrix --low-power # Slower animation, uses less CPU

If you're running it directly:

./matrix

Tip: Use a dark or black terminal background to get the best visual effect.

---

Available Themes

Flag	Description
--green	Classic Matrix green
--orange	Orange rain
--blue	Blue rain
--red	Red rain
--cyan	Cyan rain
--purple	Purple rain
--sky	Sky blue rain
--amber	Amber/orange-yellow rain
--pink	Pink rain
--sakura	Cherry blossom pink rain
--ice	Icy light blue rain
--mint	Fresh mint rain
--peach	Peach rain
--lavender	Light lavender rain
--gold	Golden yellow rain
--silver	Silver rain
--lime	Bright lime rain
--teal	Calming teal rain
--rose	Bold rosy pink rain
--fire	Fiery rain
--white	Pure white rain
--rgb	Red, green, blue rain
(default)	Random color rain

---

Other Flags

Flag	Description
--help	Show the help panel
--low-power	Enables low FPS, uses less CPU

Example:

matrix --green --low-power

---

Requirements

• Bash 3.2+
• UTF-8 capable terminal (GNOME Terminal, iTerm2, Alacritty, etc.)
• Truecolor (24-bit) terminal support
• Terminal must support ANSI escape sequences
• Works on Linux, macOS, and WSL
• No external dependencies

---

Uninstall

If you installed with cp, remove it like so:

sudo rm /usr/local/bin/matrix

---

Inspired By

Originally inspired by the matrix project by wick3dr0se and, of course, the legendary visuals from The Matrix.

"I can only show you the door. You're the one that has to walk through it." — Morpheus