TMatrix(6)

💚 TMatrix — the terminal rain page

okay bestie, sit DOWN. this is TMatrix(6), living in the Games Manual section, and it's literally the digital rain from The Matrix but in your terminal. no cap. 🦋

---

✨ NAME ✨

TMatrix — a terminal based replica of the digital rain from The Matrix. that's it, that's the whole vibe. green characters falling forever, and you get to control every single thing about it. iconic behavior honestly. 💅

---

🌧️ SYNOPSIS 🌧️

tmatrix [--version] [--help] [--mode=MODE]
        [-s VALUE | --steps-per-sec=VALUE]
        [-f RANGE | --fall-speed=RANGE] [-G RANGE | --start-gap=RANGE]
        [-g RANGE | --gap=RANGE] [-l RANGE] [-r RANGE] [--fade]
        [--no-fade] [-C COLOR | --color=COLOR]
        [-c COLOR | --background=COLOR] [-t TEXT | --title=TEXT]

---

👑 DESCRIPTION 👑

it simulates the digital rain effect from The Matrix. that's the whole job and it does it flawlessly, no notes. 🎀

---

💖 OPTIONS 💖

• --version — spits out the version info and dips. exit stage left. ✌️
• --help — shows you this help and bounces. also exits.
• --mode=MODE — picks the mode of the rain, like a whole aesthetic switch. available modes: default, dense.
• -s, --steps-per-sec=VALUE — run this many steps per second. VALUE can be anywhere from 1 to 60. default: 10. 🏃♀️
• -f, --fall-speed=RANGE — sets the range for the fall speed. speeds are allowed to have decimal parts (like 1.2), and the maximal fall speed value is 10.0. default: 0.5,1.5. gravity? we invented her. 🍓
• -G, --start-gap=RANGE — sets the range for the starting gaps. default: 10,50.
• -g, --gap=RANGE — sets the range for the gaps between streaks. default: 0,40. personal space matters bestie. 🫶
• -l RANGE — sets the range for the length of rain streaks. the minimal length value is 1. default: 1,30. long hair, don't care. 💜
• -r RANGE — sets the range for the character update rate. these values correspond to the number of steps before the change, and 0 represents no change. default: 10,20.
• --fade — enable fading characters. this is the default btw. ✨
• --no-fade — disable fading characters. if you hate ambiance, i guess. 💀
• -C, --color=COLOR — sets the color of the characters. available colors: default, white, gray, black, red, green, yellow, blue, magenta, cyan. default: green. (obviously. it's giving matrix. 🌈)
• -c, --background=COLOR — sets the color of the background. available colors: default, white, gray, black, red, green, yellow, blue, magenta, cyan.
• -t, --title=TEXT — sets the title that appears in the rain. 🌸

note: the title needs to fit within the terminal window in order to be displayed. so keep it cute but keep it SHORT, bestie. 😭

---

RANGE is a pair of numbers separated by a comma: MIN,MAX. it specifies the boundaries of a set from which random numbers are picked. so like, chaos but with rules. 💫

---

🕹️ Real-time commands 🕹️

• p — pause. take a breath, bestie. 🙈
• q — quit. main character exit. 👑

---

🎀 AUTHORS 🎀

written by Miloš Stojanović <mc.cm.mail@gmail.com> — shoutout to the icon who built this, fr fr. 💖

---

📜 LICENSE 📜

Copyright (C) 2018-2021 Miloš Stojanović
SPDX-License-Identifier: GPL-2.0-only

---

🦋 SEE ALSO 🦋

• cmatrix(1) — the cousin. the relative. the other one. iykyk.

---

okay so that's the whole page, slay. this is TMatrix Version 1.4, dated 26 November 2021, and it lives in the Games Manual section of the docs. go make your terminal rain, bestie 🌧️💚 periodt.