# Grip guide Everything Grip does, in one file: capture, the automatic polish, the editor, looks, export, privacy, shortcuts, agents, how it works, and how to build it. The short version is the [README](../README.md). ## Capture in one keystroke Press your own shortcut, even macOS's screenshot keys, or click the menu bar icon. The screen freezes under Grip's overlay, in the mode you used last, with your last area still selected. Draw right on top of the frozen screen, then copy it, save it, or record it. Grip waits in the menu bar, so the overlay is up **8 ms** after your shortcut. That is 12 times faster than the quickest blink (about 100 ms), 2 times faster than one flap of a hummingbird's wings (about 20 ms), and a hundred times over in one resting heartbeat (about 0.8 s).

Grip's capture overlay on a frozen screen: a selected area of a web app with a red box around the Project name field, a red arrow and the label 'Name it, then create' pointing at the Create project button, a yellow pen underline under the heading, and two pixelated project names. A tool strip with arrow, rectangle, pen, text, pixelate, and six colors sits beside the area, and a bar below it offers Save ⌘S and Copy ⌘C.

One keystroke, a few marks, and ⌘C puts it on your clipboard.

- **Record it.** Press **↩︎** for a 3-2-1 countdown, then record. The countdown shows whether auto-zoom is on, and **Z** flips it. Or pick a whole display, one window, or an iPhone or iPad over USB. - **Or screenshot it.** **⌘C** copies the area at once, **⌘S** saves it to the Desktop. Picking a display or a window, **⌘C** copies that; a window comes alone, with clear corners. Screenshots keep the Display P3 colors macOS uses. - **Mark it up first.** Arrow, rectangle, pen, text, and pixelate, each on one key (**A R P T B**), in six colors. The pen draws smooth ink that thins with speed, or with pressure on a stylus. Drag any shape to move it, and undo covers every stroke. - **Size it exactly.** Drag the handles, type a size, lock 16:9, 4:3, 1:1, or 9:16, or snap a window to a preset size. ### While you record

A landing page draft on a wallpaper of green, yellow, and pink dunes: after ⌥⇧⌘D appears as keycaps, red ink circles the headline 'Get paid in days, not weeks.', an arrow sweeps down to the Start free trial button, and a line underlines the $24 price. The view zooms out to the whole page and the ink fades away.

Draw on screen with ⌥⇧⌘D while you record. The ink fades on its own.

- **Camera, mic, and system audio on one clock**, so lips stay in sync for hours. - **A camera bubble** right under your camera, so you look into the lens. It fades when you point at it, drags anywhere, and stays out of the video: you place the camera there while editing. - **Draw on screen** with **⌥⇧⌘D**. The ink fades out on screen just as it will in the video. - **Speaker notes** in a scrolling prompter only you can see. - **Grip stays out of the shot.** Its windows never show up in the recording, and desktop icons can hide too. On several displays, the controls stay on the one you're recording, wherever the mouse goes. - **Pause, resume, restart, or discard** a take, from the widget, the menu bar, or a shortcut. - **Warnings that matter.** Grip tells you when your mic goes silent or disconnects, before the take is wasted. ### Then share it before you leave the flow Every recording ends in a small result card: - **Copy** an MP4 that fits under 20 MB, ready to paste into Slack, Discord, WhatsApp, or Mail. - **GIF** under 10 MB, sized for GitHub READMEs and issues. - **Link** to a share page that works before the upload even finishes. - **Edit** to open the full editor. Drag the preview straight into another app to drop the file. **Recent Captures** in the menu bar reopens your last five screenshots and recordings. A screenshot's card has **Edit** too, to dress it up for a post. It opens the screenshot in the editor with the look new recordings start with. Pick a preset, a wallpaper, padding, corners, a shadow, and a shape: 16:9, 4:5, 1:1, or 9:16. **⌘C** copies the image and **⌘S** saves it to the Desktop, with every pixel of the screenshot. Drop any PNG on Grip to do the same. ## Polished by default

A revenue dashboard on a wallpaper that runs from deep blue to teal: a glass loupe follows the cursor along the MRR growth chart, magnifying each day's tooltip, glides up to the Net new MRR and MRR figures, then magnifies the Export CSV button as it turns to Exported.

A glass loupe magnifies one spot and keeps the rest of the dashboard in view.

- **Auto-zoom.** Clicks and typing become zooms that follow your cursor. A zoom pulls out soon after your last click, and when the cursor then goes to point at what changed, a glass loupe follows it there. Each one is a plain timeline item you can move, retime, or switch off. Pick a smooth glide or a focused move that settles fast. Rather zoom by hand? Turn auto-zoom off for new recordings in Settings. - **A glass loupe.** Magnify one spot and keep the rest of the screen in view. The lens refracts like real glass as it follows the cursor, and turns liquid when you want it to stretch. Pick its size, and every new zoom keeps the look you chose last. - **A cursor worth watching.** Redrawn from events: smoothed, passing exactly through every click, hidden when idle, with motion blur. Each click swells through the screen itself, and the loupe and zooms carry it. Or pick a lit wave, a soft circle, or a focus ring that locks onto the click, plus click sounds, a larger size, or a touch-style circle. - **Keystrokes as keycaps.** Shortcuts appear as macOS keycaps in your own keyboard layout. Password fields stay private.

A launch checklist titled Relay 2.0 launch: as a voice narrates, big word-by-word captions read 'Okay, launch day.', 'Changelog, done.', 'Demo video, done.', and 'Pricing page, done.' while each item is checked off and the progress bar fills, then 'And…' before the last item, Go live, is checked and the status turns Live.

Word-by-word captions carry the story, even without sound.

- **Captions written on your Mac.** NVIDIA Parakeet v3 transcribes 25 European languages on device, with timing for every word. Show them a line or a word at a time, fading or sliding in. - **A voice that sounds produced.** DeepFilterNet3 takes background noise down on your Mac, a de-esser softens harsh S sounds, and a slow leveler keeps quiet phrases audible. Your voice plays at -14 LUFS like online video, with a limiter so nothing clips. - **A clean frame, your call.** New recordings show the screen edge to edge. Pick a wallpaper and Grip adds the padding to show it, and one undo takes both back. Rounded corners and a soft shadow are a slider away. ## Edit a video like a doc

The Grip editor: the preview shows a glass loupe over a Create project button with a caption below, the transcript panel shows three filler words struck through, and the timeline shows a zoom and a loupe above clips split where the fillers were cut.

- **Edit by transcript.** Select words and press Delete, and the video follows. Grip finds filler words and long pauses: remove the fillers or shorten the pauses in one click. Double-click a word to fix its caption. - **A keyboard-first timeline.** `C` cuts, `X` ripple-deletes, `Z` adds a zoom, and `⌘K` reaches every action. Copy, paste, duplicate, merge clips, reset a trim, or bring back anything you cut. Zooms, camera layouts, and masks sit in lanes above the video, and a lane shows up once it has something in it. - **Crop** the recording down to the part that matters, and zooms aim inside the crop. - **Speed without chipmunks.** Any clip from 0.25× to 8×, with pitch-preserving time-stretch. - **Redo a line with a voiceover.** Press `V` and talk over the video from the playhead, and the recording's own voice steps aside under it. The new voice gets the same cleanup, and the captions show what you said. - **Per-clip sound and cursor.** Set the mic and system audio from muted to 200% each, hide the cursor, or turn off its smoothing for one clip. A background music track sits under the mix. - **Camera layouts.** Picture-in-picture, fullscreen, split screen, or hidden, animated as they change. - **Masks.** Blur or pixelate anything sensitive, or highlight what matters. Masks stay locked to the content through zooms. - **Safe by default.** Your raw recording never changes. Edits are autosaved as you go, and undo covers every one. ## Make it yours

A calendar app inside a MacBook frame on a wallpaper of pale, warm dunes: the view pushes in as the user drags out a new event, types 'Design review', adds Maya Chen as a guest, picks a sage color, and saves, then pulls back to the whole laptop with the new event in the week.

A MacBook frame and a wallpaper, added after the recording.

A grid of 28 Grip wallpapers: bright spring dunes, warm sunset dunes, pink and violet folds, hot colors on navy, pearl folds, gray silk on black, and neon glows, streaks, and rings.

- **165 wallpapers** in 7 collections: Spring, Sunset, Radiant, Energy, Iridescent, Midnight, and Neon. Each one is drawn live on the GPU, so it stays sharp at any size and in any format. Or use your macOS wallpapers, a gradient, a color, or any image, with optional blur. - **Device frames** for MacBook, iPhone, and iPad. - **Every format:** 16:9, 9:16, 4:5, 1:1, or custom. Narrow formats follow the cursor. - **Camera styles:** circle, rounded, or square, mirrored or not, with background removal, face tracking, and hide when silent. Grade it with a built-in look or your own `.cube` LUT. - **Presets** save a whole look as a portable `.grippreset` file, images included. ## Export and share

One chat recording exported three ways and played side by side: 16:9 for YouTube, 1:1 for LinkedIn, and 9:16 for Reels. In each, the view follows the cursor as the user opens a thread, replies 'Safari + iOS look good. Ship it 🚀', sends it with ⌘↩︎, and reacts with 🎉.

One recording, three formats. Narrow formats follow the cursor, so nothing important falls out of frame.

- **MP4** in H.264 or HEVC, from 720p to 4K at 30 or 60 fps, hardware encoded. Set a size limit and Grip fits the file under it. - **GIF** with per-scene palettes, so colors don't flicker, plus a loop count and a size target. - **To a file, the clipboard, or a link.** Exports queue up in the background while you keep editing, and batch export renders many projects in one go. - **Subtitles** as SRT or VTT, aligned through every cut and speed change. - **Share links** with timestamped comments, private links, and view counts. Uploads resume after a lost connection or a restart. Share the whole editable project too: the other side opens it in Grip with one link. ## Private by design Recording, editing, transcription, and background removal all run on your Mac. Recording and editing need no account; sharing a link signs in to bestboy.dev once. Grip shares usage stats, like a finished recording or an export, and never what you record. When you're signed in they carry your account; signed out they carry a random ID made for this install, never linked to you or your account. They also count the days you use Grip and the setup steps you reach, each step once. Onboarding says so, and you can turn them off in Settings, which sends one last stat with no ID and deletes the install's ID. With `DO_NOT_TRACK=1` set, Grip sends none. Crash reports stay on your disk. Grip goes online only to download the speech model once (about 670 MB), to check for updates, to upload when you share, and to send those stats. Grip lives in the menu bar, and opened at login it starts there quietly. Updates download in the background and install themselves while you're away, never during a recording or an export. ## Shortcuts | Anywhere | | | --- | --- | | **Your shortcut** | Capture: open the picker, or finish the recording (set it in onboarding or Settings) | | **⌥⇧⌘P** | Pause or resume | | **⌥⇧⌘D** | Draw on screen while recording | | **⌥⇧⌘⌫** | Discard the recording | | **⌥⌘.** | Start or stop the speaker notes prompter | | In the picker | | | --- | --- | | **↩︎** | Record the area | | **Z** | During the countdown: turn auto-zoom on or off | | **⌘C** / **⌘S** | Copy the screenshot / save it to the Desktop | | **A R P T B** | Arrow, rectangle, pen, text, pixelate | | **Esc** | Close the picker | | In the editor | | | --- | --- | | **Space** | Play or pause | | **C** or **⌘B** | Cut at the playhead | | **S** or hold **⌥** | Split tool | | **X** | Ripple delete | | **Z** / **1**-**9**, **0** / **E** | Add a zoom / set its level from 1.5× to 6× / switch it on or off | | **L** / **M** | Add a camera layout / mute a clip | | **← →** / **↑ ↓** | Step 0.5 s (1 s with **⇧**) / jump between cuts | | **⌘C** / **⌘V** / **⌘D** | Copy / paste at the playhead / duplicate | | **⌘=** / **⌘-** / **⌘0** | Zoom the timeline in / out / to fit | | **⌘E** | Export | | **⌘C** / **⌘S** | A screenshot: copy the image / save it to the Desktop | | **⌘K** | Command menu: every action, searchable | Automate Grip from Raycast, Shortcuts, or a script with `grip://` links: ```sh open "grip://record?mode=area" # also display, window, device; no mode opens the last one open "grip://stop" open "grip://open?path=/Users/me/Movies/Demo.grip" open "grip://open?url=https://bestboy.dev/v/x7Kq2mP9aB3c" # a shared project ``` ## Agents Grip is an MCP server: agent apps can list, cut, speed up, zoom, caption, export, and share your projects with its tools. Edits to a project open in the editor land there as you watch, as one step you can undo. An agent also reads the comments teammates leave on a share link, each at its moment and spot of the video, with the frame there. It fixes what they asked, then replies on each thread and resolves it. No tool deletes anything, exports never replace a file, and an agent that needs Grip starts it in the menu bar. Add Grip to Claude Code: ```sh claude mcp add --scope user grip -- /Applications/Grip.app/Contents/Resources/grip-mcp ``` For Claude Desktop, add it to `~/Library/Application Support/Claude/claude_desktop_config.json`; other agent apps take the same JSON: ```json { "mcpServers": { "grip": { "command": "/Applications/Grip.app/Contents/Resources/grip-mcp" } } } ``` Settings shows both under Agents, with Copy buttons. An agent that changed a web app can film the change with no one at the keyboard. `record_demo` opens the page where nobody sees it and clicks, hovers, types, presses keys, scrolls, and waits, with a pointer that moves like a hand. The result is a regular Grip project with auto zoom, a smooth cursor, and click effects, plus an MP4, a GIF, one frame per step, and a share link when asked. A step's `say` labels it and becomes a chapter of the link. Given the link of an earlier demo, the new video becomes its next version, so the pull request or chat that has the link shows the fix with no new post. It needs no Screen Recording permission, and a step that fails says which and why and keeps nothing. Every tool also runs from a shell, for scripts and agents without MCP: ```sh grip=/Applications/Grip.app/Contents/Resources/grip $grip # list the tools $grip list_projects $grip record_demo '{"url": "http://localhost:5173", "steps": [ {"type": "Ship it", "into": "#task", "say": "Add a task"}, {"click": "text=Add task"}, {"wait": "text=\"Ship it\""}]}' ``` It prints the answer and its data as JSON, saves images to a temporary folder and prints their paths, and exits non-zero when the call fails. ## Under the hood Grip is built on three rules, so the bugs typical of screen recorders cannot happen by design. - **Raw sources, separate tracks.** Screen without the cursor, camera, mic, system audio, and the input event stream. The cursor is redrawn from events, which is what makes smoothing, hiding, and click effects possible. - **One time map.** Every zoom, caption word, and keystroke lives in source time and maps to the output through one shared map of cuts and speed changes. Captions and audio stay in sync after hundreds of cuts. - **Pure render.** The frame at time *t* is a function of the project and *t*. Preview and export share one WebGPU renderer and one audio graph, so the export matches the preview frame for frame. The stack: Electron and Svelte 5 for the app, a Rust addon (napi-rs, objc2) for ScreenCaptureKit, AVFoundation, CoreGraphics event taps, and Vision, a WebGPU compositor, WebCodecs with VideoToolbox for decoding and encoding, and [mediabunny](https://github.com/Vanilagy/mediabunny) for muxing. ## Build from source You need macOS 15 or later on Apple silicon, Node 24, Rust, and the Xcode command line tools. ```sh git clone https://github.com/bestboyhq/grip && cd grip npm ci npm run build:native # the Rust addon npm run dev # the app, with hot reload ``` No time to record? Generate a 24-second demo project (needs `ffmpeg`) and open it: ```sh npx electron scripts/fixture/make.ts npm run dev -- --open ".context/fixtures/Demo #1 ✨ café.grip" ``` Run the checks with `npm test`, `npm run check`, and `cd native && cargo test`.