Setup

Installation

Multiple ways to get Snapzy on your Mac. Pick the one that fits your workflow.

System Requirements

macOS 13 Ventura or later
Apple Silicon or Intel Mac
~120 MB free disk space
Internet connection only required for cloud uploads (optional)

Download DMG

Grab the latest .dmg from the download page.
Open the DMG and drag Snapzy into your Applications folder.
Launch Snapzy from Applications or Spotlight.

First launch — macOS may show a security warning because Snapzy is distributed outside the Mac App Store and is not notarized by Apple yet. Go to System Settings → Privacy & Security and click Open Anyway. Alternatively, run sudo xattr -rd com.apple.quarantine /Applications/Snapzy.app after dragging the app to Applications.

Homebrew

If you use Homebrew, add the Snapzy tap and install:

brew tap duongductrong/snapzy https://github.com/duongductrong/Snapzy
brew install --cask snapzy

Upgrades are handled automatically when you run brew upgrade.

Shell Script

Install a specific version via curl:

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

Build from Source

Snapzy is open source. You can build it locally with Xcode:

Clone the repository: git clone https://github.com/duongductrong/Snapzy.git
Open Snapzy.xcodeproj in Xcode 15 or later.
Select the Snapzy target and your Mac as the destination.
Press ⌘R to build and run.

Tip — Building from source is great if you want to customize shortcuts or contribute. No Apple Developer account is required to run locally.

First Run Permissions

On first launch, Snapzy will request the following macOS permissions:

Screen Recording — required to capture screenshots and recordings.
Microphone — optional, only if you want voice audio in screen recordings.
Accessibility — optional, used for global keyboard shortcuts and window detection.

See Permissions & Privacy for details on how to grant or revoke these.

Uninstall

To completely remove Snapzy, reset permissions, and clean up app data:

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

This removes the app from /Applications, deletes preferences and caches, and resets TCC permissions (Screen Recording, Microphone, Accessibility). You may need to log out or reboot for permission changes to fully take effect.