Skip to content

jkuri/Reframed

Repository files navigation

AppIcon

Reframed

macOS screen recorder with a built-in editor. Capture your screen, windows, regions, or iOS devices over USB with webcam overlay, then edit and export.

Download

Grab the latest .dmg from the Releases page.

Or install via Homebrew (recommended):

brew install --cask jkuri/reframed/reframed

Features

Recording

  • Four capture modes: entire screen, single window, custom region or iOS device via USB
  • Multi-display support for screen recording
  • System audio and microphone capture with real-time level indicators
  • Webcam overlay (Picture-in-Picture) with option to hide preview while recording
  • Cursor position and click data captured at 120 Hz independently from video frame rate
  • Configurable FPS, countdown timer, and global keyboard shortcuts
  • .frm project bundles preserve all source recordings and editor state for re-editing

Video Editor

  • Timeline trimming with independent trim ranges for video, system audio, and microphone
  • Audio region editing with per-track volume and mute controls
  • Microphone noise reduction powered by RNNoise with adjustable intensity
  • Background styles: solid color, gradient presets, or custom image with fill modes
  • Canvas aspect ratios (original, 16:9, 1:1, 4:3, 9:16) with adjustable padding and corner radius
  • Webcam PiP with draggable positioning, corner presets, configurable size/radius/border/shadow/mirror
  • Webcam background replacement (blur, solid color, gradient, or custom image) via person segmentation
  • Camera regions — timeline-based webcam visibility control (fullscreen, hidden, or custom position) with entry/exit transitions (fade, scale, slide)
  • Video regions for cutting segments from the timeline
  • Undo/redo history with snapshot rollback
  • Fullscreen preview mode with seek and scrub

Cursor

  • Multiple SVG-based cursor styles with adjustable primary and outline colors
  • Click highlights with configurable color and size
  • Click sounds with 30 built-in samples across five categories (click, drop, select, switch, toggle)
  • Cursor movement smoothing with spring physics-based interpolation and speed presets
  • Spotlight effect that dims everything outside a radius around the cursor, with configurable radius, dim opacity, and edge softness
  • Spotlight regions on the timeline to control when the spotlight is active, with per-region style overrides and fade in/out transitions

Zoom & Pan

  • Manual keyframes - add zoom points on the timeline with configurable zoom level and center point using smooth Hermite easing
  • Auto-detection generates zoom keyframes from cursor click clusters based on configurable dwell threshold
  • Cursor-follow mode zoom viewport tracks cursor position in real time

Captions

  • On-device speech-to-text using WhisperKit (Apple Silicon)
  • Four model sizes: Base, Small, Medium, and Large (v3) — downloaded on first use
  • Word-level timestamps with automatic short-segment merging
  • Transcribe from microphone or system audio
  • Language selection with auto-detect option
  • Caption styling: font size, weight, position (top/center/bottom), text and background colors, background opacity, words per line
  • Burned-in captions on export, or SRT/VTT sidecar files

Export

  • Export to MP4, MOV or GIF
  • H.264, H.265 (HEVC), ProRes 422 and ProRes 4444 codecs
  • Platform presets for YouTube, Twitter/X, TikTok, Instagram, Discord, ProRes and GIF
  • GIF export powered by gifski with quality presets
  • Configurable FPS and resolution (Original, 4K, 1080p, 720p)
  • Parallel multi-core rendering for faster exports
  • Progress bar with ETA

Requirements

  • macOS 15.0 or later
  • Screen Recording permission
  • Accessibility permission (for cursor and keystroke capture)
  • Microphone permission (optional, for mic capture)
  • Camera permission (optional, for webcam overlay)

Build

# Debug build
make build

# Release build
make release

# Build and run
make dev

# Create DMG installer
make dmg

# Install to /Applications
make install

License

MIT