code.pablomurad.com

matrix-ss

Matrix digital rain screensavers for the terminal 

git clone https://code.pablomurad.com/matrix-ss.git

Recent commits

  1. 9c3d79d 
    New files
  2. bfe9cd3 
    matrix system
  3. 2813f04 
    new colors

Full log →

Readme

Matrix Screen Saver Collection

Python License Platform Terminal Status Versions Effects Interactive

A comprehensive collection of terminal-based Matrix-style screen savers featuring the iconic β€œdigital rain” effect with advanced visual enhancements, interactive features, and multiple themed variants for every occasion.

Features

Matrix Style Animation Controls Performance Variants Advanced Interactive Katakana

Core Features

  • 🌟 Authentic Matrix-style digital rain effect
  • 🎨 17 unique variants with different themes and effects
  • ⚑ Smooth animation (~20 FPS)
  • ⌨️ Simple controls (press β€˜q’ to quit)
  • 🐧 Linux/Unix/macOS compatible
  • 🎯 Lightweight and efficient

Advanced Effects

  • πŸ”₯ Fire gradient effects (blue β†’ red β†’ white)
  • 🌊 Wave motion patterns with color transitions
  • ⚑ Glitch effects with system error messages
  • 🎭 Trail fade effects for realistic motion blur
  • πŸ–ΌοΈ Progressive image revelation through Matrix rain
  • 🎡 Audio-reactive visual responses (simulated)

Enhanced Characters

  • πŸ‡―πŸ‡΅ Authentic Japanese Katakana characters
  • πŸ”€ Mixed ASCII and Unicode character sets
  • 🎲 Dynamic character selection algorithms
  • ⚑ Variable speed columns for realistic flow

Requirements

Python Version OS Library Dependencies Audio

Core Requirements

  • Python 3.x
  • Linux/Unix/macOS terminal
  • curses library (usually included with Python)

Optional Dependencies

  • psutil library (for system monitoring in matrix_system.py)
  • pyaudio or sounddevice (for real audio input in matrix_music.py)

Unicode Support

  • Terminal with Unicode/UTF-8 support (for Katakana characters in matrix_enhanced.py)

Installation

Dependencies Installation

# Install all dependencies
pip install -r requirements.txt

# Or install individually
pip install psutil  # For system monitoring (matrix_system.py)

# Optional: For real audio input (matrix_music.py)
# pip install pyaudio
# pip install sounddevice

Method 1: Direct Download

# Clone or download the repository
git clone <repository-url>
cd matrix-ss

# Make all scripts executable
chmod +x *.py

Method 2: Manual Setup

# Download all scripts to your desired location
# (All 10 matrix variants)

# Make executable
chmod +x matrix*.py

Usage

Basic Usage

# Classic Collection
python3 matrix.py              # Original green Matrix
python3 matrix_red.py          # Dramatic green + red
python3 matrix_rainbow.py      # Festive rainbow colors
python3 matrix_system.py       # System monitoring

# Enhanced Collection
python3 matrix_enhanced.py     # Katakana + fade effects
python3 matrix_fire.py         # Fire gradient effects
python3 matrix_glitch.py       # Glitch + error messages
python3 matrix_wave.py         # Wave motion patterns
python3 matrix_image.py        # Progressive image reveal
python3 matrix_music.py        # Audio-reactive (simulated)

Quick Start

# Make all executable and run your favorite
chmod +x *.py
./matrix_enhanced.py           # Recommended for best experience

Controls

  • Press β€˜q’ to quit the screen saver
  • Ctrl+C to force exit

Versions

Classic Collection

🟒 Classic Matrix (matrix.py)

The original Matrix screen saver with authentic green digital rain effect.

python3 matrix.py

Features: - 🌟 Authentic Matrix movie experience - 🟒 Green characters only - 🎬 Nostalgic classic look

πŸ”΄ Dramatic Matrix (matrix_red.py)

Enhanced version with red characters mixed with green for a more dramatic effect.

python3 matrix_red.py

Features: - 🟒 80% green characters - πŸ”΄ 20% red characters - ⚑ Dramatic visual impact - 🎭 Perfect for intense moments

🌈 Rainbow Matrix (matrix_rainbow.py)

Vibrant rainbow version with all colors of the spectrum for festive occasions.

python3 matrix_rainbow.py

Features: - 🌈 7 rainbow colors (Red, Yellow, Green, Cyan, Blue, Magenta, White) - πŸŽ‰ Perfect for celebrations and events - ✨ Vibrant and eye-catching - πŸŽͺ Great for demonstrations

πŸ–₯️ System Monitor Matrix (matrix_system.py)

Advanced version that displays real-time system information in the center while Matrix rain falls around it.

python3 matrix_system.py

Features: - πŸ–₯️ Real-time system monitoring (CPU, Memory, Disk, IP, Time, Date, User, Load) - πŸ”΄ System info displayed in red at center - 🟒 Matrix rain falls around the information panel - ⏰ Updates every second - 🎯 Perfect for system administrators and monitoring

Enhanced Collection

⭐ Enhanced Matrix (matrix_enhanced.py) - RECOMMENDED

New Katakana Fade

The most advanced version with authentic Japanese characters and realistic fade effects.

python3 matrix_enhanced.py

Features: - πŸ‡―πŸ‡΅ Authentic Katakana characters (70%) + ASCII (30%) - 🎭 Realistic trail fade effects - ⚑ Variable speed columns - 🌟 Most authentic Matrix experience - πŸ’« Character aging and disappearing effects

πŸ”₯ Fire Matrix (matrix_fire.py)

New

Matrix rain with dynamic fire gradient effects that change temperature over time.

python3 matrix_fire.py

Features: - πŸ”₯ Dynamic fire gradient (Blue β†’ Cyan β†’ Green β†’ Yellow β†’ Red β†’ Magenta β†’ White) - 🌑️ Heat levels that change over time - ❄️ Cool and hot zones - 🎨 7-stage color temperature system

⚑ Glitch Matrix (matrix_glitch.py)

New

Matrix with random glitch effects and system error messages for a cyberpunk feel.

python3 matrix_glitch.py

Features: - ⚑ Random glitch effects every 5-15 seconds - 🚨 System error messages (β€œERROR: SYSTEM BREACH DETECTED”) - 🎭 Corrupted character blocks (β–ˆβ–“β–’β–‘) - πŸ’₯ Flashing and color corruption effects - πŸ”΄ Red alert colors during glitches

🌊 Wave Matrix (matrix_wave.py)

New

Matrix rain influenced by sine wave patterns with dynamic color transitions.

python3 matrix_wave.py

Features: - 🌊 Sine wave motion patterns - 🎨 Color zones based on wave proximity (White β†’ Cyan β†’ Blue β†’ Green) - ⚑ Variable speed influenced by wave position - 〰️ Visible wave line indicator - πŸŒ€ Fluid, organic movement patterns

πŸ–ΌοΈ Image Reveal Matrix (matrix_image.py)

New

Matrix rain that gradually reveals hidden ASCII art with progress tracking.

python3 matrix_image.py

Features: - πŸ–ΌοΈ Progressive ASCII art revelation - πŸ“Š Real-time decoding progress bar - 🎨 Color-coded revelation stages (Yellow β†’ White β†’ Red) - πŸ’¬ β€œWAKE UP NEO” hidden message - 🎯 Interactive discovery experience

🎡 Music Matrix (matrix_music.py)

New Real Audio Smart Detection

Audio-reactive Matrix that responds to real microphone input or simulated audio with dynamic effects.

# Basic usage (simulated audio)
python3 matrix_music.py

# For real audio, install dependencies first:
pip install sounddevice numpy
# OR
pip install pyaudio numpy

# Then run with real audio input
python3 matrix_music.py

Features: - 🎀 Real microphone input (when libraries installed) - 🎭 Automatic fallback to realistic simulation - 🎡 Audio level visualization with progress bar - 🎨 Color intensity based on sound (Green β†’ Yellow β†’ Red β†’ Magenta β†’ White β†’ Cyan) - πŸ’“ Intelligent beat detection with special effects - ⚑ Speed changes based on audio intensity - πŸ“Š Real-time audio level display - 🎢 β€œBEAT!” indicator for rhythm detection - πŸ”§ Auto-detection of available audio libraries (sounddevice/pyaudio) - πŸ’¬ Status display showing audio mode for 3 seconds

Audio Libraries Supported: - sounddevice + numpy (recommended - easier installation) - pyaudio + numpy (alternative - more control) - Automatic simulation if no libraries available

Themed Collection

πŸ’Ž Neon Matrix (matrix_neon.py)

New Glow

Matrix with neon glow effects and pulsing brightness for a cyberpunk aesthetic.

python3 matrix_neon.py

Features: - πŸ’Ž Neon glow effects with variable intensity - 🌟 Pulsing brightness based on sine waves - ⚑ Flash effects and border illumination - 🎨 Multi-intensity color gradients (Dark β†’ Bright β†’ White) - πŸ’« Special neon colors (Magenta, Yellow highlights) - πŸ”† Column-based glow intensity system

πŸ”’ Binary Matrix (matrix_binary.py)

New Authentic

Pure binary Matrix using only 0s and 1s like in the original movie scenes.

python3 matrix_binary.py

Features: - πŸ”’ Only 0s and 1s - true to the movie - πŸ’¬ Hidden binary messages (β€œHello”, β€œMatrix”, β€œNeo”, β€œWake up”) - πŸ“Š Real-time binary counter display - 🎯 Data stream effects with horizontal flows - πŸ” Progressive message decoding with progress indicator - πŸ’» Authentic computer code aesthetic

πŸ’» Terminal Matrix (matrix_terminal.py)

New Interactive

Simulates a hacker terminal with realistic command execution in the center of Matrix rain.

python3 matrix_terminal.py

Features: - πŸ’» Realistic hacker commands (nmap, hydra, metasploit, etc.) - ⌨️ Simulated typing with realistic speed - πŸ“Ÿ System responses and command output - πŸ• Real-time timestamp display - 🎭 Terminal window with borders and title - πŸ”’ Cybersecurity tool simulation (ethical hacking commands)

🧬 DNA Matrix (matrix_dna.py)

New Scientific

Matrix displaying DNA sequences with complementary base pairs and genetic information.

python3 matrix_dna.py

Features: - 🧬 DNA bases only (A, T, G, C) with authentic color coding - πŸ”— Double helix visualization with complementary base pairs - πŸ§ͺ Famous DNA sequences (telomeres, restriction sites) - πŸ“Š Real-time base counting and analysis - πŸŒ€ Animated helix structure with connecting bonds - πŸ”¬ Scientific sequencer interface

🌐 Network Matrix (matrix_network.py)

New Live Data

Matrix displaying real network information and simulated traffic data.

python3 matrix_network.py

Features: - 🌐 Real network information (hostname, IP, connections) - πŸ“Š Network traffic visualization and statistics - πŸ”Œ Active port monitoring - πŸ“‘ Simulated packet flows (TCP, UDP, HTTP, SSH, etc.) - πŸ“ˆ Real-time traffic level indicator - πŸ–₯️ Network status monitoring

πŸ’° Crypto Matrix (matrix_crypto.py)

New Market Data

Matrix displaying cryptocurrency prices and market data with trading symbols.

python3 matrix_crypto.py

Features: - πŸ’° Cryptocurrency price tracking (BTC, ETH, ADA, DOT, LINK, XRP) - πŸ“ˆ Price trends with up/down indicators - πŸ’Ή Market sentiment analysis (Bull/Bear/Sideways) - 🎯 Crypto symbols rain (β‚Ώ, Ξ, β‚³, etc.) - πŸ“Š Real-time price changes and percentage tracking - πŸš€ Market status indicators with emojis

🌀️ Weather Matrix (matrix_weather.py)

New Meteorological

Matrix displaying weather information with climate-appropriate character effects.

python3 matrix_weather.py

Features: - 🌀️ Complete weather information (temperature, humidity, pressure, wind) - 🌧️ Weather-specific characters (β˜€οΈ, ☁️, 🌧️, β›ˆοΈ, ❄️, 🌫️) - 🎨 Dynamic colors based on weather conditions - ⚠️ Weather alerts (temperature, wind, UV, visibility warnings) - 🌑️ Comfort level indicators (Cold, Cool, Comfortable, Warm, Hot) - πŸ“Š Detailed meteorological panel with real-time updates

Complete Version Comparison

Version Colors Special Effects Best For Difficulty
Classic Collection
matrix.py Green only Classic rain Nostalgia, simplicity ⭐
matrix_red.py Green + Red Dramatic mix Alerts, intensity ⭐
matrix_rainbow.py 7 rainbow colors Festive colors Celebrations, demos ⭐
matrix_system.py Green + Red + Yellow System monitoring Admin work ⭐⭐
Enhanced Collection
matrix_enhanced.py Green gradients Katakana + fade Best overall ⭐⭐⭐
matrix_fire.py Fire gradient Heat simulation Visual impact ⭐⭐
matrix_glitch.py Multi + corruption Error messages Cyberpunk feel ⭐⭐
matrix_wave.py Wave-based Sine motion Fluid animation ⭐⭐⭐
matrix_image.py Progressive reveal ASCII art Interactive fun ⭐⭐⭐
matrix_music.py Audio-reactive Beat detection Parties, music ⭐⭐⭐⭐
Themed Collection
matrix_neon.py Neon gradients Pulsing glow Cyberpunk aesthetic ⭐⭐
matrix_binary.py Green + White Binary only Movie authenticity ⭐
matrix_terminal.py Multi-colored Hacker simulation Educational/Demo ⭐⭐⭐
matrix_dna.py Scientific colors DNA sequences Science/Education ⭐⭐⭐
matrix_network.py Traffic-based Network monitoring IT/Networking ⭐⭐
matrix_crypto.py Market-based Price tracking Finance/Trading ⭐⭐
matrix_weather.py Weather-based Climate data Weather monitoring ⭐⭐

How It Works

Basic Algorithm

The screen saver creates a full-screen terminal animation where: - Random characters fall from the top of the screen - Each column has its own falling speed and position - Characters are displayed with various color schemes - The effect continues until you press β€˜q’ to exit

Advanced Features

  • Trail Effects: Characters fade over time for realistic motion blur
  • Variable Speeds: Different columns fall at different rates
  • Dynamic Colors: Color changes based on effects (fire, wave, audio)
  • Interactive Elements: Progress bars, system info, error messages
  • Unicode Support: Authentic Japanese Katakana characters

Technical Details

Performance

  • Frame Rate: ~20 FPS (50ms intervals)
  • Memory Usage: Minimal (< 10MB for most variants)
  • CPU Usage: Low impact on system performance
  • Terminal: Uses curses library for efficient terminal manipulation

Character Sets

  • ASCII: Printable characters (33-126) for compatibility
  • Katakana: Authentic Japanese characters (をむウエγ‚ͺ…)
  • Special: Block characters for glitch effects (β–ˆβ–“β–’β–‘)
  • Unicode: Full UTF-8 support where available

Color Systems

  • 8-Color: Standard terminal colors (Red, Green, Blue, etc.)
  • Gradients: Smooth transitions between color states
  • Dynamic: Real-time color changes based on effects
  • Compatibility: Works with all curses-compatible terminals

Troubleshooting

Common Issues

  1. β€œcurses module not found” β€œ`bash

    Install python3-curses (Ubuntu/Debian)

    sudo apt-get install python3-curses

# Or for CentOS/RHEL sudo yum install python3-curses


2. **Terminal not supported**
   - Ensure you're using a terminal emulator that supports `curses`
   - Try running in a different terminal (xterm, gnome-terminal, etc.)

3. **Permission denied**
   ```bash
   chmod +x matrix.py

Terminal Compatibility

xterm gnome-terminal konsole iTerm2 Alacritty Windows CMD

  • βœ… xterm
  • βœ… gnome-terminal
  • βœ… konsole
  • βœ… iTerm2 (macOS)
  • βœ… Alacritty
  • ❌ Windows Command Prompt (not supported)

Customization

You can modify any of the scripts to change: - Speed: Adjust time.sleep(0.05) value - Colors: Modify the color pairs in each script - Characters: Change the range in random.randint(33, 126) - Frame rate: Modify the timeout(100) value - Color distribution: Adjust the probability ratios in matrix_red.py - Rainbow colors: Add/remove colors from the rainbow_colors list in matrix_rainbow.py

License

This project is open source. Feel free to modify and distribute as needed.

Contributing

Contributions are welcome! Feel free to: - Report bugs - Suggest improvements - Submit pull requests

Acknowledgments

Inspired by the iconic Matrix digital rain effect from the 1999 film β€œThe Matrix” directed by the Wachowskis.

Enjoy your Matrix screen saver experience! πŸ•ΆοΈ