retr0h
diff --git a/‎.gitignore‎
Lines changed: 1 addition & 0 deletions b/‎.gitignore‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎CLAUDE.md‎
Lines changed: 23 additions & 14 deletions b/‎CLAUDE.md‎
Lines changed: 23 additions & 14 deletions
diff --git a/‎README.md‎
Lines changed: 29 additions & 14 deletions b/‎README.md‎
Lines changed: 29 additions & 14 deletions
diff --git a/‎asset/dvd.png‎
672 KB b/‎asset/dvd.png‎
672 KB
diff --git a/‎asset/pipes.png‎
810 KB b/‎asset/pipes.png‎
810 KB
diff --git a/‎asset/screensaver.png‎
-91.5 KB b/‎asset/screensaver.png‎
-91.5 KB
diff --git a/‎asset/worms.png‎
712 KB b/‎asset/worms.png‎
712 KB
@@ -4,3 +4,4 @@ dist/
 docs/node_modules/
 docs/bun.lock
 .just/remote/
+.superpowers/
@@ -10,9 +10,17 @@ tlock is a terminal lock program for macOS written in Go. It locks the terminal
 
 Single-binary Go program using CGo for macOS system integration:
 
-- **`main.go`** - Entry point, terminal handling, lock screen UI, auth flow
+- **`main.go`** - Entry point, flag parsing, terminal setup, screensaver dispatch
+- **`terminal.go`** - Terminal utilities (clear, cursor, centering, lock icon, resize)
+- **`auth.go`** - CGo Touch ID + PAM authentication, password overlay
+- **`style.go`** - Lipgloss styles, color palette, message rendering
+- **`grid.go`** - Grid cell system (3x2 chars), block drawing, phosphor colors
+- **`screensaver.go`** - Screensaver interface, factory registry, random selection
+- **`screensaver_worm.go`** - Worms screensaver (xlock-style)
+- **`screensaver_dvd.go`** - Bouncing padlock screensaver
+- **`screensaver_pipes.go`** - Growing pipes screensaver
 - **CGo** - Touch ID via `LocalAuthentication.framework`, password via PAM (`pam_authenticate`)
-- **lipgloss** - Terminal styling (purple/teal/gray color palette)
+- **lipgloss** - Terminal styling (teal/gray/red color palette)
 - **golang.org/x/term** - Raw terminal mode, terminal size detection
 
 ## Key Technical Details
@@ -30,7 +38,7 @@ Single-binary Go program using CGo for macOS system integration:
 
 ```bash
 go build -o tlock .    # Build binary
-go run main.go         # Run directly (will lock terminal!)
+go run . --worms       # Run directly (will lock terminal!)
 ```
 
 ## Usage
@@ -39,30 +47,32 @@ go run main.go         # Run directly (will lock terminal!)
 # Direct (password prompt only)
 tlock
 
-# Worms immediately
-tlock --snake
+# Screensavers (immediate)
+tlock --worms                  # Worms
+tlock --pipes                  # Growing pipes
+tlock --dvd                    # Bouncing padlock
+tlock --random                 # Random pick
+tlock --random --cycle 5m      # Rotate every 5 min
 
-# Screensaver after 30s idle
-tlock --screensaver
-
-# Custom delay
-tlock --screensaver --screensaver-delay 60
+# With idle delay
+tlock --worms --delay 30s      # Worms after 30s idle
 
 # As tmux lock-command
-set -g lock-command "tlock --snake"
+set -g lock-command "tlock --random --cycle 5m"
 set -g lock-after-time 1800
 bind ^X lock-server
 ```
 
 ## Color Palette
 
 ```
-Purple  = lipgloss.Color("99")       // Headers, lock title
 Teal    = lipgloss.Color("#06ffa5")  // Accent, prompts, blinking cursor
 Gray    = lipgloss.Color("245")      // Dim/secondary text (hostname, hints)
 Red     = lipgloss.Color("196")      // Errors (auth failed)
 ```
 
+Screensavers use a 13-color retro phosphor CRT palette defined in `wormColors` (grid.go).
+
 ## Code Standards
 
 - Follow [Conventional Commits](https://www.conventionalcommits.org/) for commit messages
@@ -73,5 +83,4 @@ Red     = lipgloss.Color("196")      // Errors (auth failed)
 
 ## Roadmap
 
-- Phase 2: xlock-style worm screensaver with fading trails + cycling figurine text
-- Phase 3: Configuration file support (`~/.config/tlock/config.yaml`)
+- 1Password CLI integration
@@ -27,14 +27,24 @@ A terminal lock screen for macOS that uses **Touch ID** for biometric unlock wit
 
 <table align="center">
   <tr>
-    <td align="center" width="33%"><a href="asset/screensaver.png"><img src="asset/screensaver.png" width="100%" alt="Worm Screensaver"></a></td>
-    <td align="center" width="33%"><a href="asset/passphrase.png"><img src="asset/passphrase.png" width="100%" alt="Passphrase Prompt"></a></td>
-    <td align="center" width="33%"><a href="asset/touchid.png"><img src="asset/touchid.png" width="100%" alt="Touch ID Prompt"></a></td>
+    <td align="center" width="33%"><a href="asset/worms.png"><img src="asset/worms.png" width="100%" alt="Worms Screensaver"></a></td>
+    <td align="center" width="33%"><a href="asset/dvd.png"><img src="asset/dvd.png" width="100%" alt="DVD Screensaver"></a></td>
+    <td align="center" width="33%"><a href="asset/pipes.png"><img src="asset/pipes.png" width="100%" alt="Pipes Screensaver"></a></td>
+  </tr>
+  <tr>
+    <td align="center"><sub>Worms</sub></td>
+    <td align="center"><sub>DVD</sub></td>
+    <td align="center"><sub>Pipes</sub></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="asset/passphrase.png"><img src="asset/passphrase.png" width="100%" alt="Passphrase Prompt"></a></td>
+    <td align="center"><a href="asset/touchid.png"><img src="asset/touchid.png" width="100%" alt="Touch ID Prompt"></a></td>
+    <td></td>
   </tr>
   <tr>
-    <td align="center"><sub>Screensaver</sub></td>
     <td align="center"><sub>Passphrase</sub></td>
     <td align="center"><sub>Touch ID</sub></td>
+    <td></td>
   </tr>
 </table>
 
@@ -86,17 +96,20 @@ sudo mv tlock /usr/local/bin/
 Run directly:
 
 ```bash
-tlock                                        # Password prompt only
-tlock --snake                                # Worms immediately
-tlock --screensaver                          # Worms after 30s idle (default delay)
-tlock --screensaver --screensaver-delay 60   # Worms after 1 min idle
+tlock                          # Password prompt only
+tlock --worms                  # Worms screensaver
+tlock --pipes                  # Pipes screensaver
+tlock --dvd                    # Bouncing lock screensaver
+tlock --random                 # Random screensaver
+tlock --random --cycle 5m      # Rotate screensaver every 5 min
+tlock --worms --delay 30s      # Worms after 30s idle
 ```
 
 As a tmux lock command:
 
 ```tmux
 # ~/.tmux.conf
-set -g lock-command "tlock --snake"
+set -g lock-command "tlock --random --cycle 5m"
 set -g lock-after-time 1800    # Lock after 30 min idle
 bind ^X lock-server            # Ctrl+X to lock now
 ```
@@ -105,13 +118,14 @@ bind ^X lock-server            # Ctrl+X to lock now
 
 tlock brings the classic [xlock](https://linux.die.net/man/1/xlock) experience to your terminal — an animated screensaver that kicks in when your terminal is locked, with authentication required to dismiss it.
 
-1. 🐍 **Screensaver mode** (`--snake`): xlock-style worms animate across the screen
+1. 🎨 **Pick a screensaver** — `--worms`, `--pipes`, `--dvd` (bouncing lock), or `--random`
 2. ⌨️ **Any keypress** pauses the screensaver and shows the passphrase prompt
 3. 🔑 **Type your macOS password** and press Enter to unlock
 4. 🖐️ **Press Esc** to switch to Touch ID — authenticate with your fingerprint
 5. 🚫 Wrong password? **ACCESS DENIED** — back to the screensaver
+6. 🔄 **Cycle mode** — `--random --cycle 5m` rotates screensavers automatically
 
-Without `--snake` or `--screensaver`, tlock shows the passphrase prompt directly.
+Without a screensaver flag, tlock shows the passphrase prompt directly.
 
 All signals (SIGINT, SIGTERM, SIGTSTP) are ignored. The only way out is authentication. 🔐
 
@@ -136,9 +150,10 @@ tlock is inspired by [xlock](https://linux.die.net/man/1/xlock), the classic X11
 
 ## 🗺️ Roadmap
 
-- [x] 🐛 xlock-style worm screensaver with fading trails
-- [ ] 🔤 Additional screensaver modes (cycling figurine text, matrix rain, etc.)
-- [ ] ⚙️ Configuration file (`~/.config/tlock/config.yaml`)
+- [x] 🪱 xlock-style worm screensaver with fading trails
+- [x] 🔒 Bouncing DVD padlock screensaver
+- [x] 🔲 Pipes screensaver with fade-out reset
+- [x] 🎲 Random screensaver selection with `--cycle` rotation
 - [ ] 🔐 1Password CLI integration
 
 ## 📄 License