source

266 Lines of Pure Swift

No Xcode project. No storyboards. No XIBs. One file, compiled with swiftc. The entire Matrix rain engine in a single pass.

matrix-bg.swift — 266 lines — AppKit + CoreText

install

Two Commands. Done.

Download the source, compile natively. No Homebrew. No package managers. Just the Swift compiler and two Apple frameworks.

Terminal — matrix-bg — 80×24

triggers

Four Ways to Summon the Rain

Idle screensaver, git hooks, shell wrappers, or Claude Code integration. Pick one, stack them all.

Idle Screensaver

TMOUT=60 in .zshrc — fullscreen mode after 1 minute idle. Any keypress dismisses.

# ~/.zshrc TMOUT=60 TRAPALRM() { matrix-bg --fullscreen & read -sk1 pkill matrix-bg }

Git Operations

Shell wrapper for git push/pull/fetch/clone. Wallpaper mode while operation runs.

# git wrapper git() { case "$1" in push|pull|fetch|clone) matrix-bg & local pid=$! command git "$@" kill $pid 2>/dev/null ;; *) command git "$@" ;; esac }

Shell Integration

_matrix_cmd wrapper — wraps any command in Matrix rain. Wallpaper mode auto-dismisses.

# usage _matrix_cmd() { matrix-bg & local pid=$! "$@" kill $pid 2>/dev/null } _matrix_cmd npm run build

Claude Code Hooks

PreToolUse/PostToolUse hooks in Claude Code settings. Triggers on git operations.

// settings.json { "hooks": { "PreToolUse": [{ "matcher": "Bash", "command": "matrix-bg &" }], "PostToolUse": [{ "matcher": "Bash", "command": "pkill matrix-bg" }] } }

architecture

Five Layers Deep

From NSApplication to pixel. A borderless window on every screen, drawing 150 characters at 30fps with zero-allocation CoreText rendering. Built-in 60-second auto-kill prevents runaway processes.

NSApplication

.accessory policy

NSWindow

borderless, all spaces

MatrixView

NSView subclass

CGContext

fill + text position

CTLineDraw

cached CTLine[]

~86KB

Binary Size

~12MB

Memory

<3%

CPU at 30fps

Frameworks

150

Characters

Modes

modes

Desktop vs. Screensaver

Wallpaper mode lives behind your windows. Screensaver mode covers everything. One flag toggles between them.

~/Projects $ ls
lead-enricher/
universal-search/
matrix-bg.swift
~/Projects $ _

Safari — dobepros.com
DobePros Suite
14 products. One dev.

$ matrix-bg

Renders behind all windows at desktop level +1. Your apps stay on top, but the rain fills every gap. Visible in Exposé and when dragging windows.

wallpaper mode

$ matrix-bg --fullscreen

Screensaver window level — covers everything. All screens. Dismisses instantly on mouse movement, keypress, or click. Auto-terminates after 60 seconds as a safety net.

screensaver mode

Designed with Intent. Hardened by Use.

Unified Resilience. Collective DNA.

This product is one of 22 specialized solutions in the DobePros suite—a sentient infrastructure that evolves through real-world execution. By leveraging a unified, self-learning DNA for data, security, and commerce, every tool benefits from cross-platform hardening and collective technical resilience.

100%

Proprietary

Zero

VCS Debt

24/7

Monitoring

Matrix DesktopOverlay