https://github.com/jkuri/reframed
A powerful, native macOS screen recorder with a built-in timeline editor. Capture your screen or iOS devices, then instantly trim, apply auto-zoom, style backgrounds, and export in high quality.
https://github.com/jkuri/reframed
60fps audio-recording avfoundation compositor macos macos-app menubar native-mac-app screen-capture screen-recorder swiftui video-compression video-editor video-recording
Last synced: about 2 months ago
JSON representation
A powerful, native macOS screen recorder with a built-in timeline editor. Capture your screen or iOS devices, then instantly trim, apply auto-zoom, style backgrounds, and export in high quality.
- Host: GitHub
- URL: https://github.com/jkuri/reframed
- Owner: jkuri
- License: mit
- Created: 2026-02-08T18:00:11.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-02-24T19:03:39.000Z (4 months ago)
- Last Synced: 2026-02-24T22:18:19.090Z (4 months ago)
- Topics: 60fps, audio-recording, avfoundation, compositor, macos, macos-app, menubar, native-mac-app, screen-capture, screen-recorder, swiftui, video-compression, video-editor, video-recording
- Language: Swift
- Homepage: https://reframed.dev
- Size: 13.5 MB
- Stars: 28
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
#
Reframed
> Open-source macOS screen recorder and capture editor. A free alternative to Screen Studio - capture your screen, windows, or iOS devices with a webcam overlay, then edit on a timeline with auto-captions and smooth cursor zooms.
## The idea
Screen recorders give you a raw .mp4. Getting cursor-tracking zoom effects, auto-captions, or webcam overlays on top of that usually means paying for a proprietary app. Reframed is the open-source alternative - record, edit and export in one app.
### Core features
- **Capture and edit in one place.** Record your screen, window, or region, then go straight into the built-in editor. No round-tripping through other tools.
- **Zoom and pan that follow your cursor.** Auto-zoom detects where you click and generates keyframes. You can also place them manually or lock the viewport to your cursor.
- **Noise reduction built in.** Microphone audio runs through RNNoise, so you don't need a separate audio chain to clean up background noise.
- **Webcam overlay and fullscreen sections.** Drop your camera feed in as a PiP or switch to fullscreen webcam for specific segments on the timeline.
- **Export exactly what you need.** Pick your codec, resolution, and FPS. Platform presets handle the rest for YouTube, Twitter/X, TikTok, and others.
## Install
Via `homebrew` (recommended):
```bash
brew install --cask jkuri/reframed/reframed
```
Or grab the `.dmg` from [Releases](https://github.com/jkuri/reframed/releases).
## Features
### Recording
- **Four capture modes:** entire screen, single window, custom region, or iOS device via USB. Multi-display support included.
- **System audio and microphone** capture with real-time level indicators
- **Webcam overlay** (Picture-in-Picture) that can be hidden while recording
- **120 Hz cursor tracking** records position and click data independently from video frame rate
- **`.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
- **Noise reduction** powered by [RNNoise](https://github.com/xiph/rnnoise) at adjustable intensity
- **Background styles:** solid color, gradient presets, or custom image (multiple fill modes)
- **Canvas aspect ratios** (original, 16:9, 1:1, 4:3, 9:16) plus adjustable padding and corner radius
- **Webcam PiP** with draggable positioning, corner presets, size/radius/border/shadow/mirror
- **Webcam background replacement** via person segmentation (blur, solid color, gradient, or custom image)
- **Camera regions** set webcam visibility per-segment on the timeline (fullscreen, hidden, or custom position) with entry/exit transitions
- **Video regions** for cutting segments from the timeline
- **Undo/redo history** and fullscreen preview with scrub
### Cursor
- **Custom cursor styles** with SVG-based designs, adjustable primary and outline colors
- **Click highlights** and **click sounds** (30 built-in samples across five categories)
- **Cursor effects:** click bounce, directional sway, and motion blur with adjustable intensity
- **Movement smoothing** using spring physics-based interpolation and speed presets
- **Spotlight effect** dims everything outside a radius around the cursor. Timeline regions control when it's active.
### Zoom & pan
- **Manual keyframes** on the timeline to set zoom level and center point, eased with Hermite interpolation
- **Auto-zoom** detects cursor click clusters and generates keyframes from dwell time
- **Cursor-follow mode** keeps the viewport locked to cursor position in real time
### Captions
- **On-device speech-to-text** using [WhisperKit](https://github.com/argmaxinc/WhisperKit) (Apple Silicon) with four model sizes downloaded on first use
- **Word-level timestamps** with automatic short-segment merging from microphone or system audio
- **Language selection** with auto-detect option
- **Caption styling:** font size, weight, position, text/background colors, opacity, words per line
- **Export as burned-in captions** or SRT/VTT sidecar files
### Export
- **MP4, MOV, or GIF** with H.264, H.265, ProRes 422, and ProRes 4444 codecs
- **Platform presets** for YouTube, Twitter/X, TikTok, Instagram, Discord, ProRes, and GIF
- **GIF export** powered by [gifski](https://gif.ski) with quality presets
- **Configurable FPS and resolution** (Original, 4K, 1080p, 720p)
- **Parallel multi-core rendering** for faster exports with progress bar and 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)
## License
MIT