catalan-adobe/screencast

Record your screen to video from Claude Code. Guided capture setup: pick a display, window, or screen region, then start/stop recording on demand. Uses ffmpeg — cross-platform (macOS, Linux, Windows). Produces MP4 with sensible defaults. Pairs with demo-narrate for voice-over. Triggers on: screencast, record screen, screen recording, capture screen, record window, record region, start recording, screen capture video.

100

Quality

100%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

Securityby

Passed

No known issues

Screencast Reference

Name: catalan-adobe/screencast
Rating: 1 (1 reviews)
Author: catalan-adobe

Platform Features (macOS only)

On macOS, two additional commands provide interactive selection:

pick-window — Click on any window to select it. Shows a blue highlight on hover. Returns JSON with {id, app, title, x, y, w, h}.
pick-region — Drag a rectangle on screen to select a capture area. Shows dimensions while dragging. Returns JSON with {x, y, w, h}.

Both require Xcode Command Line Tools (xcode-select --install). The Swift helper compiles on first use (~1s) and is cached at ~/.cache/screencast/screencast-picker for subsequent runs.

Press Escape to cancel either picker. Returns {cancelled: true}.

Tips

Pairs with demo-narrate — record a silent screencast, then use demo-narrate to add AI-generated voice-over.
Window recording on macOS accounts for Retina scaling automatically — coordinates are converted to physical pixels.
The recording process survives if Claude Code exits. Start a new session and run stop to end it.
Output uses H.264 with ultrafast preset — optimized for low CPU during recording, not minimal file size.
macOS permission: Screen recording requires the terminal app to be added to System Settings > Privacy & Security > Screen & System Audio Recording. If ffmpeg starts but produces no file, this is the likely cause. Grant the permission and retry.