Matrix Digital Rain Screensaver

A Matrix-style screensaver for macOS with a personalized intro sequence and real-time falling green characters.

Features

• Personalized intro — "Wake up, <your name>..." typed with a blinking cursor, using your Mac username
• Authentic digital rain — Matrix-Code font with 57 custom glyphs, glowing white heads and fading green trails
• Frame-rate independent — wall-clock timing for the intro, delta-time for the rain. Consistent speed at any FPS
• Multi-display & adaptive — scales to any screen resolution across all connected displays

Installation

Download

1. Download MatrixDigitalRain.saver.zip from Releases
2. Unzip and remove quarantine (quarantine is applied as it's not a signed app):

   xattr -cr ~/Downloads/MatrixDigitalRain.saver

3. Double-click MatrixDigitalRain.saver to install
4. Select it in System Settings > Screen Saver

Build from Source (no quarantine applied as you're the developer)

git clone https://github.com/cassmtnr/matrix-macos-screensaver.git
cd matrix-macos-screensaver

xcodebuild -project MatrixDigitalRain.xcodeproj \
  -scheme MatrixDigitalRain \
  -configuration Release \
  -derivedDataPath build \
  build

open build/Build/Products/Release/MatrixDigitalRain.saver

Requires macOS 11.0+.

Development

# Build
xcodebuild -project MatrixDigitalRain.xcodeproj \
  -scheme MatrixDigitalRain -configuration Release \
  -derivedDataPath build build

# Preview (Cmd+Q to quit)
swift preview.swift
swift preview.swift --duration 30

# Tests
xcodebuild -project MatrixDigitalRain.xcodeproj \
  -scheme MatrixDigitalRain -configuration Debug test

# Generate preview GIF (requires ffmpeg)
swift generate_preview.swift --help

Project Structure

MatrixDigitalRain/
├── MatrixConfig.swift           # All tunable constants
├── MatrixColumn.swift           # Single falling column logic
├── IntroSequence.swift          # "Wake up..." intro state machine
├── MatrixDigitalRainView.swift  # Main ScreenSaverView subclass
├── Matrix-Code.ttf              # Custom font (57 glyphs)
└── Info.plist

License

MIT