Snapzy

Snapzy is a native macOS menu-bar app for screenshots, screen recording, annotation, and editing. Requires macOS 13.0 or later.

Install

brew install --cask snapzy

Or install a specific version:

curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/v2.1.0/install.sh | bash

You can also download a release. Move Snapzy.app to /Applications, launch it, and grant Screen Recording permission when prompted. Relaunch if macOS asks. Microphone and Camera permissions are needed only for those recording inputs. Snapzy is signed and notarized by Apple.

Uninstall

curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/master/uninstall.sh | bash

During uninstall, the script asks whether to delete the Application Support folder, which can contain temporary captures and recordings. Answer n to keep that folder. To reset permissions without uninstalling, use:

curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/master/reset-permissions.sh | bash

Quick Start

1. Press ⇧⌘4 to capture an area or ⇧⌘3 for a fullscreen screenshot.
2. Use the Quick Access card to copy, annotate, edit, drag, or upload the result.
3. Open History to find and reuse recent screenshots, videos, and GIFs.

What Snapzy can do

• Capture
  • Capture the full screen, a selected area, an app window, or a Smart Element. Capture already-open third-party menu-bar popovers; stitch scrolling content into one image with a live preview.
  • Extract text with built-in Apple Vision OCR or a configured OpenAI-compatible endpoint. Pick a pixel with the live loupe and copy it as HEX, RGB, HSL, HSB, CMYK, OKLCH, or SwiftUI; cut out a subject with optional safe auto-crop.
  • Measure gaps and sizes on screen with the Screen Ruler: hover between edges, drag a box that snaps to content, pin measurements, copy them, or save a screenshot with them drawn on.
• Record
  • Record the screen or an app as video with optional system audio and microphone input, or save a recording as a GIF.
  • Add a camera overlay, including iPhone Continuity Camera, mouse-click and keystroke highlights, or live annotations.
• Annotate and edit
  • Add arrows, shapes, text, watermarks, blur, and pixelation. Detect and redact sensitive data on-device.
  • Measure distances and sizes in the image with the Measure tool (U): editable measurements that export with it.
  • Crop images, remove backgrounds, and create 3D mockups. Trim clips, add zoom or speed segments, and use Follow Mouse to keep the cursor in view.
• Quick Access and History
  • Copy, edit, drag, or upload captures from their floating Quick Access cards; pin screenshots on screen.
  • Search screenshots, videos, and GIFs by filename, type, or time, then reopen them in the editors.
• Cloud Upload
  • Manually upload from Quick Access, Annotate, Video Editor, or History to AWS S3, Cloudflare R2, or Google Drive.
  • Uploads go directly to the selected provider. Snapzy does not auto-upload after capture or relay files through its own servers.
• App localization: Native macOS per-app language support in 10 languages: English, Vietnamese, Simplified Chinese, Traditional Chinese, Spanish, Japanese, Korean, Russian, French, and German.

Shortcuts

Action	Shortcut
Fullscreen screenshot	⇧⌘3
Area screenshot	⇧⌘4
↳ Toggle manual/app window mode (Application Capture)	A
Repeat last area screenshot	⌃⌘⇧4
Area screenshot + inline annotate	⇧⌘7
Active window capture	⇧⌘9
Scrolling screenshot	⇧⌘6
Screen recording (start/stop toggle)	⇧⌘5
Pause/Resume recording (optional, recommended ⌘⇧Space)	unset
OCR text capture	⇧⌘2
Object cutout capture	⇧⌘1
Smart element capture	⌥⇧4
Measure screen (screen ruler)	⌥⇧M
Open Annotate	⇧⌘A
Open Video Editor	⇧⌘E
Open Cloud Uploads	⇧⌘L
Show shortcuts list	⇧⌘K
History panel toggle	⇧⌘H

Quick Access card actions

Hover a Quick Access card, then press the key. Active only while the pointer is over a card.

Action	Shortcut
Copy	⌘C
Save / Open	⌘S
Edit	⌘E
Upload to cloud	⌘U
Pin screenshot to screen	⌘P
Delete	⌘⌫
Close	⌘W

Command line tools

The snapzy helper is at /Applications/Snapzy.app/Contents/Helpers/snapzy. Add it to your PATH from Settings → Command Line → Install.

Access is approved per calling app. All commands other than snapzy status require an approved caller app; after approval, that app can use later commands without repeated prompts.

snapzy list windows --app Safari
snapzy capture window --app Safari --max-dimension 1568 -o shot.png
snapzy capture area --rect 0,0,800,600 -o area.png
snapzy measure window --app Safari --at 24,180 --box 0,0,800,60

See the CLI reference.

Automation

Snapzy registers the snapzy:// URL scheme so launchers and automation tools (such as the Raycast Extension, Alfred, or custom scripts) can trigger capture actions. This integration can be toggled on or off under Settings → Advanced → URL Scheme integration.

Action	URL
Fullscreen screenshot	snapzy://capture/fullscreen
Area screenshot	snapzy://capture/area
Repeat area screenshot	snapzy://capture/repeat-area
Delayed area screenshot	snapzy://capture/delayed
Application window	snapzy://capture/application
Active window	snapzy://capture/active-window
Area annotate	snapzy://capture/area-annotate
Scrolling screenshot	snapzy://capture/scrolling
OCR text capture	snapzy://capture/ocr
Smart element capture	snapzy://capture/smart-element
Object cutout capture	snapzy://capture/object-cutout
Screen recording	snapzy://record/screen
Application recording	snapzy://record/application
Open Annotate	snapzy://open/annotate
Combine images	snapzy://open/combine
Open Video Editor	snapzy://open/video-editor
Open Cloud Uploads	snapzy://open/cloud-uploads
Open Capture History	snapzy://open/history
Pick color	snapzy://tools/pick-color
Measure screen	snapzy://tools/measure
Show shortcuts list	snapzy://show/shortcuts
Open Settings	snapzy://settings
Open Settings tab	snapzy://settings?tab=annotate

snapzy://open/combine opens the image picker. Automation tools can skip the picker by passing two or more URL-encoded local paths as repeated file parameters:

open 'snapzy://open/combine?file=/tmp/first.png&file=/tmp/second.png'

See Shortcuts and URL scheme for details.

Security and privacy

Snapzy is not sandboxed and runs with the privileges of the user account that launched it. It uses the macOS Hardened Runtime, Developer ID signing, and Apple notarization; library validation stays enabled so only code signed by Snapzy or Apple can load. Captures and recordings are stored locally, and users initiate uploads to their own AWS S3, Cloudflare R2, or Google Drive storage. Built-in OCR uses Apple Vision on-device; if a custom OpenAI-compatible OCR endpoint is configured, OCR requests include the captured image and are sent to that endpoint. Snapzy collects no telemetry.

Cloud credentials, OAuth tokens, and custom OCR API keys are stored exclusively in the macOS Keychain. The optional cloud-credential protection password is SHA-256 hashed and never stored in plaintext. Cloud credentials can be transferred only through a manual, passphrase-encrypted export/import, and custom OCR API keys are excluded from configuration and credential exports. The portable TOML configuration contains preferences only; it excludes secrets, capture and upload history, caches, CLI approvals, and security-scoped bookmarks. See SECURITY.md for network-request details and the full security policy, and the configuration guide for portable settings.

To report a vulnerability, use a GitHub Security Advisory or contact the maintainer privately. See SECURITY.md for reporting details.

More details

• Capture and OCR · Scrolling capture · Recording
• Annotate · Video Editor · Quick Access · History
• Cloud Upload · Shortcuts and URL scheme · CLI
• Configuration and preferences · Preferences reference · Updates and diagnostics
• Development · Build and packaging · Docs map
• OCR benchmark results and methodology

Contributing

Contributions are welcome. Read CONTRIBUTING.md before opening a pull request.

Contributors

Thanks to all the people who contribute to Snapzy!

Featured On

Star History

Acknowledgments

Snapzy is inspired by CleanShot X, an advanced screenshot and screen recording application for macOS.

License

BSD 3-Clause License. See LICENSE.