Use this command to install Rusty Rain with WinGet:
winget install --id=cowboy8625.rusty-rain -e
Rusty Rain is a cross-platform terminal application designed to create customizable Matrix-style rain effects. Built using Rust, it offers smooth performance and extensive personalization options.
Key Features:
Customizable colors, characters, speed, and direction for unique visual effects
Support for various character groups including emojis, Japanese text, large letters, numbers, and more
Cross-platform compatibility with installation via winget on Windows
Ideal for developers, terminal enthusiasts, or anyone looking to add a dynamic screensaver to their workspace. Rusty Rain provides both entertainment and practicality with its flexible configuration options.
README
Rusty Rain
> Rusty Rain is a fast, cross-platform Matrix-style rain effect for your terminal, written in Rust.
> Fully customizable: colors, characters, speed, direction β make it as chill or chaotic as you want.
Default mode: green binary rain, classic Matrix look.
Press ESC, Ctrl + C, or q to quit.
π¨ Examples
# Japanese characters, teal rain, white head, flowing left
rusty-rain -C 0,139,139 -H 255,255,255 -g jap -s -d left
# Emoji chaos
rusty-rain -g emojis -C red -H yellow -S 0,50
# Large letters in bright blue, rain up
rusty-rain -g large-letters -C blue -H white -d up
βοΈ Customization
Full CLI Options
Cross platform CMatrix like program.
Usage: rusty-rain [OPTIONS]
Options:
-s, --shade
-g, --group
Set what kind of characters are printed as rain.
OPTIONS:
all - This shows most of the Character Groups all at once.
alphalow - Lower Case Alphabet Characters
alphaup - Upper Case Alphabet Characters
arrow - Arrow Emojis or Fancy Characters
bin - All Ones and Zeros
cards - Playing Cards
classic - closer to what the default look is for cmatrix
clock - π
crab - π¦
dominosh - π½
dominosv - π«
earth - π
emojis - This is just a bunch of random Emojis
jap - Japanese Characters
large-letters - Cool Looking Large Letters
moon - π
num - Good ol fashion Numbers
numbered-balls - These are like pool balls
numbered-cubes - These are like the pool balls but just cubes
open-source - Open Source icon emojis
pglangs - These are programming language icons emojis
plants - Plants of sorts
shapes - Squares and Circles of a few colors
smile - π
[default: bin]
-C, --color
Set color of Rain with color string name or tuple
OPTIONS:
white,
red,
blue,
green,
r,g,b
[default: green]
-B, --bg-color
Set background color of Rain with color string name or tuple
OPTIONS:
white,
red,
blue,
green,
r,g,b
-G, --shade-gradient
Set shade gradient color of Rain.
OPTIONS:
white,
red,
blue,
green,
r,g,b,
#RRGGBB
[default: #000000]
-H, --head
Set the color of the first char in Rain.
OPTIONS:
white,
red,
blue,
green,
r,g,b,
#RRGGBB
[default: white]
-d, --direction
Set the direction of the Rain.
Default is set to down/south
OPTIONS:
up or north,
down or south,
left or west,
right or east
[default: south]
-S, --speed
[default: 0,200]
-D, --display-group
Display Char Group
-h, --help
Print help (see a summary with '-h')
-V, --version
Print version
Config Options
> [!NOTE]
> Things in config will override CLI options.
> This probably will change in the future.
# windows path %APPDATA%\\rusty-rain\\config.toml
# linux path ~/.config/rusty-rain/config.toml
# mac path ~/.config/rusty-rain/config.toml
speed = "0,200"
[groups.neovim]
range = [
{ start = 62319, end = 62320 },
]
width = 2
[groups.rust]
range = [
{ start = 59304, end = 59305 },
]
width = 2
π Contributing
We welcome:
π Bug reports
π‘ Feature requests
π€ New character groups
π§βπ» Code contributions
Open an issue or pull request β letβs make it rain together. π€£