rmatrix 0.1.7

A fun and creative Matrix digital rain animation for your terminal.

Rmatrix - Personal Digital Rain Animation

Rmatrix is a high-fidelity digital rain animation for your terminal, inspired by the iconic visuals of The Matrix. Featuring 3D parallax depth, hand-calibrated 256-color palettes, and zero dependencies.

🎬 Live Demo

Experience the high-fidelity web version at rmatrix.netlify.app.

🚀 Installation

For Global Use (Recommended)

To run Rmatrix from anywhere without manually activating a virtual environment, use pipx:

pipx install rmatrix

For Development / Local Use

pip install rmatrix

🎮 Usage

Simply run:

rmatrix

Or use the shorter alias:

rmx

Command Line Flags

Short	Long	Description	Default
-c	--color	Rain color palette (see table below)	green
-s	--speed	Animation speed multiplier (0.1 - 5.0)	1.0
-d	--density	Stream density (light, medium, heavy)	medium
-ch	--chars	Character set (matrix, katakana, ascii, digits, symbols, binary)	matrix
-l	--length	Trail length (short, medium, long)	medium
-f	--fps	Target frames per second (5 - 60)	30
-b	--bookmark	Central glowing text overlay	""
-mr	--mutation-rate	Frequency of glyph scrambling (0.0 - 1.0)	0.05
-df	--default	Save current flags as factory defaults	false
--reset		Reset all settings to factory defaults	false
--no-256		Force 8-color mode (legacy terminals)	false
--no-bold		Disable bold text intensity	false
-v	--version	Show program version and exit

Color Palettes

Rmatrix features 17 hand-crafted color palettes optimized for 256-color terminals:

Name	Description
green	Classic Matrix (Pure Green)
gold	High-glow Saffron (Brilliant)
silver	Metallic Grey (Reflective)
red	Crimson Stream
blue	Cyber Blue
cyan	Electric Aqua
yellow	Bright Amber
magenta	Deep Purple
orange	Sunset Saffron
violet	Neon Lavender
pink	Hot Pink
lavender	Soft Purple
midnight	Deep Navy
sunset	Red-to-Orange Gradient
forest	Deep Wood Greens
blood	Dark Crimson Pulse
ocean	Deep Sea Aqua

🛠 Requirements

• Python 3.6+
• Terminal with curses support (Linux/macOS)
• Windows: Windows Terminal or PowerShell recommended.

📄 License

MIT License - see LICENSE for details.

---